Php fusion
Publié le - 1028 v. -

En programmation, des variables bien nommées valent mieux qu'un bon commentaire

Les programmeurs ont tendance à croire que les commentaires sont essentiels pour que leurs successeurs puissent facilement comprendre leur code. Une deuxième croyance fortement ancrée est le fait que ces commentaires sont essentiels pour permettre à son concepteur de se repérer à l’intérieur de son propre code lors d’une réparation. Toutefois, en se référant à l’actualité informatique, il s’y reflète que certains programmeurs ont une vision tout à fait à l’opposé de celle avancée précédemment. Ces derniers avancent ainsi qu’en programmation, des variables bien nommées valent mieux qu'un bon commentaire.

Les commentaires seraient à proscrire…

Cette idée est prônée par un développeur, anciennement amateur des fameux commentaires incriminés. Il se serait dépêtré de ses croyances après avoir réalisé quelques découvertes capitales.Il se serait ainsi, rendu compte de la nuisance des commentaires en lisant l’ouvrage de Steve McConnell « Complete Code » et celui de Robert C. « Clean Code ».

C’est en parcourant chaque page de ces ouvrages du début à la fin qu’il s’est rendu compte des raisons qui le poussaient à commenter ses codes. Il était donc forcé de commenter ses codes parce que la nomenclature de ces derniers, n’était pas bien pensée et que les fonctions et les méthodes employées sont trop généralistes pour être comprises sans un supplément d’information.

En réalisant cela, il se rendit compte que toutes ses convictions quant aux commentaires, s’envolaient en éclats. En effet, dès qu’il a commencé à appliquer les conseils qu’il a puisés dans les ouvrages qu’il a dévorés, ses codes ont gagné en clarté et bien plus qu’avec des variables mal nommées et de bons commentaires. Ceci dit, il semble que le fait de commenter un code reflète non le désir du propriétaire de ce code à le rendre plus clair, mais plutôt une incapacité à démontrer ses objectifs par le biais du code lui-même.

En guise d’exemple illustratif de ce qu’il avance, ce programmeur a conçu un code à l’aide du framework .Net. Il en a écrit une version avec des variables bien nommées et une autre avec des commentaires. Force est-il de constater que celui avec des variables bien nommées l’emporte de loin en clarté et en facilité de maintenance sur celui commenté.

Exprimez-vous.