example - ¿Está phpDocumentor muerto?
phpdoc example (4)
¿Por qué arreglar algo que no está roto? PHPDoc funciona muy bien, no necesita nada más realmente. No están intentando innovar, solo para ayudar a crear documentación. Lo que hicieron, muy bien.
¿O es solo en un estado ''terminado''? He usado PHPDoc durante muchos años en todos mis proyectos de PHP, pero hace poco noté que la última publicación en el sitio web de PHPDoc fue de 2008. Así que me pregunto si es hora de buscar otras alternativas como Doxygen. ¿Hay alguna ventaja de usar algo que no sea PHPDoc?
EDIT: publicación interesante en Dev Zone hoy cuando Matthew anunció el lanzamiento de Zend Framework 1.11.5, escribió:
"Mike van Riel ofreció convertir nuestra generación de documentación API a DocBlox. Ya lo habíamos estado considerando para ZF2, pero al ver la flexibilidad del sistema de plantillas y, lo que es más importante para nosotros en términos de empaque, la velocidad y los recursos mínimos. se utiliza para generar la salida, nos vendieron (el tiempo de generación de la documentación API se redujo de 80 a 100 minutos a menos de 10). Puede ver los resultados por sí mismo ". http://devzone.zend.com/article/13643
Por eso me preocupa, si proyectos grandes como Zend Framework están cayendo phpDoc, me parece que la inactividad de phpDoc no pasa desapercibida. 100 minutos hasta 10 ... eso es lo que me gusta escuchar.
@ gms8994 buena llamada
* ACTUALIZACIÓN: Resulta que DocBlox es PHPDocumentor2 disfrazado / renombrado. http://www.docblox-project.org/
Aunque actualmente uso doxygen, también tengo que publicar que PHPDocumentor no está muerto. En cambio, los intentos realizados por el proyecto http://www.docblox-project.org/ se unen para formar la base para PHPDocumentor2 que luce un sitio web completamente nuevo. En estos días no estoy convencido de que esté listo para la producción, pero ya se ve muy prometedor.
Recientemente he usado Doxygen para generar documentación para PHP. Esta es una herramienta de código abierto para la documentación y también para otros idiomas. Diría que es una buena herramienta y genera fácilmente documentación, diagramas de clase y muchas funciones configurables. Está disponible para Windows así como para UNIX / LINUX.
Tuve varios problemas con phpDocumentor. Una de ellas fue la exportación xml. Después de algunos intentos de corregir el código, decidí buscar una alternativa.
Lo que encontré y me gustó fue: Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home
Rarangi is a generator of documents from php source code.
Lo interesante de esto es que guarda la información en una base de datos de mysql y puede crear sus propios informes personalizados.