石川宗寿のレビュー一覧

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

ちょうどチームで悩んでいたことに対するアンサーがたくさんあり、今後の改善につながります。

割とぶつかる問題が多くあり、エンジニアなら書かれている内容を理解し、自らのコードの書き方を振り返るいい機会になると思います。

今後、エンジニアに読んで欲しい本にも入って欲しい内容です！

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

コード例を示しながら読みやすいコードについて具体的に書かれている。
また、本書の良いところは、デメテルの法則や結合度の低減など、一般的に良いとされるプラクティスも盲目的に適用すれば保守性が落ちる事を事例を通して示しているところ。

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

多くの内容がすでに知っていたり、実践していたりすることではあったけれど、意識したことがなかったり、やったことない内容も書かれていており、機会があれば実践してみたい。仮引数名や関数名はどこから呼ばれたかではなく何をするかで名付けるとか、for文のネストを関数として抽出するとか。『リーダブルコード』とか『プリンシプル オブ プログラミング』よりはあとに読むと良さそう。

エンジニアチームの生産性の高め方 ～開発効率を向上させて、人を育てる仕組みを作る

エンジニアチームの生産性の高め方

- 構成がよかった。最後のトピックは「開発生産性」についてで、これまで語られたプロダクト開発、チーム開発のフレームワークやプロセス、手段を包括する上位概念が提示され、SPACEフレームワークのところはこれまでの点がつながるような感覚だった

- 設計→実装のプロセスとウォーターフォール、アジャイルの肝要に触れることができた

- 最先端のWebエンジニア組織哲学のエピソードを触れることができた

- PdMというよりはプロダクト・SRE・インフラエンジニアにとって必要な知識が書かれている

＜ポイント＞

- チームとして設計→実装をいかにスムーズに進めるか
- 開発者にとって必要なドキュメントとは何か
- 設計ドキュメントをライブドキュメントにするためにはどんな開発プロセスであるべきか


＜理解が浅いところ＞

- Stacked Diffs
- PRD⇔Design Doc⇔実装の具体
- イネーブルメントチームの運用

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

中級レベル向けの一冊であると感じた
原則や概念の名前について説明はあるものの、初学者には理解に一苦労するかなと思う

ただ、非常に実践的な内容であることは間違いなく、コードの例もわかりやすい

自分にとっては命名やレビューで身に覚えのあるアンチパターンがあったので、繰り返し本書を振り返りながら改善していきたいと感じた

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

「~でしょう。」で終わる書き方が多すぎて嫌だった。言い切ってくれればいいのになと思って、気になってしょうがない。
「・」の使い方も気になった。並列表記として使ってるのだと思うけど、一続きの単語に一瞬見えてしまってすぐに理解できずにストレス。「・」は外国の人の名前だと一つの名前のために使われるので紛らわしい。
こういった技術本の常だけどコード例と言及している文が離れていることが多くてページをめくり直すことが多くてストレスになる。
だけど、内容は良い。リーダブルコードと合わせて書き方の2大参考本としてこれからの開発者の指針になる。

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

良いこともたくさん書いてあるんだが、Kotlinがベースということもあり、Kotlinならそうだね、という箇所などあり、SwiftかKotlinを含む複数の言語を触っている前提かなと思い、人を選ぶ感覚はある。
!isDisabledとかナントカflagとか、実装を日本語に翻訳しただけのコメントとかはそうそうこれという感じ（みんな結構これやる）。
ListenerEventMessageClickViewTextなどの例示はあーまさにこれこれという内容が多く、経験値からは納得感は高い。

読みやすいコードのガイドライン -持続可能なソフトウェア開発のために

LINE株式会社でAndroidアプリの開発に従事しながら全社レベルでのソースコード可読性向上に取り組んできた著者による一冊。焦点は「読みやすさ」に絞られており、また企業の開発現場でやるべきことを書いてくれている（＝机上の理想論で終わっていない）のが嬉しい。ところで、本書が良書であることは大前提とした上で、この手の「良いソースコード」に関する書籍や記事が昔から定期的に刊行される背景は何なのだろう？とふと考える。システムの設計・技術選定であれば仮想サーバからコンテナ、パプリッククラウドなど日進月歩で10年前の設計思想が現在には通用しないということはあるように思われる。ただ、プログラミング言語とその書き方って（もちろん同じ言語でもバージョンアップを繰り返して機能追加は行なわれているが）そんな革命的にひっくり返ることは無さそうな気も。まぁでも命名の話は20年以上前から広く言われてる一方で例えばDIはそれに比べれば確かに新しい概念ではあるか。この本の内容がいつかの未来に古くなるということはあるのだろうか？