Хочется внедрить некий генератор документации кода. Конечно, хотелось бы просто взять один из них и включить чтобы оно заработало, но есть у нас несколько проблем, чтобы можно было оставить свой мозг в покое и не мучать его интеграцией всего этого дела.
Первая и основная проблема — текущий проект представляет собой веб-приложение. В нем используется два языка. JavaScript для клиентской части и PHP для серверной. Необходимо чтобы документация была сделана и для серверной и для клиентской части. По большому счету ничто, кроме кошерности, не мешает использовать два различных генератора документации. Но хочется мне, дабы обе части проекта обрабатывались одинаково. Не хочется иметь различный внешний вид документации для разных частей одного проекта. Плюс у них наверняка будут различаться требования к синтаксису, что тоже нехорошо.
Первая и основная проблема — текущий проект представляет собой веб-приложение. В нем используется два языка. JavaScript для клиентской части и PHP для серверной. Необходимо чтобы документация была сделана и для серверной и для клиентской части. По большому счету ничто, кроме кошерности, не мешает использовать два различных генератора документации. Но хочется мне, дабы обе части проекта обрабатывались одинаково. Не хочется иметь различный внешний вид документации для разных частей одного проекта. Плюс у них наверняка будут различаться требования к синтаксису, что тоже нехорошо.