Где вести вики по проекту?

Посоветуйте удобный сервис для ведения документации по крупному проекту, необходима простота и легкая навигация. Так же важно туда добавлять не только код, но и схемы, изображения, текст
  • Вопрос задан
  • 950 просмотров
Пригласить эксперта
Ответы на вопрос 5
GavriKos
@GavriKos
Можно завести confluence или аналоги - обычно что то простое есть с таск-трекером.
Можно в целом md-файлами прямо в проекте, особенно если пользуетесь гитхабом - он их автоматом подтянет.
Ответ написан
Комментировать
Самые удобные и топовые вики ВСЕГДА идут там же, где размещен репозиторий. То есть, гитхаб \ гитлаб вики. Лично я всегда ожидаю увидеть вики по проекту там же, где и репо, и сильно расстраиваюсь, если ничего там не нахожу. Всякие левые сервисы проигрывают по причине заведомой неявности.
Ответ написан
Комментировать
xmoonlight
@xmoonlight
https://sitecoder.blogspot.com
dokuwiki Есть всё, что нужно! (включая html-разметку и загрузку своих страниц в iframe / popup window)
Ответ написан
Комментировать
@iddqda
network engineer, netdevops
сейчас модно доку вести в sphinx
писать можно в их собственной разметке reStructuredText либо в markDown
можно добивать плагинами
например с плагином nbsphinx оно кушает .ipynb (jupiter-notebooks)

sphinx можно использовать и как self-hosted, а можно, совершенно нахаляву, все то же самое делать в облаке readthedocs.io
Ответ написан
Комментировать
eduardtibet
@eduardtibet
Technical Writer / Documentation Engineer
Сначала вам сюда: Как и где хранить техническую документацию?

Потом появятся уточняющий вопросы.
Ответ написан
Комментировать
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы