コメントにはHOWでなくWHYを!

http://amrita.s14.xrea.com/d/?date=20050509にて、プログラムのコメントに関する重要なことが書いてあるのでメモ。

プログラミングにおいても、HOWの部分は、(人間にはわかりにくいこともあるが)ソースコードの中に表現されている。だから、WHYをコメントとして残すことが重要だと言われている。

あたりまえなんだけど、意識していないと忘れがち。後々のためにも、しっかりWHYを書かなきゃ。

そして、HOWを書かなきゃ読めないソースは最悪です。HOWを書く必要のないソースにしてくれ〜。