https://github.com/gollum/gollum кто-нибудь ставил себе?

Да, на Гитлабе wiki на Gollum работает

Интересно.

Спасибо

Я сейчас смотрю на вариант один проект в bitbucket, в котором созданы репозитории по продуктам. Документация сгруппирована по продуктам. Поиск в проекте BB найдет документы во всех репозиториях проекта.

соотв. вся дальнейшая декомпозиция на основе определения границ продуктов

я примерно также делаю, у нас только продукт один, но много модулей. Делаю папку docs (репозиторий для всех доков), в ней папка, например, project _name_1 , с нашим главным проектом, дальше проекты можно будет добавлять как 1,2,3 и т.д. это на случай расширения наших продуктов, и уже  в папке project _name_1, разбивка на модули, mod1, mod2 и т.д. По редми от разработчиков, решил его не подтягивать, будет бардак.

Всем привет!
Вопрос для пользователей Sphinx.

Подскажите, пожалуйста, как включить контент файла index.rst в собираемый DOCX?

Если добавить index в директиву toctree, то появляется ошибка:

WARNING: circular toctree references detected, ignoring: index <- index

Как вы думаете, что означает текст ошибки?

Ссылка ссылается на саму себя)

Интересно, что файл при этом формируется

Тоже вопрос по сфинкс, если несколько проектов с различной документацией, то как настраиваете  хранение файлов с документацией? По умолчанию файлы с докой лежат в корне. Как решение вижу папку source и в ней project1, project2 и т.д. но будет ли проходить сборка?

Ну либо тегами при коммите отмечать, а потом при запуске пайплайна определять по нему что собирать

Но честно, я не понимаю зачем все в одном проекте держать

Есть ли у проектов общие (переиспользуемые) части?

Пока не знаю, так как это больше к масштабируемости решения относится, но скорее всего будут.

а как можно сделать?

у нас каждая дока живёт в своей репе, где требуется реиспользование в другом проекте, подключается как субмодуль гита

интересно, спасибо

у нас также. самый оптимальный вариант

Вы имеете ввиду, что документация лежит в репозитории с кодом модуля программы?

Документация лежит в своем отдельном репозитории. Код в своем. Умеем подтягивать дескрипшн из кода в доки внутри гита