Документирование проекта (PHP+JavaScript). Как построить систему документирования для двух языков + автосборка (Gulp)?
Добрый день, друзья!
Вот что-то мне дурно становится от объемов написанного кода и комментариев, задался целью настроить автоматическую сборку документации по проекту.
Проект PHP+JavaScript
Требования такие:
- Желательно одинаковые принципы документирования (разметка, теги) как для PHP так и для JS
- Возможность указания для метода включать его в документацию или нет, в JS не все методы нужно публиковать, дабы не засорять мозг тем кто будет пользоваться компонентом приватными функциями.
