iida 🍚 @iidaapp

話題になっていた「目標管理は（技術者には）クソ」のスライド面白かった speakerdeck.com/nay3/enisitetu… 個人的には「全体の合意を得る」意志決定から、「役割ごとに決定権を持って進める」意志決定に変えた (ただし決定の範囲・目的・方針 (制約・優先順位) をハッキリさせる) というのがなるほどだった

0 0 0 104 0

View Details

iwashi / Yoshimasa Iwase @iwashi86

2 years ago

.@ryuzee さん、オライリー・ジャパン様に『脳に収まるコードの書き方―複雑さを避け持続可能にするための経験則とテクニック』をご恵投いただきました！感謝！🙏 早速読んで、特に印象に残ったところをメモしておきます。（→は自分のコメント）・ソフトウェア開発においては、言われるような建築フェーズというものは存在しません。このことは、計画が役に立たないことを意味するわけではなく、家を建てるメタファーがどうにも役に立たないことを示しています。(P.5)　（→よく建築のメタファーが使われる業界なので、とてもわかる）・ウォーキングスケルトンとは、実際の機能として成立するいちばん薄い実装のことで、ビルド、デプロイして、エンドツーエンドのテストが行えます。後でもできますが、最初にデプロイパイプラインを確立することに価値があります。(P.16)　（→最初にデプロイパイプラリンの有用性は体感していたが、名前付けも覚えた）・そのため、警告にはゼロトレランスで望むべきです。警告が1つもない状態を保つのです。実際、警告はエラーとして扱うべきです。(P.20) （→共感しかない、自戒から）・たくさんのコードをすばやくと言うのは、あなたが読むことになるコードが増えることを意味します。たくさん作れば作るほど、たくさん読まなければいけなくなります。自動でのコード生成は事態を悪化させるだけです。(P.32) （→生成AIパワーで変わるかもしれないが、結局ソフトウェアエンジニアの判断がしばらく残るので、可読性は大事）・どんな馬鹿でもコンピューターが理解できるコードをかける。良いプログラマーは人間が理解できるコードを書く。(P.36) （→マーチン・ファウラー氏らしいコメント）・ドキュメントには、判断の結果よりも、なぜそう判断したかを記述すべきである。(P.47) （→これもとても同意するところ。Whyが消えると、将来の変更可否が判断しにくい）・メソッド名を隠してみるのは役に立つエクササイズです。あなたのコードを将来読む人と共感しやすくなるからです。思いついたメソッド名が十分にわかりやすいと思っても、違うコンテキストにいる人にとってはわかりにくいかもしれません。(P.127) （→全く考えたことがなかった視点。授業でも使おうと思った一節）・メソッド名で伝えられる事はコメントに書くな。型で伝えられることをメソッド名に書くな。(P.130) （→わかりやすい指針）・ペアプログラミングだけではコードの共同所有を達成できる保証は無い。ペアをローテーションして入れ替え、触るコードの場所を変えて、知識のサイロ化を確実に防がなければいけない。(P.149) （→ペアプロ経験から本当にこれもわかる）・コードレビューが答えるべきいちばん根本的な質問は、「自分はこれのメンテナンスを問題なく行えるか？」です。(P.153) （→これも本当にそう。読む回数の多いし、どれだけ簡単に修正できるかが大事）・私がラバーダックの代わりに使っているのは、Stack Overflow という Q&A サイトです。質問を準備していると、質問が完成する前に問題が何なのかに気づくことがよくあります。(P.186) （→ SO以外でも投稿中に気付く、というのはあるあるだ）・デンマーク語のソート順の問題には既に遭遇したことがあったので、問題を特定するのに1分もかかりませんでした。ソフトウェアエンジニアリングの技には、個人の経験にもとづく移ろいやすいものが残っているのです。(P.198) （→ ニッチなところでアートな技芸が残る）・コードを純粋関数で組み立てると、ログを出力すべきところは減ります。これは参照透明性が望ましい多くの理由のうちの1つであり、関数型コア・命令型シェルのアーキテクチャを支持すべき理由です。 [純粋でない操作を記録し、それ以上は記録しない。] 再現できないものは全てログに出力してください。現在の日時の取得、乱数の生成、ファイルやデータベースからの読み込みなど、決定論的でない高度は全てこれに含まれます。また副作用があるものもすべて含みます。それ以外はログに出力する必要はありません。(P.212) （→ このログの指針、めちゃくちゃ役立つのでは……この前後を読むだけも一冊の価値がありそう）ということで、素晴らしい本だったのでめちゃくちゃオススメ！