Salut
-----
Je n'envisage pas un code non commenté, déjà pour les raisons suivantes :
1) Je sais programmer et je sais ce que j'ai programmé. Pourtant quand je relis un ancien programme je suis bien heureux de trouver des commentaires. Ce qui semble évident aujourd'hui ne le sera pas forcément demain.
2) Les commentaires ne coûtent rien et n'allongent pas la durée d'exécution, donc on ne gagne rien en n'en mettant pas
3) L'argument consistant à dire qu'on perd du temps en écrivant des commentaires est une farce : personne n'utilise 100% de son temps à taper du code (il y a un temps de réflexion), et on réfléchit aussi en tapant ses commentaires, voire on s'aperçoit en expliquant ce qu'on a fait qu'il y avait moyen de faire plus simple et plus évident
4) La majorité de ceux prétendant que les commentaires sont inutiles sont les mêmes que ceux qui prétendent qu'établir d'avance le schéma de son programme (pseudo-code, ordinogramme etc) est inutile. Et, de ma propre expérience, ce sont justement ceux-là qui crient au secours en envoyant à debugger des codes illisibles et dépourvus de commentaires. Pour moi, quand je reçois une demande d'assistance avec absence de commentaires, c'est poubelle direct
5) Ceux qui trouvent les commentaires des autres inutiles n'ont simplement qu'à ne pas les lire. Par contre, ceux qui les trouvent utiles ne peuvent pas lire ceux qui ne sont pas présents. Donc, sauf si on est certain que son code ne sera jamais lu par d'autres, il faut au minimum avoir une démarche ouverte.
6) Pour moi, je suis de l'avis diamétralement opposé à celui de l'auteur de l'article. Lui prétend qu'un code suffit pour retrouver les commentaires, et moi j'affirme qu'on doit pouvoir ré-écrire le code à partir des commentaires, si ceux-ci sont bien réalisés. Même un programmeur averti lit et comprend plus efficacement sa langue natale qu'un langage informatique.
7) Les affirmations sont beaucoup trop généralistes à mon avis: Si on peut admettre la pauvreté (pas l'absence) des commentaires dans un langage proche de la syntaxe humaine (genre C#-> Linq), je défie les meilleurs programmeurs de s'y retrouver de façon "naturelle" dans les langages bas niveaux, surtout lorsqu'il s'agit de fonctions manipulant les données de façon complexes (algos mathématiques, conversions, etc).
Ma conclusion est qu'un commentaire inutile ne dérange personne et n'induit aucune perte de performance. Par contre, un commentaire absent peut se révéler dérangeant. On peut donc décider de ne pas commenter, mais conseiller de ne pas le faire est une absurdité monumentale car ce conseil loufoque ne manquera pas d'être pris pour argent comptant par ceux, justement, qui ont le plus intérêt à commenter: les débutants.
A+
Claude
12 |
2 |