Какие есть сервисы для документации при разработке программ?

Question

[RaptorVRN]

Добрый день.
Небольшой командой пишем сервисы, замучились вести документацию в доках.
Подскажите адекватный сервис для ведения документации по проектам, чтобы можно было ручками править.
На выходе хочется получить что-то похожее:
https://vk.com/dev/methods
https://docs.python.org/3/c-api/exceptions.html#
www.php.su/functions/?abs

На сегодня склоняемся к банальной вики на RedMine

Answer 1

[GTRxShock]

swagger.io + https://github.com/Rebilly/ReDoc

Comments

[Павел]

Плюсую.
Но придется изучить документацию + https://github.com/Rebilly/ReDoc для оформления менее вырвиглазного )))

Answer 2

[Lumore]

GitBook

Answer 3

[entermix]

https://apidocjs.com/
https://readthedocs.org/
https://getgrav.org/
https://www.gitbook.com/
https://daux.io/
https://wiki.js.org/

Answer 4

[Эдуард Тибет]

Для начала дайте ответы на вопросы:
1. Вам надо облачный сервис или его необходимо развернуть on premises?
2. Вам нужен бесплатный сервис?
3. Вам нужно документировать _только_ API или еще надо делать разные диаграммы, писать связный текст т.п.
4. Вам надо генерить документацию из кода автоматом?

По вашему тексту вопроса я вижу, что вы пока не можете сформулировать требования к системе. А это один из явных признаков очень сильно ошибиться при выборе системы. И, кстати, обратите внимание, что все участники треда выше предложили варианты, даже не спросив что конкретно вам нужно!

Answer 5

[lukoie]

wikidpad

Answer 6

[Philipp]

raml.org

Answer 7

[motomac]

https://apiary.io/