400
Post/Edit Page
プログラムも、身なりを大切に。前任者に伝えるべき事柄をまとめてみた。▼一、無駄なインクルードをしない。ましてビルドを通したいばかりにヘッダから極低レベルなヘッダを呼び出すなど言語道断。一、誤解のない関数名をつける。何も生成しないのにCreateなどという動詞を選択してはならない。一、長すぎるファイルは分割する。ヘッダファイルが数百行に達したら不穏さを感じるべきだ。恐らく、その設計は解決すべき問題の細分化に失敗している。一、不要なメンバ変数やどこからも呼び出されていない関数はこまめに削除する。部屋がごみの巣窟になってからでは遅い。まして掃除を他人の手に委ねるなど不道徳極まりなし。一、拡張機能のマクロを切り過ぎない。ディレクティブはコードの可読性を著しく低下させるので、必要最小限に留めるべき。一、書式を統一する。一貫性のない表現は理解もしづらく検索もしにくい。一、コードは心をこめて、丁寧に書くこと。
pass:
Draft