プリンシプル

プリンシプル PIE原則

Program Intently and Expressively. 意図的かつ表現力豊かにコードを書く。

コードは人が読むものである。ドキュメントが付属する場合もあるがコードと実行結果が真実だ。

他のプリンシプルでも説明した通り、コードは書くより読む時間の方が長い。つまり読む時間を優先すべきだ。

目先の利益に囚われ無責任な変更を採用するのではなく、長期的な利益のために、読みやすく、品質の高いコード・テストを書くことが大切だ。

コードは読みやすいものが良い。ただし、コードですべてが理解できれば良いが、何をどのようにしているかまではわかっても、その経緯の「なぜ」までは表現できない。そのようなときはコメントを積極的に活用するべきだ。できる限り、コメントを書かなくても理解できるようなコードを書くべきだが、読む人に必要な説明はコメントとして記述するべきである。