Пишет об этом Product Manager команды: Котельникова Екатерина Андреевна.
Сегодня расскажу об одном из тех моментов, которые случаются у каждой команды: ты что-то настраиваешь, радуешься, нажимаешь одну кнопку — и всё летит.
Как это было
Решила перенести документацию Delёz и командные файлы на GitBook. Перенесла, опубликовала, залюбовалась красотой — и решила привязать GitHub-репозиторий, чтобы было совсем хорошо. Привязала. И нас заблокировали везде. Без предупреждения, без объяснений — просто всё стало недоступно. Видимо, GitBook не очень дружит с аккаунтами из определённых регионов, когда дело доходит до синхронизации с GitHub ?
Хорошо, что я тут же нашла альтернативу. Это Gramax!
Что такое Gramax
Gramax — это open-source приложение и платформа для документации, которая хранит всё в Git в формате Markdown. Ключевая идея: docs-as-code. Ваши файлы живут у вас — на компьютере или в вашей инфраструктуре, а не в чьём-то облаке под чьими-то правилами.
Для стартапа, который работает с чувствительными данными пользователей (а Delёz — это AI-дневник, и конфиденциальность для нас не опция, а ценность), это принципиально важно.
Почему мы остановились именно на нём
Git-интеграция из коробки. Gramax нативно работает с Git — изменения проходят согласование прямо в приложении через pull request’ы и автоматически публикуются на сайт. Для командной работы это удобнее, чем кажется.
ИИ-поиск и Copilot. Можно подключить собственный AI — в том числе локальную модель. Поиск по базе знаний даёт не просто ссылки, а конкретные ответы со ссылками на источники.
Визуальный редактор без шума. Всё сохраняется в Markdown, но работаешь в чистом визуальном редакторе. Mermaid, PlantUML, Draw.io, OpenAPI-спецификации — всё поддерживается.
Публичный портал документации. Можно развернуть красивый сайт с документацией для пользователей — бесплатно, в своей инфраструктуре.
И самое приятное — это полностью бесплатно. Не freemium, не «бесплатно до 5 пользователей» — а бесплатно навсегда, без скрытых платежей и внезапных апгрейдов.
Про поддержку
Отдельно хочу отметить: поддержка у Gramax реально живая и быстрая. Если не ответят — есть открытый чат разработчиков в Telegram. Для open-source проекта это редкость и большой плюс.
Базовая работа
В данном гайде будет показана работа с git репозиторием.
-
Переходим на https://app.gram.ax/ и выбираем «Загрузить существующий каталог»:
-
Я выберу GitHub:
-
Если у нас есть организация, то мы можем выбрать репозиторий из неё или можем выбрать репозиторий из личного аккаунта:
-
Если всё успешно, то мы видим наш созданный каталог:
-
Создаем папку для хранения документации:
-
Указываем её в настройках каталога:
-
Добавляем нашу статью:
-
Для публикации (git push) жмём на облачко, для принятия изменений жмём на стрелочки (git pull):
- Так мы можем всё отменить:
-
Супер, всё успешно!
Мы также можем перейти в редактор кода, сделать git pull и увидеть нашу статью)) Это работает и в обратную сторону (написать статью в редакторе, опубликовать и увидеть её в Gramax) для просмотра Markdown-файлов в редакторе рекомендую это расширение:
Итог
Потеряла GitBook — нашла инструмент, который подходит нам лучше. Бесплатно навсегда, открытый исходный код, данные под вашим контролем, нативный git. Теперь вся документация Delёz живёт здесь.
Было полезно? Пишите в комментариях — буду рада обратной связи.
А чтобы записаться на бета-тестирование нашего продукта, переходите на: https://delez.tech/
Комментарии (14)
3ton
04.04.2026 12:20Интересно знать его принципиальные отличия от давно существующего и так же бесплатного DokuWiki, на котором мы так же юзаем markdown.
А так же интересуют возможности движка в плане разграничения прав и доступа к различным частям документации.
Delez_ai Автор
04.04.2026 12:20Спасибо за вопрос! Ключевые отличия от DokuWiki:
Git-нативность — все изменения идут через pull request'ы, ревью, полная история версий "из коробки" без плагинов
Визуальный WYSIWYG-редактор — при этом всё хранится в чистом Markdown. DokuWiki использует собственный синтаксис, markdown там через плагин и не всегда ведёт себя предсказуемо
AI-поиск — можно подключить любую модель
В нашем проекте разграничение прав устроено следующим образом:
Так как у нас код проекта расположен на нашем сервере (мы используем GitLab Self-Hosted), чтобы его не нагружать нашей документацией и использовать бесплатную доску задач, я создала организацию на GitHub, там создала репозитории только для документации. В репозиториях дала доступ отдельным лицам — и всё)
Так выглядит это всё в Gramax:
При работе разработчики просто клонируют репозиторий с кодом и документацией (к которой имеют доступ) в одну папку:
KondakovVE
04.04.2026 12:20мы используем для своей внутренней базы знаний. Перешли с confluence.
прекрасный продукт
Flux82
1) Что мешало использовать не онлайн-сервис GitBook, а его же, но запустив локально? Это же просто генератор статичного сайта (https://github.com/GitbookIO/gitbook). Gramax: 30 коммитов, 20 форков. GitBook: 2000 коммитов, 4k форков. Это не говорит плохо о Gramax, просто факт. Но Gramax отечественный, да.
2) Лозунг вашего сервиса "Это не просто дневник. Это пожизненный ИИ-ассистент" наводит на самые худшие мысли.
Flux82
Интересно было бы знать, с чем именно не согласился минуснувший.
UniInter
У Gramax симпатичный CPO. У GitBook такого нет.
skargik
В локальном GitBook не будет визуального редактора, комментариев и множества других функций, которые есть как в облачном GitBook, так и в Gramax.
В репозитории 30 коммитов, т.к. мы пока не переехали из локального GitLab в GitHub. Каждый месяц публикуем новый релиз в GitHub одним коммитом.
rebug
А зачем вы так делаете? Похоже на неправильное использование гита или я чего-то не понял. Ведь, можно просто одно репо мержить в другое и получать идентичные ветки
skargik
Сначала было ограничение, что Enterprise версия была в одном репозитории с Open Source версией. От этого ушли. Потом было ещё какое-то ограничение, точно не помню какое. Да и просто много других задач, до этой не добираемся.
Но думаю, что в скором времени полностью переедем, чтобы закрыть вопрос. Вся разработка будет в GitHub с пулл реквестами, комментариями и настоящим docs as code.
temradov
Здравствуйте. По 1 пункту расскажите пожалуйста, подробнее что вы имеете ввиду? Как осуществить публикацию документации созданной через гитбук на свой статичный сайт?
Delez_ai Автор
Здравствуйте, не совсем поняла ваш вопрос. Думаю вам поможет это:
- Опубликовать в облако Gramax: https://gram.ax/resources/docs/doc-portal/cloud-gramax
- Развернуть как статический сайт: https://gram.ax/resources/docs/doc-portal/static-site-generator
Delez_ai Автор
По первому пункту — команда Gramax уже ответила: локальный GitBook CLI лишён визуального редактора, комментариев и целого ряда функций, которые есть в Gramax. По коммитам — там же объяснено: разработка велась в локальном GitLab, на GitHub выкладывается по одному коммиту на релиз. Это не показатель зрелости кода.
По второму пункту — понимаю, что формулировка может звучать настораживающе. Поработаем над этим)