概要

という持論、「One-word Naming」の紹介です。

嬉しいこと

下記の3ステップで説明します。

「1語」の定義は、英語においてスペースで分割され得る要素だとします。¹

1語で、しかし内容が伝わる様に最善を尽くして命名します。

すると

を選ぶことになります。

例えば

は2語ですから、1語減らします。

はnameを修飾する語ですから

がより適切だと考えます。

「ユーザの名前」であり、「名前」ではありますが、「ユーザ」ではないのです。

他にも

それぞれどんな場面なら選択されそうな1語でしょうか？

常に適切な一語を探すことで、対象の本質を理解することに繋がると思います。

1語で十分に意味が通じるか？と考えます。

Yesなら1語で命名は完了とします。

Noの場合は言葉を増やす必要があります。

前項で、1語では不十分だった場合。

周辺を分割して、命名する対象を増やせないか検討します。
（すぐ名前を長くしたくなりますが、こらえます。）

ユーザ名の例を再び取り上げます。
nameでは読み手にとって不十分だとしましょう。

例えば、User型と、その属性²としてnameを定義することもできるはずです。

C

typedef struct { char name[30]; } user;

Ruby

class User
  attr_reader :name

  def initialize(name)
    @name = name
  end
end

Haskell

data User = User { name :: String}

分割することで、一度に考えるべきことを減らせます。
名前も短い方が理解するのは楽です。

もちろん、分割することが常に望ましい結果をもたらすとは限りません。
一般に、保守のしやすさだけがプログラムに求められる性質では無いからです。

しかし、分割は面倒で、それゆえ適切なタイミングを逃しやすいです。
コード量が増えていくほど、更に面倒になります。

ですので、命名の度に分割の可能性を検討できることは
One-word Namingの良さだと考えています。