良い名前へのステップ
名前付けは対象への理解度と関係が深い。
自分たちが名前をつけようとするとき、対象をどのように・どれほど理解しているかが名前に反映される。
従って理解が深まると概念の名前も変わる。
「名前付けの7段階」をアーキテクチャに適用したものを示す。
例は「Webサービスからデータを取得して変換する責務」を持つ一連の要素のステージに応じた名前付け例。
table:アーキテクチャにおける名前付けの7段階
ステージ 説明 例
1:名無し 概念に名前がついていない。概念を抽出するだけの理解に至っていない。 (何かをするもの)
2:無意味 関連する要素がうっすら分かり、その集合に意味のない名前をつけている状態。 Cranberry Module
3:的確 要素の責務の一部を表している状態 Job Starter Process
4:的確で完全 要素の責務の全てを表している状態 Data Fetcher, Checker, Transformer, Job Starter
5:適切な行い アーキテクチャ上の要素の役割が確立し、責務を強化する意識が反映されている状態 Data Transform Job Runner
6:意図 要素の責務に加えて目的を表す命名。要素の存在理由を理解している必要がある。 Data Preparer
7:ドメイン抽象 個々の要素ではなく新しい抽象概念を示す命名。新たなメタモデルが生まれる。 Data Prepare Agent
言及先:
https://arlobelshee.com/good-naming-is-a-process-not-a-single-step/
https://www.digdeeproots.com/articles/on/naming-process/