初学者にもわかりやすい「名前」って何だろう ?

私たち (主語が大きい ! 笑) はエンジニアリング的な作業をするときに「名前」を考える機会が多いのではないでしょうか。ここで言う「名前」とは、コードを書いているときに考える「ファイル名」や「変数名」や「メソッド名」だったり、AWS を操作しているときに考える「Amazon EC2 インスタンス名 (正確には Name タグ)」や「AWS Lambda 関数名」や「Amazon S3 バケット名」などです。

皆さんはどんな「名前」を付けますか ?

皆さんは以下に載せたような一時的な名前を見たことがありますか ? もしくは使ったことがありますか ? 私はあります !

必ずしも「良し悪し」を決めたいわけではないのですが、例えば「数日後」や「数ヶ月後」に見直してみると「えーっと ? これは何だっけ ?」と思い出せなくなってしまったり、いざ消そうと思ったときも「名前的に消しても良さそうだけど確信が持てないぞ ?」と困ってしまったりするかもしれません。

• test, test1, test2, test3
• hello, hello1, hello2, hello3
• foo, bar, baz (メタ構文変数 : 英語圏など)
• hoge, fuga, piyo (メタ構文変数 : 日本)
• toto, titi, tutu (メタ構文変数 : ヨーロッパ圏など)
• a, b, c
• aaaaa, ooooo, tttttttttt

先ほど紹介した「あるあるな名前たち」ですが、自分 1 人で使うならまだしも、例えば「誰かに教える（伝える）場面」を考えると、より顕著にわかりにくくなることがあります。私自身の失敗談を紹介しましょう !

私は数年前まで 2 年間ほどプログラミング講師の仕事 (Ruby, Ruby on Rails, HTML, JavaScript, CSS, Git などなど) をしていました。講師経験が浅かったとき、プログラミング未経験のお客様に対して、無意識に「例えば hoge という変数に 10 と入れるとしましょう」のように「変数」や「メソッド」を教えてしまった経験があります。そのときに「あのー ! すみません ! 先生がおっしゃっている "ほげ" って何ですか ?」なんて言われたこともあり「あああ ! この教え方は良くないんだ !」と重要な気付きを得ることができました。他には「"ハローワールド" って何ですか ?」と言われたこともあります。

あくまで私の体験談ではありますが、特に初学者に対しては「わかりやすい = 簡単にイメージできる」ということが重要です。もし「変数」を教えるなら「箱」や「付箋」や「名札」を比喩にしても良いでしょうし (比喩の良し悪しは置いておいて)、英語に拒否反応が強ければ、変数名を hako や fusen や nafuda にしても良いかもしれません。もし小学生にプログラミングを教える場合は、より具体的で楽しい名前を考える必要があるでしょう。

さらに、先月書いた記事 ハンズオンの「腹落ち問題」を改善する 5 Tips にも関連付けてみましょう。例えば、皆さんがハンズオンを実施するときに「AWS Lambda 関数名 : get-photo-1」と「AWS Lambda 関数名 : get-photo-2」を作るように指示されていたりすると、具体的な役割をイメージしにくく、それこそ「腹落ち」しにくくなってしまったりもします。ハンズオンなどを作る側の立場においても「名前」は重要ですね !

最後におまけとして、builders.flash で「How to be a Developer」カテゴリーの記事を執筆している金澤さんと西村さんと一緒に「わかりにくい "かもしれない" 名前」と「わかりやすい "かもしれない" 名前」のサンプルを考えてみました !