Le code

Éternel débat sur les commentaires de code, ni trop, ni pas assez. Normalement le nom de fonction suffit à comprendre ce que ça fait, mais pour comprendre certains passages à l'intérieur il peut être bon de clarifier ce que ça fait, ou pourquoi vous l'avez fait (est-ce un workaround ? …).

info

Une technique souvent vue en Java est de faire des mini-fonctions avec des noms explicites. Donc une fonction qui ferait normalement 50 instructions se retrouve avec juste des appels à 5 sous-fonctions, qui elles-mêmes appellent d'autres. On se retrouve à lire des phrases explicites, mais on retrouve surtout avec une pléthore de fonctions. À vous de juger votre idéal.