Bonjour,
Au cours d'une de mes promenades internetiennes, j'étais tombé sur un site ou forum qui défendait l'abscence de commentaire dans le code. Malheureusement j'en ai perdu le lien.
Il ne s'agissait pas d'un site genre larache. La personne affirmait qu'on pouvait se passer de commentaire dans le code car :
- les tests unitaires servent de doc interne
- le code doit être auto-documenté (noms de variable et de classe clairs, taille des fonctions réduite, ...)
- les commentaires sont rarement pertinents
- si un bout de code astucieux a besoin d'être commenté, il n'a pas à être là (principe du "faire simple")
- la doc générale (genre diagramme UML et autre CdC) est de toute façon à l'extèrieur du code (la personne insistait par ailleurs sur la nécessité d'une doc externe)
- ... et j'en oublie...
Est-ce que qqu'un aurait un lien vers un site défendant ces idées (qui sont à l'extrem de l'extrem programming) ?
Et par ailleurs, qu'en pensez-vous ?
Yvan
boute-feu
Partager