Je pense que la seule bonne façon d’appréhender un système est de décrire sa conception : concepts, architecture, API, mécanismes, etc.
C’est ce que je fais modestement sur mes plugins et c’est vrai que ça me permet de rapidement me reconnecter quand j’oublie un plugin quelques mois.
C’est quelque chose qui me plairait à faire mais j’avoue que je ne saurais pas par où commencer avec SPIP ni quelle table des matières respecter. Mais ça peut être un joli chantier indépendant du code produit car le PHPDoc n’est qu’une vision locale et limitée du système.
Et pour le coup par ailleurs a chaque grosse évolution il y a un message envoyé. Reste apres ca l’équipe documentation d’en faire un doc pour spip.net en plus de ce qui a deja était fait