Задать вопрос

Как выбрать автоматический генератор документации?

Хочу попробовать использовать генератор документации типа Sphinx (sphinx-doc.org) в большом новом проекте. Проект будет на Flask+Angular, с открытым API. Документацию хочется иметь не только для API, но и для javascript'овой части проекта. Поделитесь опытом - кто что использовал для генерации доков?
  • Вопрос задан
  • 2272 просмотра
Подписаться 21 Оценить Комментировать
Ответ пользователя Vov Vov К ответам на вопрос (4)
@balamut108
Py
Добрый день, при выборе подобных технологий надо руководствоваться, тем что, если что-то заглючит сможете ли Вы сами это поправить или попросить помощи у сообщества. Кто бы не ругал Сфинкс за его косяки с кириллицей и т.п., как мне кажется у Сфинкса самое большое сообщество, тем более что он более всего известен в нашей среде. + надо понимать, что через N-лет что-то может умереть, а я думаю, что Сфинкс ещё 3-5 лет протянет.
Ответ написан
Комментировать