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

Question

[Илья]

Доброго времени суток. Существует проект на php (в основе лежит фреймворк codeigniter). Проект быстро развивается, поэтому понадобилась система документирования. Документация будет использоваться только разработчиками. Хотел использовать PhpDoc, но это немного для другого. Что посоветуете? Заранее спасибо.

Answer 1

[Сергей Протько]

а для чего по вашему phpdoc? Ну или заведите gitlab, там есть wiki.

Comments

[Илья]

Хорошо, но если я буду использовать PhpDoc или Doxygen, то они при создании доков не засунут туда документацию самого фреймворка?

[DrNemo]

все зависит от того как вы его настроите, phpDoc поддерживает тег @package, все файлы помеченные им войдут в доки по этому пакету

Answer 2

[DrNemo]

"Документация будет использоваться только разработчиками. Хотел использовать PhpDoc, но это немного для другого"
Простите, для чего другого?
По опыту скажу, гораздо проще разобраться в коде если он сделан в едином стиле, в том числе и комментарии.
Если вы собираетесь брать опытных программистов, то такой подход спасет вас от кучи лишних вопросов от них, а программистов от кучи экспериментов для выяснения, что же делает это "волшебный" метод)