autant de commentaires stériles dans un fichier
Evidement, si c'est stérile... Raconter sa vie ne doit pas faire avancer le schmilblick.
Mais je ne vois pas comment le fait d'intégrer les descriptions litérales des prototype des fonctions avec une explication CLAIRE de leur objet peut rendre le code illisible.
En suivant quelques règles simples, c'est le contraire (surtout avec un bon IDE).
Par exemple, en Java (mais ces conseils peuvent aussi s'appliquer à d'autres langages) : http://java.sun.com/j2se/javadoc/writingdoccomments/(...)
[^] # Re: Un cri de désespoir du développeur d?un projet Open Source.
Posté par Benoît Bailleux (Mastodon) . En réponse à la dépêche Un cri de désespoir du développeur d'un projet Open Source.. Évalué à 1.
Evidement, si c'est stérile... Raconter sa vie ne doit pas faire avancer le schmilblick.
Mais je ne vois pas comment le fait d'intégrer les descriptions litérales des prototype des fonctions avec une explication CLAIRE de leur objet peut rendre le code illisible.
En suivant quelques règles simples, c'est le contraire (surtout avec un bon IDE).
Par exemple, en Java (mais ces conseils peuvent aussi s'appliquer à d'autres langages) : http://java.sun.com/j2se/javadoc/writingdoccomments/(...)