2007-02-13 コメントの詳しさ Prog メモを書くとき、たとえ忘れてしまっても「自分なら気付く」と思うことは省きます。 省いたほうが簡潔になりますし、詳しすぎると読むことが表面上だけのことになってしまいます。 また、詳しければ詳しいほど正しくなければなりません。矛盾を起こすことも増えます。 プログラムのソースコードでもそうでしょう。 コードは言語の処理系に、コメントは自分を含むプログラマーに読ませるものです。 自明な型変換なら書かないほうが矛盾を防げます。 詳しすぎるコメントはコードに合わせて保守するのに手間が掛かります。