こんにちは、林です。今回の記事では、「ソースコードに書くコメントは必要最小限が良いか」という命題について考えてみたいと思います。

コメントは最小限が良い？

巷の書籍やブログ記事で、優れたプログラマによる以下のような意見をよく目にします。

今、改めて考えて、どのような言語であってもどのようなコーディング規約であっても、私はソースコードのコメント率は原則20%を切ることが望ましいと思う。可読性の意味でもメンテナビリティの意味でも、開発生産性の意味でも。私が考えるに、本来コンピュータが読むためのものであるソースコードに人が読むためのコメントを付け加えなければならないのは、次の２通りの場合だけである。

404 Blog Not Found： コメント！＝ドキュメント

私はほとんどコメントを書かない。書いたら負けとすら思っている。もしコメントなしではそのcodeが理解できないのだとしたら、それはcodeに語らせることに失敗しているのだ。

果たして、ソースコードそのものに語らせて、コメントは最小限にするのは正しいのでしょうか。これは、上級プログラマだけが集うような特別な環境下においては正しい場合もあるでしょうが、プログラマの上達過程や教育の観点からすると間違っていると思います。以下、その理由を述べます。