Документирование кода: зачем это нужно

Немного теории: стандарт phpdoc

Обзор phpDocumentor

Обзор Doxygen

Вывод: краткая сравнительная таблица