Codifier PHP: une nouvelle génération d'outillage pour la documentation
Présentation par Gina Banyard sur la nouvelle génération d'outils pour moderniser la documentation PHP au Forum PHP 2025
Cette sketchnote a été réalisée lors du Forum PHP 2025. Elle illustre la présentation "Codifier PHP: une nouvelle génération d'outillage pour la documentation" donnée par Gina Banyard, qui explore la modernisation de l'outillage de documentation PHP.
Contenu de la présentation
Gina Banyard révèle la fragmentation de PHP.net : site, analytics, binaires dispersés dans de multiples dépôts, mais la documentation elle-même n'y est pas centralisée. L'évolution des outils de documentation montre une maturation progressive : du parsing du code C vers DocGen, puis PHP 8 avec les stubs, GenStub, et enfin Stub-to-DocBook testable. Le format DocBook offre structure sémantique et crosslinks. Pour le rendu, XSLT traditionnelle (lente, compliquée) cède la place à PHP générant sa propre documentation : plus rapide, mieux maintenu, cohérent.