Un code bien documenté est un code facile à comprendre. En commentant correctement nos classes nous pourront plus tard générer une documentation très rapidement avec des outils comme phpDocumentor ou Doxygen. De la même façon, les IDE modernes sont capable de comprendre et lire ces commentaire ce qui nous permettra ensuite de comprendre plus simplement notre code.
Formation La POO en PHP : Bien documenter ses classes
