Salut,
Pour ce qui est de "commenter le plus possible" (et il y a même eu la suggestion de poser un algorithme en commentaire avant de l'implémenter) je ne suis pas du tout d'accord.
Pour moi, un commentaire, c'est tout d'abord un échec. C'est ne pas avoir été capable de produire du code de qualité, logique et autodocumenté.
Alors effectivement il y a des commentaires utiles et nécessaires, mais chez les débutants à l'université chez nous (Berlin) je vois surtout des commentaires du type
// addition des deux masses pour avoir la masse totale
int j = i + k;
alors que
int masseTotale = masse1 + masse2;
ferait très bien l'affaire.
98% des commentaires que je vois sont redondants, superflus, ne collent pas avec le code (là c'est le worst case, un commentaire pas mis à jour alors que le code a été patché, on ne sait plus que croire), n'apportent rien, indiquent la structure low level du code alors que le commentaire est sur une fonction abstraite, bref, avec du bon code le commentaire serait complètement inutile (et le débutant qui code avec des noms de variables à la n, m, i, j, k juste pour expliquer en commentaire ce que ca veut dire c'est vraiment l'un des pires crimes à commettre).
Edit : Sans vouloir faire de la pub, il y a un bouquin absolument ENORME (génial) sur le sujet (en anglais) qui s'appelle "Clean Code" de Robert C. Martin.
Si j'avais le choix, j'obligerais tout débutant à le lire et à l'assimiler en entier avant d'écrire ne serait-ce qu'un hello world.
Partager