Si les variables, classes, fonctions sont bien nommées il n'y a normalement pas grand chose à commenter.
Ce qui est intéressant de commenter, c'est pourquoi tel ou tel prise de décision lorsqu'on s'écarte d'un truc qui paraitrait évident de faire autrement, ou de pourquoi la valeur de telle ou telle constante. Après énumérer ce qu'on fait dans le code a peu d'intérêt.
[^] # Re: Complètement crétin !
Posté par Psychofox (Mastodon) . En réponse au journal Comment briller auprès de la gent féminine dans « le monde de la tech ». Évalué à 10. Dernière modification le 06 décembre 2023 à 15:45.
Si les variables, classes, fonctions sont bien nommées il n'y a normalement pas grand chose à commenter.
Ce qui est intéressant de commenter, c'est pourquoi tel ou tel prise de décision lorsqu'on s'écarte d'un truc qui paraitrait évident de faire autrement, ou de pourquoi la valeur de telle ou telle constante. Après énumérer ce qu'on fait dans le code a peu d'intérêt.