CODE COMPLETE「19.3 コメントすべきか、否か」
「よいコメントは、コードの繰り返しでも説明でもありません。その意図をはっきりさせるものです。コメントは、コードよりも高い抽象化のレベルで、何をしたいのかを説明するべきだと思います。」
ルーチン内部のコメントについては、それを守っているつもりなのですが、
関数定義のコメントについては、自明な関数にもコメントをつけてしまう癖があって、
float GetStandardLength(); // 標準長を取得する
みたいなのをついつい書いてしまうことがあります。この場合は(もし必要なら)、「標準長」ってのが何を意味するのか、とかをむしろ書くべきなのでしょうね。
最近気になったコメントとしては、次のようなものがあります。
... HogeFunc(); // トリッキー? ...
これを読まされたときにはちょっと頭を抱えました。orz