まだ考えを整理できてないのでちょっととっちらかった記事になっていると思います。 本旨としてはタイトルのとおりです。 「正しく書かれたソースコードにコメントは必要ない」なんて幻想だという話 を受けての記事です。 //フェードインが未完了の場合 if (alpha < 1.0f) { // ... } このコードを、次のようにします。 function isFadingIn() { return alpha < 1.0f } if (isFadingIn()) { // ... } これについて、土屋さんは ただ、この条件式がコード上でこの一箇所しか現れない場合に、「(コメントではなく)コードのみで意図を説明する」ためだけにメソッド化すべきなのかには疑問があります(名前空間汚染も起こりますし)。 と書いています。 これについて、コードに妥当な名前をつける行為は「コードのみで意図を説明する」ため