2008年09月23日 よくないプログラムコメントの書き方について プログラムのコメントというのは、人によって書き方は様々である。 2008年07月30日 otsune コードでhowやwhatは書けてもwhyは表現できません!はてなブックマーク - Latest topics > ドキュメントは善か悪か - outsider reflex と、otsune さんも言うように、俺が考えるプログラムのコメントというのは、「summary」や「why?」を書くべきであって、決して「what?」をひたすら書くべきではない。 (この場合の「summary」というのは、「what」の概要のようなものかもしれないし、コーディングの思想のようなものかもしれない。そして、「why」は、仕様的な「何故」かもしれないし、トリッキーな方法を説明する為の「何故」かもしれない) そもそも、「如何に(後に役に立つ)ド