あっ、これ「Joel on Software」でやったところだ！

by sawarabi

Slide 1

Slide 1 text

あっ、これ「Joel on Software」でやったところだ！おすすめの技術書 LT会 - vol.2 2021/08/19

Slide 2

Slide 2 text

自己紹介名前：さわらび Twitter：@TSawarabi（質問などお気軽に！）職業：エンジニア（TL~PL、2～10人ほど）最近読んだ本：エンジニアのためのマネジメントキャリアパス最近見た映画：エヴァンゲリオン（序、破、Ｑ、シン）最近ハマってるもの：アマプラのパーティ機能で映画鑑賞、おねがい朝倉さん

Slide 3

Slide 3 text

自己紹介（ストレングスファインダー）ギャラップ認定ストレングスコーチ Top10の内訳 ● 戦略的思考力：5個 ● 影響力：3個 ● 人間関係構築力：2個実行力どこいった・・・(´・ω・｀) （実行力：実行したい、完遂したい、という資質群）エニアグラムは Type 8w7（独立した人）

Slide 4

Slide 4 text

悩んでいた…

Slide 5

Slide 5 text

酒と食に溺れるくらい悩んでいた…

Slide 6

Slide 6 text

悩んでいたことベトナムとの仕様のやり取り - 言葉の違い - 文化の違い - 時間の違い（時差） - 場所の違い

Slide 7

Slide 7 text

そこに現れた Joel on Software

Slide 8

Slide 8 text

やさしい機能仕様：目次 - パート１：なぜわざわざ書く必要があるのか - パート２：仕様書とはどんなものか - パート３：だけど……どうやって書くの？ - パート４：ヒント（45あるTipsの1つ）

Slide 9

Slide 9 text

やさしい機能仕様：概要 - 機能仕様（ユーザの観点から製品がどのように動くか） - 注意書き - 作成者 - シナリオ - 対象外 - 概要 - 詳細、詳細、詳細 - 未解決の問題 - ノート - 技術仕様（プログラムの内部の実装について記述する）

Slide 10

Slide 10 text

やさしい機能仕様：シナリオマイクは多忙な経営者である。彼は大企業の社長であり、その会社では全国チェーン店で販売されているダイナマイトを使った子供向け製品を… 原因はマイクが今が何時何分なのか分からないことにある。そこでマイクは、秘書の薦めに従ってWhatTimeIsIt.comに入会した。今や彼は、時刻が知りたいときにはいつでも、WhatTimeIsIt.comにログオンしてユーザ名とパスワードを入力するだけで現在時刻を知ることができる。… 4:45にもなると、「再読込」ボタンを繰り返し押し続けているというのが常だ。（Joel on Software P60, 61 から引用）

Slide 11

Slide 11 text

機能仕様 1. Background（背景） 2. Purpose（目的） 3. Scope（範囲） 4. Out of scope（範囲外） 5. AsIs（現状） 6. ToBe（ゴール）やさしい機能仕様、を元に作ってみた

Slide 12

Slide 12 text

やさしい機能仕様、を元に作ってみた技術仕様 1. Process ﬂow（処理フロー） 2. Data deﬁnition, relate DB（DB周り） 3. Validation（バリデーション） 4. Error case（エラー） 5. 他に何か必要があれば、適宜（詳細は https://tech.sawa-lab.net/archives/305 ）

Slide 13

Slide 13 text

結果は大成功！

Slide 14

Slide 14 text

Joel on Software ってどんな本？ - システム開発にまつわるTips集 - Joel のブログが元ネタ - 今回紹介したのは「やさしい機能仕様 part 1-4」 - 他にも面白いTipsが盛りだくさん「射撃しつつ前進」「ビックマック対裸のシェフ」「下っ端でも何かを成し遂げる方法」「Microsoft はいかにしてAPI戦争に負けたか」「すべてのソフトウェア開発者が絶対確実に知っていなければならない Unicodeとキャラクタセットに関する最低限のこと（言い訳なし！）」

Slide 15

Slide 15 text

結論たった1つ（正確には4つだけど）の Tipsだけでもこれだけ役に立つじゃあそのTipsが45個もあったら…？