コメントは信じるな。
コードを信じろ。

前に酷い目にあった。
一見コメント通りなのだが、よく見ると全然違うコード書いてるの。
コメント読んじゃって処理の概念はあってるから
コードも正しいって思い込んでたのよ。

だからコメントは、コーディングした人が
何を実装したがってるか？だけに留めて
コード以外は、信じない事にしてます。

つまり、コメントが無くてもドキュメントがあれば問題なし。
自分でコード追うから。
でも、トリッキーなコードや処理(セオリー無視、自分方式)は
手がかり的な意味でコメントは必要か…