По первому пункту — команда Gramax уже ответила: локальный GitBook CLI лишён визуального редактора, комментариев и целого ряда функций, которые есть в Gramax. По коммитам — там же объяснено: разработка велась в локальном GitLab, на GitHub выкладывается по одному коммиту на релиз. Это не показатель зрелости кода.
По второму пункту — понимаю, что формулировка может звучать настораживающе. Поработаем над этим)
Git-нативность — все изменения идут через pull request'ы, ревью, полная история версий "из коробки" без плагинов
Визуальный WYSIWYG-редактор — при этом всё хранится в чистом Markdown. DokuWiki использует собственный синтаксис, markdown там через плагин и не всегда ведёт себя предсказуемо
AI-поиск — можно подключить любую модель
В нашем проекте разграничение прав устроено следующим образом:
Так как у нас код проекта расположен на нашем сервере (мы используем GitLab Self-Hosted), чтобы его не нагружать нашей документацией и использовать бесплатную доску задач, я создала организацию на GitHub, там создала репозитории только для документации. В репозиториях дала доступ отдельным лицам — и всё)
Так выглядит это всё в Gramax:
При работе разработчики просто клонируют репозиторий с кодом и документацией (к которой имеют доступ) в одну папку:
Здравствуйте, не совсем поняла ваш вопрос. Думаю вам поможет это:
- Опубликовать в облако Gramax: https://gram.ax/resources/docs/doc-portal/cloud-gramax
- Развернуть как статический сайт: https://gram.ax/resources/docs/doc-portal/static-site-generator
По первому пункту — команда Gramax уже ответила: локальный GitBook CLI лишён визуального редактора, комментариев и целого ряда функций, которые есть в Gramax. По коммитам — там же объяснено: разработка велась в локальном GitLab, на GitHub выкладывается по одному коммиту на релиз. Это не показатель зрелости кода.
По второму пункту — понимаю, что формулировка может звучать настораживающе. Поработаем над этим)
Круто! Не знала о нём — почему ваш выбор пал именно на него?
Спасибо за вопрос! Ключевые отличия от DokuWiki:
Git-нативность — все изменения идут через pull request'ы, ревью, полная история версий "из коробки" без плагинов
Визуальный WYSIWYG-редактор — при этом всё хранится в чистом Markdown. DokuWiki использует собственный синтаксис, markdown там через плагин и не всегда ведёт себя предсказуемо
AI-поиск — можно подключить любую модель
В нашем проекте разграничение прав устроено следующим образом:
Так как у нас код проекта расположен на нашем сервере (мы используем GitLab Self-Hosted), чтобы его не нагружать нашей документацией и использовать бесплатную доску задач, я создала организацию на GitHub, там создала репозитории только для документации. В репозиториях дала доступ отдельным лицам — и всё)
Так выглядит это всё в Gramax:
При работе разработчики просто клонируют репозиторий с кодом и документацией (к которой имеют доступ) в одну папку: