JavaDoc et PHPDoc

Je suis fan de la JavaDoc du coup je truffe mes devs PHP de @return et autres @param (pour ne citer qu’eux) et maintenant avec PHP5 je peux ajouter des @access et autres @static et @abstract … bref tout ça pour dire que j’ai trouvé l’outil ultime : j’ai nommé doxygen, il permet de générer la doc en HTML, RTF, PS, PDF, man Unix. Doxygen est distribué sous license GPL.

Bref pour l’avoir testé à l’instant, je dois dire que le résultat surpasse ce que j’obtenais avec le parser de phpDoc (http://www.phpdoc.de à ne pas confondre avec les autres parseurs comme phpdocumentor par exemple.)

Bref, si vous ne développez pas avec un ide ayant cette fonctionnalité intégrée, je vous le conseille.

Ah oui j’allais oublier, ici (developpez.com) vous pouvez trouver un bon comparatif des solutions de documentations pour PHP.

DevEdge est de retour

Pour toutes les personnes soucieuses du respect des standards du web : voici la nouvelle adresse de devEdge (le site de référence de Netscape qui a fermé il y a qques mois)
http://devedge-temp.mozilla.org/index_en.html

Sur ce site vous trouverez un site totalement obsolète mais en attendant le transfert du contenu vers devmo, il restera une référence très appréciable pour la doc sur HTML, CSS2 et Javascript.

Il y a aussi la fameuse devEdge Sidebar que l’on peut ajouter dans son navigateur favorit : http://devedge-temp.mozilla.org/toolbox/sidebars/