J'utilise phpdoc pour générer la documentation de réference de Jelix. Globalement, il répond à mes besoins sur le papier. Cependant, il a des défauts :

  • j'ai rencontré pas mal de bug. Et le fait qu'il soit sortie dans une nouvelle version récement n'y a rien fait (il y a eu quand même 6 releases candidate !).
  • d'ailleurs, même si l'architecture globale du code n'est pas trop mauvaise, son code source est assez obscure : on voit qu'il y a des portions de code de qualité inégale qui ont été rajoutés au fil des ans (et qui ont causé les bugs de regressions que j'ai trouvé), et du coup, je n'ai pas eu le temps d'aller trés loin dans mes tentatives de corrections de bugs..
  • c'est une appli plutôt lourde, et lente

J'ai bien essayé de regarder ailleurs, mais le seul truc que j'ai trouvé, et qui soit à la hauteur (et relativement compatible) au niveau des tags, est doxygen (mais difficilement personnalisable, pas de templates...).

Ce week end, phpdoc m'a assez énervé. Et que fait un développeur quand il ne trouve pas son bonheur avec les outils qu'il a ? Il le fait soit même ! Et donc j'ai eu une de ces envies de programmer, de faire un générateur de document from scratch, léger, php5 only, avec un système de template léger (basé sur jtpl bien sûr).. et tout et tout. Ça a fourmillé dans ma tête tout le week-end, à me demander comment j'allais faire ceci, cela, à me demander si ça valait le coup que je me lance là dedans, à tenter d'évaluer le travail à faire.

Mais finalement, aprés de longues reflexions, j'ai pu me convaincre que ce n'était pas raisonnable. Ma todo list est assez chargée comme ça :-) Mais peut-être qu'il y a un développeur qui s'ennuie dans le coin ? :-)

En attendant, j'ai décidé de rester avec phpdoc et de poster des bugs sur le site du projet... :-|