Moi, j'utilise la methode Extrem Programming.
Je n'ai aucun commentaire dans mon code de production. en effet la méthode m'amène à coder proprement (pas de duplication, pas de code mort, une et une seule idée par méthode, conception simple, programmation piloté par les test ...) et donc d'avoir un code trés lisible (n'oublions pas que ces soit-disant commentaires doivent être lu pas des codeurs qui sont suppossé connaitre le langage de programation qu'ils ont sous les yeux). De plus, dans un projet actif, le code est remanier (refactoring) s'en cessent. Qui va maintenir les commentaires qui vont avec ce code remainier. C'est un double travail laborieux. cette situation entraîne la présence de pavé de commentaires qui ne corresponde plus au code en dessous...
Par contre, je code mes tests unitaires avant de produire ou refactorer le code de prodution. c'est là que je mets des commentaires, pour expliquer mon jeu de test et les subtilisés de la fonctionalité implémenté.
Les commentaires servent réellement de documentation technique. Les commentaires sont alors facile à maintenir car centralisé dans les tests.
[^] # Je commente mes tests
Posté par Pothin Alain . En réponse au sondage Je commente mon code :. Évalué à 2.
Je n'ai aucun commentaire dans mon code de production. en effet la méthode m'amène à coder proprement (pas de duplication, pas de code mort, une et une seule idée par méthode, conception simple, programmation piloté par les test ...) et donc d'avoir un code trés lisible (n'oublions pas que ces soit-disant commentaires doivent être lu pas des codeurs qui sont suppossé connaitre le langage de programation qu'ils ont sous les yeux). De plus, dans un projet actif, le code est remanier (refactoring) s'en cessent. Qui va maintenir les commentaires qui vont avec ce code remainier. C'est un double travail laborieux. cette situation entraîne la présence de pavé de commentaires qui ne corresponde plus au code en dessous...
Par contre, je code mes tests unitaires avant de produire ou refactorer le code de prodution. c'est là que je mets des commentaires, pour expliquer mon jeu de test et les subtilisés de la fonctionalité implémenté.
Les commentaires servent réellement de documentation technique. Les commentaires sont alors facile à maintenir car centralisé dans les tests.