2025-01-12

自分で自分の基準点を設定する

新社会人みたいな人にアドバイスを求められたら毎回同じことを言っているけど、だいたいこんな感じ

食事・運動・睡眠は最優先にする
ロールモデルは立場が近い人を複数設定する
趣味など常時関心が持てるものを用意する
— magnoliak🍧 (@magnolia_k_) January 12, 2025

これは突き詰めると、自分なりの基準点を設定しましょう、という話で

食事・運動・睡眠は、言うまでもなく...

立場が近い人をロールモデルにするのは、割とすぐに「自分は同じ振るまいができているか？」というのを振り返られるから、というのもあるし、かつそれが「複数」必要なのは過度に比較し過ぎて”逃げ場”が無くならないように。

10年後に振り返るより、1年くらいの間に振り返って「同じことができているかな？」と比較できるといいし、世の中完全な人は居ないし、どんなに凄い人でも自分が完コピする必要もないし。

関心があることを常時持つのは、それが「関心が持てなくなったときに立ち止まれるから」...「あんなに熱心にやってたことに、集中できなくなった」というのは分かりやすい黄色信号だからねって。

ほかにももっといっぱい言いたくなるけど、そんなにたくさん一度に言っても覚えられないので、まずはこの3つだけ

2025-01-09

自分では自分を計れない

自分は柔軟に、抽象的に思考できる方だと思っていたけど、自分が詳しい設計を見直す必要があるときに、驚くくらい既存のアーキテクチャや、実装に縛られて思考していることに気付いたことが有って、人は簡単にバイアスから逃れられないんだなぁと思った、マル https://t.co/zReu5njYZs
— magnoliak🍧 (@magnolia_k_) January 6, 2025

「自分が一番詳しい」という状態をまずは目指すべきだと思うけど、そこからどうやって離れるか？みたいなところはあるよなー
— magnoliak🍧 (@magnolia_k_) January 6, 2025

対象に近づき過ぎると、俯瞰的にものごとが見れなくなってしまう、詳しいという自負が目を曇らせてしまう...

自分が分かる範囲で理解しているだけで、本当に必要な見方ができていない、分かるべきことが分かっていない、ということが有るよなー、でもそんなに簡単には変えられないよなー、分からないよなーということなので、色々な価値観や経験の人の話を聞くのが大事なんじゃないかなと思った

2025-01-03

『改訂新版　良いコード／悪いコードで学ぶ設計入門 ―保守しやすい　成長し続けるコードの書き方』で学ぶコードの”価値観”

改訂新版　良いコード／悪いコードで学ぶ設計入門 ―保守しやすい　成長し続けるコードの書き方

作者:仙塲大也
技術評論社

Amazon

本書の冒頭に悪いコードの例として「連番命名」という、メソッド名を単なる連番で命名する手法が出てくる。メソッドの目的や振る舞いと関係なく、単に「method001、method002、method003...」と連番で名前を付ける手法のことを指す。

環境上の制約でこのような命名をしている場所でも、意外と中に居る人たちは環境に最適化され会話は案外成立しているものだったりする。

それに「命名の妥当性」で設計内容がレビュアーや、発注者からリジェクトされるリスクを負うより、単なる連番にしてしまう方が合理的な場合もあるのだろう。

ミノ駆動さん（仙場大也さん）著の『良いコード／悪いコードで学ぶ設計入門』が早くも改訂され『改訂新版　良いコード／悪いコードで学ぶ設計入門 ―保守しやすい　成長し続けるコードの書き方』として出版されたので早速注文し、お正月のまとまった時間の間に読み終わった。

設計に関する本なので、わずか数年のうちに設計パラダイムの大きな変化や、特定言語機能やライブラリの大きな変化が有った訳ではなく、説明の仕方や、特に注力して説明する内容が変わった点が改版の中心となっている。この辺りは筆者自らの解説記事に詳しい。

gihyo.jp

一通り読んだ感想として、個人的にこの本で一番気に入ってるのは、第11章「名前設計ーあるべき構造を見破る名前」で、「どうすれば良い名前になるのか」「こんな名前の付け方になっていると危ない」という事例が数多く収録されている。

正しいコードであるために適切な名前をつけよう...これは非常に大事な考え方の一方で、既存のコードベースがそれなりの規模で存在すると必ずしも「正しいからとってできるわけではない」状況に遭遇することもある。

冒頭に出てきた「連番命名」が適用されているプロジェクトだって、中の人はずっとその状況を変えたいのかもしれない...だけど、変えるよりも現状のまま維持した方が、（その場における）生産性はそれなりにキープできる、ということが判断されているのかもしれない。

だからこそ「何が良いコードなのか」ということを理解しておいて、それとの差異を把握することが大事なんだと思う。人は、「現状を正しい」と思いたい正常性バイアスに囚われているものだけど、それを打ち破るには違う価値観を学習するしかない。

いきなり全部は変えられないし、命名規則を変えたからといって突然明日からの生産性が上がる訳でもない。

でも知っておくことで、それを選択すべきときに「選べる」というのは大きな違いだったりする。

そういう知見がたくさん詰まっているので、全部一気に読み込む必要はないし、全部を頭から信じる必要もないし、全部を教条的に明日から適用する必要もないけど、自分のデッキの中のカードを増やすつもりで読むといいな、と思います。

聴いた話が100％役に立つなんてことはまず無いんだけど、逆に何が未来で役に立つか予想ができないからこそ、色んな場所へ行って、色んな人の話を聞くんだよ
— magnoliak🍧 (@magnolia_k_) January 3, 2025

読書は宝探しだという話を聞いたことがある。読んだ本の内、どれが宝になるかは分からない。でもある日突然宝として光りだす日が来る。だからたゆまず読書し続けていくことが大事。
イベントでいろんな話を聴くのも同様。 https://t.co/XnZJGopMm9
— ミノ駆動 (@MinoDriven) January 3, 2025

で、という話は、この本の中にも出てくる...第16章の「理想系を知ってはじめて課題を知覚できる」を参照のこと

あと、一方で「悪いコード」ちょっと言葉が強いので誤解を生みやすいかな、とも思った。

実際には分かりやすく「悪い人」が居て、意図的に生産性の低いコードを入れていくわけではなく（そりゃ業務妨害だ...）、さまざまな制約の積み重ねを途中で補正しないまま放置されることで結果的に「後世の人にとって都合の悪いコード」ができあがってしまうわけで、「罪を憎んで人を憎まず」という言葉がありますが、「悪いコードを憎んで人を憎まず」という姿勢が大事だよな、とも思いました。

（なので、皆さん、あまり職場や、OSSコミュニティなど、他者との対話において「これは悪いコードだ！」という言い方はやらないようにしましょうね...無用な軋轢を生んでしまう時があります）

というわけで、改訂版も代わらずお勧めの1冊なので、皆さん買いましょう、読みましょう

そしてレビューのときに「この本に書かれている、こんなやり方もあるよー考えてみてねー」とさらっと言ってあげましょう！

命名は大事だよなー、と思いながらポストしたら、思いの外反響が有ったので、リンクを張っておきます。引用とか、リプライでの意見も興味深いですね。

プログラミングで命名が大事、という話、人に説明する上では「後の人が困るでしょ？」という説明になるんだけど、「名前が適切に付けられない時点で設計できていない」とか、「名前がちゃんと付けられた瞬間、どんなコードを書くべきか整理される」みたいな感覚が身に付いているかどうかだけど、でも説…
— magnoliak🍧 (@magnolia_k_) January 4, 2025

一方で、命名で衝突が起きてなかなか決まらない、みたいな事態が発生したら、「それはいくらなんでも自転車小屋議論じゃね？」と言って、さっさと先に進めようとしてしまうかもしれない
シチュエーションや、立場によって何を優先させるかは替わってくるわけで
優先度ってやつはあるよね https://t.co/01E2DZTKkL
— magnoliak🍧 (@magnolia_k_) January 4, 2025

2024-12-31

2024/7/13 大吉祥寺.pm開催の記録／気持ち／今後に向けて

今年2024年最大の活動成果と言えば、長年続けてきた吉祥寺.pmの拡大版「大吉祥寺.pm」を7月13日に開催できたこと以外に考えられないです

kichijojipm.connpass.com

最初に結論

とにかく色々な人に支えられて最高のイベントができた
開催場所、日程しか分からない段階で200人以上の人が参加に申し込んでくれた謎の熱量に圧倒された
特に「いろいろな言語界隈がクロスしたのが良かった」と感想を随所で言ってもらったのは嬉しかった
結果的に自分のコミュニティ人脈、イベント運営ノウハウの総決算と言えるイベントになった
吉祥寺.pmは2025年も続きます

準備は足掛け半年、当日は前夜祭から始まり本編、懇親会、二次会と駆け抜けて余り記憶が無いのですが、とにかく事故もなく、無事に全部終わってなによりでした

あとは、各要素についての振り返り

企画の立ち上げ

2023年末の吉祥寺.pm35のオープニング直前にふと思い付いてスライドに入れた
しかし、12月〜2月まで会場のアテが無く、開催できるか分からなかった
2月に突然埋まっていたはずの日程（7月13日（土））が終日空いていることを発見する

その時の興奮を示すポスト

あ！武蔵野公会堂のホールが終日空いている日がある！！開催費用、賄えるか分からないし、他と被るかもしれないけど、取っちゃえばいい？？？ https://t.co/Ujxo830Ss9
— magnoliak🍧 (@magnolia_k_) February 13, 2024

よやくしちゃった...
— magnoliak🍧 (@magnolia_k_) February 13, 2024

コアスタッフ&当日スタッフ＆カメラマン集結

これまで吉祥寺.pmは、運営である「自分一人ができる範囲でやる」をコンセプトに開催されてきた

しかし、ホール開催ではどんなに頑張っても一人では回らない...

そこで企画の推進にあたっては、コアスタッフを募集しました

まずここでイベント運営に長けた方々が次々に協力を申し出て頂きました

kichijojipm.hatenablog.com

企画が独りよがりにならず、ちゃんと進められたのはコアスタッフの数々のアイディアと意見のおかでした

また、当日の運営に向けて「当日運営スタッフ」「カメラマン」も協力の申し出があり、十分な運営人数で当日を進めることができました

正直、「自分が企画するイベントにここまでの熱量をもって協力を申し出てくる人がこんなに集まった」という事実だけで大吉祥寺.pmを企画した意味は既に8割くらい回収されていますね

本当にコミュニティの方々には感謝しかないし、この恩は最高のイベントを無事に完遂する、という形で一つ返したものの、まだまだ返し切れないな、と思っています

ノベルティ、ポスターなど

ノベルティ、ポスターなどの制作物については、既にまとめブログが有りますので、そちらをご覧ください

最初に結論

企画の立ち上げ

コアスタッフ&当日スタッフ＆カメラマン集結

ノベルティ、ポスターなど

スポンサー

カンパ

前夜祭、懇親会、非公式二次会、リジェクトコン

動画公開

参加感想ブログなど

おわりに

3/15 Ya8 2024 - ヤパチー 令和六年最新版(仮)

3/24 Object-Oriented Conference 2024

4/13 PHPカンファレンス小田原

4/15 エンジニア基礎 - 話題の新卒向け研修実演

5/12 第十回技術書同人誌博覧会

5/28 『データモデリングでドメインを駆動する』読書感想会

6/14 設計ナイト2024

7/13 大吉祥寺.pm

9/6 Scalaわいわい勉強会 #3【東京】

10/5 YAPC::Hakodate 2024

10/26 秋の旬なアーキテクチャLT会

10/29 わたし史上、最高のチューニング

11/9 ◯沼袋.night

11/22 morisnite vol.5

11/30 紅白ぺぱ合戦

ポッドキャスト出演

データモデリングでドメインを駆動する ――分散／疎結合な基幹系システムに向けて

WEB+DB PRESS総集編［Vol.1～136］

SSL/TLS実践入門 ──Webの安全性を支える暗号化技術の設計思想

Rustの練習帳

ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法

アーキテクトの教科書 価値を生むソフトウェアのアーキテクチャ構築

めもりーちゃんのPHPでプログラミング入門

はじめてのPHP エンジニア入門編

3/15 Ya8 2024 - ヤパチー令和六年最新版(仮)

アーキテクトの教科書価値を生むソフトウェアのアーキテクチャ構築