On le dit et le répète, il est important de documenter ses sources. Car d’ici quelques mois, on ne saura pas à quoi sert une fonction, ou quels paramètres il faut lui envoyer… Et à fortiori si on travaille à plusieurs, ou si on utilise du code trouvé sur Internet (voire si on le distribue nous même).

Commenter c’est bien, bien commenter c’est encore mieux.

C’est là qu’interviennent les docBlocks, ApiGen et autre fantaisies qui simplifient la vie.