プログラムソースにコメントを書くか？：プログラマー社長のブログ：オルタナティブ・ブログ

たまにはプログラミングネタでも。 先日ProDHCPのお問い合わせいただいたお客さんとのミーティングの際に、ProDHCPのソースライセンスの購入も検討しているというお話しになり、そのときに、「開発言語は何ですか？」「ソースのボリュームはどのくらいですか？」という感じにご質問をいただき、最後に「ソースにコメントはどのくらい書いてありますか？」との質問をいただきました。 私の返答は、 「ソースにコメントはほとんど書きません！」 です。お客さんは、ソースのボリュームに対してコメントのボリュームがどのくらいあるのかを知りたいという意味合いもあったようですが、ソースにコメントが必要かどうかという議論は、私が若い頃からずーっと盛り上がるテーマの1つです。 私の考えは、 コメントを見ないと理解できないようなソースでは駄目。シンプルでわかりやすいソースこそ、バグが少なく性能も高い。 コメントは度重なる仕

[vanbraam]

だいたい同意;JavaDocみたいなのは(コードを読む時ではなく)ライブラリーを使う時に役立つのであってもいいと思う(むしろコードから遠い所にAPIドキュメントがある方が有害)

[tmf16]

現場の文化次第だよね。ちなみに私もコメント最低限派。理由は共感できるけど絶対論者はちと苦手

[legoboku]

コメント書くより、分かりやすくコード書け。

[tmtms]

他の人から使用されるライブラリ関数の説明は詳細に書くべきだと思う。ドキュメントとして。

[kkotyy]

おっしゃる通りが理想で、そうありたいところだけど、そこまでの自信はなくて、無くても良いコメントを自分の安心のために入れてしまっている。