# ミノ駆動本_読書py[5] みんなのメモ

###### tags: `ミノ駆動本`

- このメモはWebに公開されています（HackMDチーム）
- リンクを知っている人は見られます
- HackMDにログインして編集できます

## お願い事項

https://twitter.com/MinoDriven/status/1541334416622256130

> 【お願い】
拙著『良いコード／悪いコードで学ぶ設計入門』に関する情報発信について。
ブログ等で発信の際は、引用の範囲を超え、著作権侵害となる場合は勿論のこと、拙著の詳細内容が分かるような表現での公開はお控え頂けると助かります。
ご感想や拙著に基づく試行錯誤は歓迎です。 #ミノ駆動本

> 拙著引用の際は、Qiitaさんの『著作物を引用する際の注意点』が参考になります。適切な引用のもと、情報発信していただけると嬉しいです。https://help.qiita.com/ja/articles/about-copylight #ミノ駆動本

とのことなので勉強会そのもので詳細内容がわかるような記述はしないように気をつけていきましょう。

## このメモについて

このメモは ミノ駆動本_読書py[5] のメモです
https://connpass.com/event/256267/

読む範囲：10章

ミノ駆動本のサポートページより、Javaのサンプルコードが見られます。
https://gihyo.jp/book/2022/978-4-297-12783-1/support

## 読書会の流れ

* 19:30〜20:00 **自由参加**のもくもく会（個人作業）
- 事前に読む時間がとれなかった方はここで読んじゃいましょう（ざっとで大丈夫です）
- 合わせて、この**HackMD**に話したいことを各自書いてください
- ログインすれば書ける設定にしています
- ここがわからん、ここはわかった　お気軽に書き込んでみてください
- HackMDの書き込みに投票し、みんなが気になるところをわいわい読み解いていきます
* 20:00〜21:30 読書会本編（みんなでわいわい）
* Discordでスライド共有して別途案内します
* 20時開始の本編では、「わたしこれ気になる！」という話題に `:+1:` と書いて投票します。
* :+1: する上限はありません。気になる話題に全部 :+1: しちゃいましょう。ただし1つの話題には1個だけ:+1:でお願いします
* 票数が多い話題から話していきます。

## 以下、もくもく会ワークゾーン

### 感想、気付き

-
-

以下は各節で「これってどういうことなんだろう」「ここからこういう気付きがあった」などを書き出すゾーンです。

### 10章名前設計 ―あるべき構造を見破る名前―

#### 10.4 意図がわからない名前

- 第1回のメモの内容を思い出しました
- https://hackmd.io/dET2dZ3CQD21jO-fRlNyMg
- リスト10.8のメソッドはやっちゃいそうな気もした・・・
- ドメインのこと、中身のことをちゃんと理解するのが大事だなと思いました。
> 何を意図しているのかがメソッド名から伝わってきません。実現したい目的の理解が不十分だと、この手の名前になりがちです。
> 意図、目的がわかるよう命名しましょう。

良いコード/悪いコードで学ぶ設計入門ー保守しやすい 成長し続けるコードの書き方 初版 仙塲 大也著 P225 より

- 必要最低限のことを実施する、というのは大事だなと改めて思った :+1:
- 感想として、プログラムは動作することでビジネス価値を産むが、同時に開発者どうしのコミュニケーションのツールでもあるという二面性があり、だから、動いてOKではなく、目的や意図を伝える必要があるのかなと思いました:+1::+1:
- 驚き最小の原則、『リーダブルコード』にも 3.7ユーザの期待に合わせる
- IDEでのrename、便利ですね（VSCodeでRename symbol）:+1::+1:

#### 10.5 構造を大きく歪ませてしまう名前

- DTO、自分の中でまだ理解がちゃんとできていないけど参照だけのものなんですね
- ✍️参照系だけならDTO（データクラス）を使える
- https://martinfowler.com/eaaCatalog/dataTransferObject.html :+1:
- マーチンファウラーのブログを発見
- より具体的な、中身がわかる名前をつけないと、と思うけど、いざ名前をつけようと思うとそれもちょっと難しかったりする
- とはいえ、それってトレーニングが必要なものなんだと思うし、コツコツと名前づけのコツを学べば良い気がしてきた
- クソコード動画「Managerクラス」にはナナPayモジュールがあったので懐かしくなった・・・
- Manager、Controllerは使ってしまうしダメなことは分かったのですが、個別のHitPointクラス、たちをまとめるのはどうやって書けば良いのか悩みます。:+1: :+1:
- ミノ駆動本のおかげでManagerクラスみたいになっている悪しき構造に来づけるようになりました
- コマンドのエントリポイントのクラスが巨大化していた（めっちゃ伸びしろがあることに気づいた）
- リアルワールドの巨大なManagerクラスにはテストがなく（レガシーコード）、フェザーズさんの『レガシーコード改善ガイド』のお世話になったりするんだろうな・・・
- スプラウトクラスとか
- 連番命名はUncle Bob『Clean Code』でもNGな例として挙がっていますね:+1:

#### 10.6 名前的に居場所が不自然なメソッド

- 関心事が異なるメソッド、なるほど
- 具体的に名前を表そうとしちゃって長くなるのはありそうだなと思っており、（是非は別として）ふむふむという感じ
- 動詞１語で、は標語として脳に刻んでおきたい:+1: :+1:

#### 10.7 名前の省略

- みんなが伝わるものなら、省略はしても良いかなと最近思い始めています :+1: :+1:
- （その代わり、何かわかるようにどこかに説明は必要とも思う）
- 名前は省略しないは『リーダブルコード』にも 2.5 名前の長さを決める
-

- クソコード動画Managerクラス解説スライド鑑賞したい方、集まれ〜！！:+1::+1:
- https://pt.slideshare.net/MinoDriven/manager-160873159