Aller au contenu
CONTACT

Loi du commentaire menteur

PROGRAMMATION ET BUGS

Quand le commentaire et le code ne sont pas d'accord, ils ont probablement tort tous les deux.

— Anonyme, folklore informatique
VIDEO.EXE16:9

Les commentaires sont les phrases que les programmeurs laissent dans le code pour expliquer ce qu'il fait. En théorie, c'est une gentillesse envers ceux qui viendront après. En pratique, ce sont comme les panneaux d'une route qui a été déplacée entre-temps.

Le code change, le commentaire reste. On trouve ainsi écrit « calcule la remise de dix pour cent » au-dessus d'une fonction qui envoie un e-mail au directeur. Qui a raison ? Personne. Le commentaire raconte une intention ancienne, le code un accident moderne.

Il existe aussi l'école de pensée opposée, celle des programmeurs fiers qui ne commentent jamais : si c'était difficile à écrire, ça doit être difficile à comprendre. Moi, je suis entre les deux. Je commente toujours, mais avec des phrases du genre « ne pas toucher ». Ça n'explique rien, mais ça sauve beaucoup de vies.