L'effet des commentaires sur l'interprétation d'un code contenant des erreurs

L’effet des commentaires sur l’interprétation d’un code contenant des erreurs

L’effet des commentaires sur l’interprétation d’un code contenant des erreurs peut être mesuré assez élégamment par une expérience dans laquelle plusieurs versions d’un même code est produite, une avec des commentaires corrects, une avec un ou deux commentaires incorrects, et une sans aucun commentaire (Okimoto, 1970). Pour certains types de code, au moins, l’interprétation correcte de ce que fait le programme peut être obtenue avec plus de fiabilité et plus rapidement sans commentaire du tout. Des commentaires corrects, s’ils sont bien construits, réduisent les erreurs si l’on compare avec les cas contenant des commentaires incorrects ou biaisés. Quoi qu’il en soit, beaucoup de programmeurs expérimentés ont pris l’habitude de masquer tous les commentaires quand ils scrutent le listing d’un programme à la recherche d’erreurs, de manière à réduire l’“effet contexte” qui, quoi que utile pour comprendre un programme correct, ne fait que compliquer la tâche déjà impossible du débuggage.

Ma traduction d’un extrait de The psychology of computer programming, Gerald M. Weinberg.

The effect of comments on interpretation of erroneous code.

The effect of comments on interpretation of erroneous code can be mesured quite nicely in an experiment in which several versions of the same code are produced, one with correct comments, one with one or two incorrect comments, and one with perhaps no comments at all (Okimoto, 1970). For certain types of code, at least, correct interpretation of what the program does can be obtained more reliably and faster without any comments at all. Correct comments, if well constructed, reduce errors when compared with cases in which incorrect or misleading comments are used. Nevertheless, many exprienced programmers make a habit of covering all comments when scrutinizing a program listing for errors, thus reducing the set which, though helpful to understanding a correct program, only complicates the already impossible job of debugging.

The psychology of computer programming, Gerald M. Weinberg. p. 164 of the silver anniversary edition.