よく入門書では「コメントを書きなさい」と書いてあります。これは複雑さの大きいプログラミングの世界では常識的な話で、複雑さを大きく下げてバグの発生率を抑える効果があります。そこで貴方はなんの疑問も無く「// ここで条件を繰り返します」と書いてはいませんか？

  入門書のサンプルコードでは、コードの動きを解説する目的に沿っているので「// ここで条件を繰り返します」で問題ありません。むしろ、そのコメントは適切な役割を果たしていて良いコメントだと言えます。しかし、実際に製品のコードで、それを行うと大きなトラブルの元になってしまいます。

  つまり、「// ここで条件を繰り返します」だと、何のために処理を繰り返すのかコメントから判断できず、複雑さを下げるコメントが逆に複雑になってしまうのです。これは、ミイラ取りがミイラになってしまった状態です。例えば「// ここでDBから売上データを取得しDataSetに格納します。」のほうが適格だとは思いませんか？

  プレッシャーでコメントを書けなくなってしまっては困りますが、ここで記したい事は「コメントは目的を意識して端的にコードの役割を記する必要がある」ということです。コメントを上手に書けるようになったら、プログラミングレベルが上昇したと言われるのはこのためです。