Bueno anteriormente hablaba de PDFParser pero cuando entre a revisar la documentación de si API, me encontré con algo muy interesante si ese mismo que esta en el titulo, phpDocumentor, es una excelente herramienta que genera a partir de los comentarios de tu código la documentación necesaria para tu proyecto, ya no tiene que pensar en documentar el proyecto para el usuario y para el developer porque ya podrías hacerlo con la misma herramienta.
Basta con entender algunas sintaxis para que esta utilidad pueda generar el sitio web de documentación, a modo de un compilador organiza todo lo que tengas escrito en una bonita pagina dispones de templates para tu documentación o también podrías diseñarla tu mismo eso es lo de menos.
De fácil instalación solo debes usar Pear o el afamado Composer para que empiezas a crear bellas documentaciones en cuestión de minutos.
Me parece muy buena herramienta la tendré en cuenta para mis próximos proyectos creados con PHP.
URL : http://www.phpdoc.org/

