Aujourd'hui, commenter est plus facile que jamais. En Java, il existe de belles techniques pour lier les commentaires aux classes, et les IDE Java sont bons pour créer des shells de commentaires pour vous. Des langages comme Clojure vous permettent même d'ajouter une description d'une fonction dans le code de fonction lui-même comme argument.
Cependant, nous vivons toujours à une époque où il y a souvent des commentaires obsolètes ou pauvres écrits par de bons développeurs - je suis intéressé à améliorer la robustesse et l'utilité de mes commentaires.
En particulier, je suis intéressé par Java / Clojure / Python ici, mais les réponses n'ont pas besoin d'être spécifiques au langage.
Existe-t-il des techniques émergentes qui valident les commentaires et détectent automatiquement les commentaires "fragiles" (par exemple les commentaires avec des nombres magiques, les phrases incomplètes, etc.) ou les commentaires incorrects (par exemple, la détection de variables mal orthographiées ou similaires).
Et plus important encore: existe-t-il des «politiques de commentaires» ou des stratégies acceptées? Il existe de nombreux conseils sur la façon de coder - mais qu'en est-il de "commenter?"