最近のコメントはこれまで以上に簡単です。Javaには、コメントをクラスにリンクするための優れた手法がいくつかあり、Java IDEはコメントシェルの作成に適しています。Clojureなどの言語では、関数のコード自体に関数の説明を引数として追加することもできます。
しかし、私たちは今でも良い開発者によって書かれた時代遅れのコメントや劣悪なコメントが頻繁にある時代に生きています。
特にここではJava / Clojure / Pythonに興味がありますが、回答は言語固有である必要はありません。
コメントを検証し、「薄っぺらな」コメント（マジックナンバー、不完全な文などのコメントなど）または不正なコメント（スペルミスなどの検出など）を自動的に検出する新しい手法はありますか。
そしてもっと重要なことは、「コメント政策」や戦略が受け入れられているということですか？コーディング方法に関するアドバイスはたくさんありますが、「コメントの方法」についてはどうでしょうか。
回答:
名前/ドキュメントには、あなたが何をしているかが記載されているはずです。
実装は、あなたがそれをどのように行っているかを教えてくれるはずです。
コメントは、なぜあなたがそれをあなたがする方法でするかをあなたに伝えるべきです。
これは議論の余地があるかもしれませんが、私のアドバイスは可能な限りFEWコメントとして書くことです。代わりに、わかりやすくわかりやすいクラス名、変数名、メソッド名を使用してください。できる限り明確な方法でコードを記述してください。そして、これがコードの最も重要な属性であると考えてください（要件を満たしていることを除く）。可能な限り明確なメソッドを作成し、さらに説明が必要だと思う場合にのみ、コメントを書いてください。
そして、誰かがクラスを変更するときはいつでも、コメントがすべて正しいことを確認しなければならないという組織的な慣習があります。
if (a == b) then c();は知っていますが、なぜそれを行うのかわからない場合は、コメントを使用する必要があります:)
コードコメントを使用してドキュメントを自動生成する方法を見つける最も信頼できる場所の1つは、確実にdoxygenです。そのようなツールはもっとたくさんありますが。
これは、ドキュメントを自動的に生成するために従うべきコメント作成の標準を定義します。ただし、これは構造の詳細を提供しますが、意味的には検証しません。たとえば、関数の目的を説明するために誤解を招く英語を使用したかどうかを確認できません！
これはコメントを構造化するのに最適なものですが、個人的には、コード自体をより保守しやすくするために、より多くのドキュメントが必要だと感じています。しばらく前にP.SEに質問がありました。コードはオープンソース開発者ツールのドキュメントになりますか？どれくらいの頻度ですか？もちろん、これは非オープンソースプロジェクトにも当てはまります。
コードをよりメンテナンスしやすくするために、コードを処理する方法の構造を作成するのに役立つ外部ドキュメントが存在することが実際に重要であり、コード内のコメントは表示を制限する必要があります
コメント作成のポリシーを定義する場合は、コーディング標準に含まれる全体的なアプローチとして含める必要があると思います。これを参照してください：開発チームにソフトウェアを生成するスタイルガイドとドキュメントを導入する際の落とし穴は何ですか？
通常、コメントはコードの5％未満を構成します。そして実際には、コードレビュー自体が（開発の他の側面よりも）あまり注目を集めていない一方で、コメントもレビューされることは実際上困難です。
コメントを検証し、「薄っぺらな」コメント（マジックナンバー、不完全な文などのコメントなど）または不正なコメント（スペルミスなどの検出など）を自動的に検出する新しい手法はありますか。
よく知られた手法があります-「コードレビュー」と呼ばれ、「ペアプログラミング」という名前の姉妹がいます。ここで「自動的に」何かを期待しないでください。
そしてもっと重要なのは、「コメント政策」や戦略が受け入れられているということですか？コーディング方法についてはたくさんのアドバイスがありますが、「コメント方法」についてはどうでしょうか。
「完全なコード」には、コーディング方法に関するすべてだけでなく、「コメント方法」、特に自己文書化コードの記述方法に関する章も含まれています。
Javaに特化した1つのソースは、OracleのJavadocツールのドキュメントコメントの書き方です。
このドキュメントでは、Sun MicrosystemsのJava Softwareで作成されたJavaプログラムのドキュメントコメントで使用するスタイルガイド、タグ、および画像の規則について説明します。
そして、項目44：すべての露出API要素のための書き込みdocコメント：
APIを使用可能にする場合は、文書化する必要があります。従来、APIドキュメントは手動で生成されていたため、コードとの同期を維持するのは面倒でした。Javaプログラミング環境では、Javadocユーティリティを使用してこのタスクを容易にします。Javadocは、特別にフォーマットされたドキュメントコメント（より一般的にはドキュメントコメント）を使用して、ソースコードからAPIドキュメントを自動的に生成します。
以下からの効果的なJavaの第2版。