極論すると、コメントが無いと読めないコードはダメ - Natural Software

このあたりを読んでいて同意することが多かったのでちょっと書いておく。 コードコメントに書くべきは「意図」 - プログラマーの脳みそ 404 Blog Not Found:コメント!=ドキュメント 小野和俊のブログ:ソースコードのコメント率は20%を切ることが望ましい 煽り気味だけど 極論すると、コメントが無いと読めないコードはダメ 言い方を変えると コメントが無くても読めるソースが良い というのが自分のスタンス。 当然、全部が全部コメントなしではなく、こういうところは｢なぜこう書いたか？｣をコメントに残す。 わかりづらいところ 意図して冗長にしてるところ 意図して省略してるところ こういう考え方に至った経緯 もともとは一行一行に｢なにしてる｣をちゃんと(笑)コメントしてた でも、バグを直してるうちに、コードは直すけど、コメントは直さない、という状態になった コードで何してるかわからず、コメ

[fuktommy]

ローカルな用語をどう伝えるか、みたいなのが難しいなあと思ってる。$uid とあれば携帯電話のUID(or EZ番号)のつもりだけど、携帯電話知らない人が見たらUIDってなんですか、みたいなところ。

[katzchang]

検証可能性からいえば、コメントよりテストコードのほうがよほど大事。