名付けできない画面を作ってはならない - 名前を付けるとは何か

名付けできない画面を
作ってはならない
~ 名前を付けるとは何か ~
by chatii
at PHPerKaigi 2023 day0
2023-03-23 17:40

View Slide

自己紹介
ちゃちい (Twitter: @chatii)
合同会社inbaa 代表社員
PHPerRoom 主宰
妻・息子・娘 +
ウマ娘のトレーナー
トレーナーID: 890 570 082
PHPerKaigi のファン
名付けできない画面を作ってはならない ~ 名前を付けるとは何か
by chatii at PHPerKaigi 2023 day0

View Slide

PHPerKaigi 2023
楽しんでますか！？

View Slide

day0 なので(?)
ゆるふわなトークでいきます
(まじめなトークは他の方に委ねます)

View Slide

話すこと
なぜ名付けが
できない・されない？
愛とは
名付けされないことの問題
名付けされることの例
開発者の行う名付け
話さないこと
命名規則やプラクティス
設計の話
PHPの話

View Slide

名付けできない画面と
名付けされない画面

View Slide

「(業務|プライベート)の開発
で、名付けが(できない|されな
い)画面に直面したことがある」
(・ω・)ノ

View Slide

なぜ名付け(でき|され)ないのか？
1. ドメイン知識が足りていない
2. 誰も「キメ」ようとしない
3. 愛が足りない

View Slide

愛とは
愛情 ≠ 愛着
作ろうとしているモノへの愛着がある
一緒に作っているメンバーへの愛着がある
会社への愛着がある、
顧客への愛着がある、
業界への愛着がある…

View Slide

愛着とは
心理学ではアタッチメント
子供の社会的・精神的発達のために
養育者と親密な関係を維持する
心理学に詳しいわけではないですが…
子の親として、何かを「つくる」こととの共通点を見つけた

View Slide

親として子に
作り手としてプロダクトに
名前を付ける

View Slide

名付けできない画面
名付けできない
いい名前を付けようとめっちゃ悩む
愛あるね
名付けされない
誰も名前を付けようとしないのである！！
無関心

View Slide

指示ができない・されない
人によって呼び方が違ったりする
タスクが後回しにされる
何ができる画面なのかわからない
これは名付けされない理由でもある

View Slide

名付けされないことによる軋轢
「名も無き家事」をご存知ですか
「名もなき家事」ランキング｜ダイワハウス
1. 裏返しに脱いだ衣類・丸まったままの靴下をひっくり返す
作業
2. 玄関で脱ぎっぱなしの靴の片づけ・下駄箱へ入れる/靴を
揃える
3. トイレットペーパーの補充・交換
(…それはもはやそういう名前のメソッドでは？)

View Slide

名付けから始まる物語
名前があることで、ストーリーが紡がれる
メイ「あなたはだあれ？」
「あなたトトロっていうのね？」
→「トトロいたんだよ」
さつき（トトロ…）
タツオ（トトロか…）
塚森の中にはいる何かは「トトロ」
家族に何があったかを正確に伝えようとする姿勢

View Slide

どこかで聞いたことがある問題だ…
名前を付けて認識を共有する、名前が無いと辛い
「それって “ユビキタス言語” じゃないですか」
「そうです」
ドメイン駆動設計で言われる、
みんなが同じ言葉で意思を疎通しようというもの
ドメイン駆動設計を引くまでもなく大切なこと

View Slide

DDD/ユビキタス言語を説明せずとも
名前を付ける必要性は理解できる(はず)
仕事は開発者だけでは進まない
名付けの大切さを他の職種の人にも伝える必要
でも難しいことじゃないはず
人に名前を付けるのと変わらないから

View Slide

適切な名前を付けなければならない
ディレクトリ/ファイル
クラス/メソッド
変数/定数
DBのテーブル/カラム

View Slide

適切な名前とは何か
どんな処理・作用かがわかる
"リーダブルコード" は必読
「名は体を表す」
「体」はプロダクトと共に進化
名前も進化していく

View Slide

進化する名前
テストをちゃんと書いておいて変更に強くする
リファクタリングを安心して行える環境作り
PhpStorm なら Shift + F7 (masOS) のリネームで利
用箇所の置換をしてくれる
ごく普通に行われるべき開発
良い環境で子供を育てたいのと似ている
便利な道具を使うことはズルでもなんでもない

View Slide

余談: 英語ツラい!!
開発者には英語力が求められる
名詞…？動詞…？
専門用語などは綴りがまったく
頭に馴染まない
PHPerKaigi 2022 で日本語
で開発する方法のパンフ記事を執
筆しました
最初は日本語で書いて後で翻
訳、リネームすればいいじゃん

View Slide

愛着を持つのはプロダクトであり
名前ではない
プロダクトを育てるために名付けを使う
人が名前を変えるのは大変だけど
コンピュータはいくらでも変えられる
(プロダクトの名前を変えるのは
また別のお話…ブランディングとか…)

View Slide

まとめ
「名付ける」とはどういうことか
愛着を持つため
名前を変えやすい開発をする
名付け以外にも愛着を持つ方法はあるはず

View Slide

オマケ1: 大事だから不適切な名前をつける
バッドノウハウです

View Slide

人間、読みやすい言葉だと理解した気になる
(
プロダクト名)-db-dev と名付けていた
AWS CDK(IaC) で作ったインスタンスを手動で変更され
た
ランダム名なら怖くていじられないのでは？
CDKは名前を指定しないと自動生成される
HogeHogeStack-FugaFu-1GCRM1B8RACQ3 みたいな

View Slide

自動生成される名前を通り名とし
本来付けるべき名前を真名とする
(こんな方法とるべきじゃない…)

View Slide

オマケ2: こんな名付けの経験は
ホスト名が
東方の三賢者 (MAGI的な意味で)
太陽系惑星 (ムーンプリズムパワー的な意味で)
ツール名が
○○する君
携帯動画変換君、懐かしい
昔話あったらコメント OR ツイートしてください！
ニヤニヤしたいです

View Slide

名付けできない画面を作ってはならない - 名前を付けるとは何か

名付けできない画面を作ってはならない - 名前を付けるとは何か

chatii

More Decks by chatii

Other Decks in Programming

Featured

Transcript