CODE COMPLETE「19.3 コメントすべきか、否か」

「よいコメントは、コードの繰り返しでも説明でもありません。その意図をはっきりさせるものです。コメントは、コードよりも高い抽象化のレベルで、何をしたいのかを説明するべきだと思います。」

ルーチン内部のコメントについては、それを守っているつもりなのですが、
関数定義のコメントについては、自明な関数にもコメントをつけてしまう癖があって、

float GetStandardLength(); // 標準長を取得する

みたいなのをついつい書いてしまうことがあります。この場合は(もし必要なら)、「標準長」ってのが何を意味するのか、とかをむしろ書くべきなのでしょうね。

最近気になったコメントとしては、次のようなものがあります。

...
HogeFunc(); // トリッキー?
...

これを読まされたときにはちょっと頭を抱えました。orz