Кейс CRM-платформы «Модус»: переход из Confluence в Docs as Code
Раньше продукт и документация поставлялись отдельно: материалы жили в Confluence, затем их выгружали, собирали в Word, сверяли актуальность и отправляли заказчикам. При нескольких версиях платформы это создавало проблему: нужно было понимать не только последнюю редакцию страницы, а правильный срез под конкретный релиз.
Новая схема строится вокруг GitLab, Markdown, веток, merge request, ревью и релизных веток. Gramax выбран как визуальный вход для аналитиков: они могут работать со структурой, таблицами и изображениями без ощущения, что пишут код, а разработчики и архитекторы при этом могут использовать привычные инструменты вроде VS Code.
Пилот начали с платформенной части «Модуса», подготовили инструкции первого входа и отдельно описали слияния и ревью. Сейчас пользовательская документация собирается в портал и поставляется вместе с продуктом; сборка комплекта по платформе уже сократилась примерно вдвое с прежних 40 часов, а после переноса всех модулей команда ожидает около 4 часов на весь процесс.
Коротко
- «Модус» переводит руководства пользователя и администратора из Confluence в Docs as Code, чтобы привязать документацию к релизам.
- Документация хранится в GitLab, пишется в Markdown, проходит merge request, ревью и живёт в релизных ветках.
- Gramax используется как удобный визуальный редактор для аналитиков, при этом Markdown можно открывать и в Obsidian или VS Code.
- Сборка комплекта документации раньше занимала около 40 часов; по платформе время уже сократилось примерно вдвое.
- Полной автоматической миграции из Confluence нет: команды вручную чистят структуру, обновляют скриншоты и отделяют внутренние материалы.
FAQ
Зачем команде «Модуса» понадобился переход из Confluence в Docs as Code, если документация уже существовала?
При нескольких активных версиях продукта Confluence не давал удобного среза документации под конкретный релиз. Команде нужно было поставлять актуальные инструкции вместе с продуктом.
Какую роль в переходе играет Gramax и почему команда не ограничилась обычными Git- и Markdown-инструментами?
Gramax снизил порог входа для аналитиков: они могут работать со страницами, таблицами и изображениями в визуальном интерфейсе. При этом файлы остаются в Markdown и не привязаны только к одному редактору.
Какие ограничения остались после перехода на новый процесс документации?
Часть ручной работы сохраняется из-за клиентов, которым нужен DOCX, а бизнес-модули переходят на новый подход постепенно. Миграция из Confluence также требует ручной чистки и пересмотра материалов.
Читайте также
Как собрать System Context Pack за час- Как перенести расчёт абсолютных валютных курсов на Kaggle и автоматизировать обзоры через Gemini API
ИИ-агенты для бизнеса в России: обзор 10 локальных платформ и решений- Rich Messages в Telegram-ботах: сложные сообщения, черновики и ограничения
- Превращаем любой текст в модель знаний — и почему это удобно
- Документация должна версионироваться вместе с продуктом: Если у продукта одновременно используются разные релизы у разных клиентов, обычная база знаний быстро перестает отвечать на вопрос, как система работала в конкретной версии. Для таких продуктов документацию нужно привязывать к релизным веткам, чтобы можно было восстановить правильный срез под клиента, поддержку или поставку.
[Документация и знания]
Зарегистрированные пользователи видят только два тезиса.
Зарегистрироваться
CRM-платформа «Модус» ИТ-холдинга Т1 переводит пользовательскую и администраторскую документацию из Confluence в Docs as Code. Цель — связать инструкции с релизами, сократить ручную сборку комплектов и дать аналитикам удобный Markdown-процесс через Gramax.