私は コードにコメントを書く際の哲学について書いた投稿 の中で、 必要のないコメントこそが、最も優れたコメントだ と書きました。この点についてもう少し説明させてください。まず、コードはコメントに頼らなくても理解できるようにできるだけ簡潔にする必要があります。コードだけではどうしても分かりにくい箇所のみ、コメントを書き込むようにしましょう。 これを念頭に置いて作業することで、読者を常に意識しながら、コードが書けるようになります。1985年に出版された名著『 計算機プログラムの構造と解釈 』の、「第一版への前文」にも、この点について単刀直入に書かれています。 プログラムは人が読めるように、そしてコンピュータがついでに実行できるように書くべきである。 Donald E. Knuthも1984年に出版したエッセー『 文芸的プログラミング 』( PDF )の中で、同様のことを書いています。 これまで