Documentación en PHP
Algo muy molesto a la hora de programar es tener abierto un editor de textos al lado para ir documentando lo que uno va haciendo, con lo fácil que resulta comentar el código y que esos comentarios sean los que se publiquen como documentación, entonces me dediqué a probar y probar programas que extrajeran los comentarios de mis PHPs y generará la documentación, y pues phpDocumentor, phpDoc (la inspiración a la hora de poner nombres no abunda), Doxygen, probé todos ellos, con mayor o menor fortuna, pero finalmente el que cumple mis expectativas es PHPXref, es rápido, sencillo de configurar, no tiene dependencias, está programado en Perl, por lo que en cualquier sistema *nix no tiene porque dar ningún problema, y el archivo de configuración no supera las 50 líneas, esto es de agradecer, porque cuando abrí el archivo de Doxygen me asusté, nunca veía donde acababa.
Puestos a quejarse, PHPXref sólo te da salida en HTML, mientras que Doxygen te da salida hasta en PDF, pero bueno a mí me gusta mucho PHPXref, y lo estoy utilizando para todos mis desarrollos, y me hace muy sencillo programar, porque a veces me estoy dando cuenta de fallos que cometo, que tal vez de otra forma no sería posible, si alguien quiere ver un resultado de como genera documentación PHPXref puedes ver la nueva documentación de la nueva versión de MTHPortal, espero que resulte bonito, tengo que tocar un poco el CSS para que sea más parecido al diseño de MTHPortal, aún no está del todo bien documentado, pero poco a poco, además si alguien mira el código del CMS verá que apenas llevo un 30% de la versión final lista.

Meneame
del.icio.us