リーダブルコード勉強メモ


Work in Progress

はじめに

1章

メモ割愛

1部

2章

  • ループイテレータに明確なインデックスネームを。ci.ui.mi
  • 単位を使う変数には単位
  • 名前のフォーマット idの区切り…アンスコ classの区切り…ハイフン
  • 明確な単語
  • 汎用名避ける
  • 具体的な名前
  • 変数名に情報
  • スコープに応じ、変数の長さ
  • 大文字、アンスコに意味

3章

  • 誤解されない名前 filter length limit
  • max_ min_ などで限界値
  • 包含的 first last かつ排他ならbegin end
  • ブール is has

4章

  • シルエット、列、意味のある順番
  • 論理的な段落を空行を用いる

5章

  • TODO:,FIXME:既知の不具合,HACK:妥協
  • コメントしないこと
    • コードからすぐわかること
    • ひどいコードを補う
  • 監督コメント、定数の背景
  • 読み手の立場

6章

  • 代名詞を避ける
  • 実例をコメント
  • わからない引数にはインライン
  • 簡潔に