コメントの付け方

コメントを付けるのは、後々コードを読み返すときのコストを減らすため。コメントを付けるべきかどうかは、コメントを付けるコストと、後々節約できるコストのバランスで決まる。

そのコメントが将来的にはコードを理解する時間を 10 分節約するとします。それはそれで素晴しいことですが、そのコメントが冗長で書くのに 5 分かかり、後で読むときには 5 分かかるものであったとしたらどうでしょう。節約できる時間は差し引きゼロです。それでは元も子もありません。

http://www.ibm.com/developerworks/jp/linux/library/l-clear-code/