nDiki : 仕様書

Joel on Software - 必読書

「スクラッチから書き直したくなるプログラマは、書き直したプログラムもまたスクラッチから書き直したくなる。」で参照したのがきっかけで、ジョエルテストで有名な Joel on Software を読んだ。

• Joen on Software

ソフトウェアプロジェクトマネージャー・ソフトウェア開発者必読書の1つだね。

扱っているテーマは幅広くどれも気になる記事ばかり。 ここではメモがてら興味深かった主要な記事をピックアップ。

3章 ジョエルテスト

3分でできるソフトウェアチームの良さを評価する有名なテスト。

5章 やさしい機能仕様 パート1: なぜわざわざ書く必要があるのか?

仕様書の最も重要な役割はプログラムをデザインすることだ。p.51

仕様書についての章が何章か続く。仕様書について実践的なことが書かれているのでとても参考になる。

6章 やさしい機能仕様 パート2: 仕様書とはどんなものか?

サンプル仕様書が用意されている。 何をどのように書くべきかについて参考になる。

8章 やさしい機能仕様 パート4: ヒント

そしてなぜ誰も読まないかといえば、仕様書があまりに退屈でつまらないからだ。p.79

これを読んでからできるだけ話を具体的に書くように心掛けている。 適当に外国人の名前をつけてシナリオを書くとなぜか皆喜んだ(同僚も外注も社長も)。

ルール5: テンプレートは有害である p.86

9章 やさしいソフトウェアスケジュール

ソフトウェアプロジェクトマネジメントでうまくいかない事が多い筆頭がスケジュール。

「そのコードのスケジュールを立てられるのは、それを書くプログラマだけ」「タスクの粒度を細かくすること (それによって、その機能をデザインすることを強いられる)」「スケジュールにデバッグ・結合・バッファ・休暇・祝日その他のことのための項目を入れる」「決してマネージャにプログラマの見積もりを減らさせない」

あたりが参考になる。なおこの記事は Web でアップデートされている。

12章 5つの世界

開発するソフトウェアの種類によって使える開発方法論が異なるのだから、自分のプロジェクトで適用できるかよく考えること。

14章 アーキテクチャ宇宙飛行士たちに脅かされるな

抽象化ばかり考えて意味のないところまでいかないこと。

21章 報奨金有害論

つい最近うちの会社でも表彰式があったばかりなんだけれども……。

マネージャは賞与の提案を上位に送り、それは完全に無視され、ほとんどランダムに賞与が支給される。p.188

多くの人は、自分が非常に良い仕事をしていると思っている (実際はそうでない場合でも)。p.189

23章 人のタスク切り替えは有害であると考えられる

一つのプロジェクトに専念したいね。

人々に同時に1つより多くの作業をさせるべきではない。p.202

24章 あなたが絶対すべきでないこと PART I

→ スクラッチから書き直したくなるプログラマは、書き直したプログラムもまたスクラッチから書き直したくなる。

25章 氷山の秘密、明らかに

顧客は自分が何が欲しいか分かっていない。顧客が自分で何が欲しいか分かっていると期待するのはやめることだ。p.210

これを理解していないと何でも言うなりにソフトウェア化しようとして失敗する。

31章 下っ端でも何かを成し遂げる方法

多くの人は自分が下っ端だと思ってモンモンとしている。

• 戦略1 実行あるのみ
• 戦略2 じわじわ広めていく
• 戦略3 優れた人間を作り出す
• 戦略4 間抜けを無力化する
• 戦略5 邪魔を避ける
• 戦略6 かげがえのない存在になる

まずは不満を持つだけでなくて、個人ででも実行しようということ。

[ 読書ノート ] [ お薦めの本 ] [ ソフトウェアプロジェクトマネジメント ] [ マネージャー ]

今日のさえずり - Twitter やってるとネットストーカーされている感じがしない?

2009年12月18日

• 09:50 FeedBurner の Twitter 投稿機能は2重投稿される場合があるな。フィードのアイテム更新してしまったかどうか記憶ないので今度チェックだな。
• 09:54 アキヨドにトランスフォーマー。 #Akihabara http://movapic.com/...
• 10:40 GetHashCode が return 1 とか極悪。 #csharp
• 12:34 ニコンFペーパークラフト。ちょっと高く感じるけど紙質とかどうなのかな。 http://bit.ly/4DoQvl
• 13:35 @3_DaiMe_Yoshi F オーナーですか、うらやましいです。自分の持っている一桁機種は Nikon F3/T です。F3 のペーパークラフトならもうちょっと魅かれたところです。
• 13:36 委任状作成に時間食われている。
• 14:21 @nyafuru 帰宅中って直帰?
• 14:24 おやつにはちょっと早いけれどナボナ。
• 18:11 勉強がてら欲しいというので仕様書の pLaTeX2e ソース送った。自作クラスファイル + nkf で mendex 辞書エンコーディング変換 + DocStrip で複数ドキュメント生成とかやっているいきなりガツンなやつだけど大丈夫かな(Makefile はつけてる)。
• 18:15 押忍。久しぶりの会社の飲み会参加っす。がんがん飲むっす(烏龍茶以外に素敵なメニューがありますように)。
• 18:35 七味や。 L:浅草橋
• 19:50 鍋食ってる。
• 19:59 .@nyafuru 超オタク疑惑。
• 20:28 目を閉じて。 http://movapic.com/...
• 21:20 「Twitter やってるとネットストーカーされている感じがしない?」って聞かれた。みんなどう?
• 21:21 飲み会終わったのでアイスクリーム食べたい。
• 21:27 @nyafuru 心は酔ってる。
• 21:31 tweet は自分でコントロールしてるから自分は気にならない。むしろ見て。 RT @Naney: 「Twitter やってるとネットストーカーされている感じがしない?」って聞かれた。
• 21:38 「昨日イトーヨーカドー行きましたよね?」キターって感じ。そこから話がはずむ。 RT @Naney: tweet は自分でコントロールしてるから自分は気にならない。むしろ見て。
• 21:39 オリオン座キレイ。
• 23:10 Twitter のパスワード変更した。これからケータイの MovaTwitter ブックマークかたっぱしから登録しなおす作業。
• 23:29 MovaTwitter 個別アクセス URL のブックマーク更新完了。一段落。
• 24:43 Windows 7 64ビット バージョンで動く Google 日本語入力リリースされているの気づいてなかった。まあもういっか。
• 24:54 歯磨いている最中に地震とかやめてほしい。

今日のさえずり - 許されるのは嘘ではなくドワーフのような沈黙

2010年02月23日

• 07:20 今年はちょっとなめていたが、花粉症が今朝次のレベルへ進んだようだ。
• 09:12 やっぱり昨日から辛くなり始めた人多いみたい。杉のヤツ、スイッチ入れたな。
• 09:24 Twitter やってると嘘をつきにくくなる。親戚の法事でも体調不良でも嘘をついたらしばらく tweet が制約されて息苦しくなる。
• 09:26 Twitter-ers に許されるのは嘘ではなくドワーフのような沈黙。
• 09:31 「制作準備中」と「デザイン製作中」の看板枠が並んでる。どたらがプロセス先行してる? L:新橋
• 09:38 いつもよりちょっと早く到着。 (@ 秋葉原駅 w/ 2 others) http://4sq.com/68fhHr
• 09:40 I'm at ヨドバシカメラマルチメディアＡｋｉｂａ (東京都千代田区神田花岡町１－１, Tokyo). http://4sq.com/77WGwe
• 09:49 I just became the mayor of 佐久間公園 on @foursquare! http://4sq.com/90yt4q
• 09:49 I just unlocked the "Super Mayor" badge on @foursquare! http://4sq.com/aDV9f2
• 12:05 今日はお弁当。 (@ 向日葵 和泉町店・カレー食堂) http://4sq.com/9oazrC
• 12:08 お弁当(昼食) 350円。向日葵。
• 12:14 毎年妙に早いので桜かどうか疑ってます。 RT @lrhv: うわ、これやっぱり桜だったんですか。RT: @Naney: 咲いてる。 http://movapic.com/...
• 12:34 @as_tone 両国の桜が11月に? きっとそれは造花。
• 12:37 foursquare からの Twitter チェックイン投稿、チェックインの際にオフにすることが多いのでデフォルトオフにした。Facebook の方も。
• 12:40 あれ、いつ Facebook に FriendFeed 連携するように設定しておいたんだっけ。
• 13:02 Facebook の掲示板から foursquare からの投稿で余分のものを削除。
• 13:49 第2弾! RT @SushiSaisho 皆様のご要望にお応えして「上限なし！あなたのフォロワ数を値引きします」を再び開催します。3月1日（月）18時から23時　詳しくは http://www.saisho.net/contents/ #sushisaisho #yokote
• 15:09 システム設計に関する issue tracking 用に影舞にプロジェクトを追加した。フィールドはテンプレートのものから、仕様書欄など適宜追加。
• 17:50 やっぱり腹減り。 (@ ファミリーマート 東神田二丁目店) http://4sq.com/aredqe
• 17:59 メープルカスタード(おやつ) 105円。ファミリーマート。
• 18:04 @nyafuru 片方はオフィスにいる。
• 18:08 カウンタで for ループを回すと罪悪感を感じる。 #cpp #cplusplus
• 19:23 ハートのプチプチ粒をきちんと飾っておいた @zakwa がハッピーになって、見つけて満足しただけの @as_tone はそれなりにという結論になった。
• 19:25 ハートのプチプチ粒。 http://bit.ly/92Tgje
• 19:39 @zakwa しばらく引き継がれて飾られてたんだけれど、今探したらあのハートのプチプチ粒見あたらない。
• 20:47 成城石井がやっている間に帰る。
• 21:00 I'm at ヨドバシカメラマルチメディアＡｋｉｂａ (東京都千代田区神田花岡町１－１, Tokyo). http://4sq.com/77WGwe
• 21:07 2月26日発売の SC-01B 触ってきた。キーボードの感触にイマイチ感があったのはモックだから? 画面はちょっと小さい印象。
• 21:20 foursquare するようになってから (nanoformats の) L: 使う機会が減ったなあ。foursquare も L: 書式選択できればいいのに。
• 21:35 日曜日に見てこれにしようと思った大粒と小粒ミックス(最近このタイプの少ない)の雛あられを買いに行ったら、最後の1つだった。ツイてる。
• 22:46 放置していた「なかのひと」外そうかなと思い、最後に見ておくかと、アクセス解析ページ開いてみたら興味深くてまた継続する気になったというオチ。 http://nakanohito.jp/
• 24:08 RT @k12u: 次の家を探して条件入れていたら一番上に自分の家が出てきて吹いた。契約更新。

今日のさえずり: 「仕様書の標準テンプレートを作りたいとう誘惑を避けること。」

2011年02月07日

• 09:33 foursquare 落ち気味か。1回 venue リストがとれたけどそれっきり。
• 09:33 ロケタッチの時代がきた?
• 11:54 「仕様書の標準テンプレートを作りたいとう誘惑を避けること。」Joel Spolsky, Joel on Software, p.86 http://amzn.to/bdPYfg
• 12:09 弁当 350円。 (@ 向日葵 和泉町店・カレー食堂) http://4sq.com/fpdSrn
• 13:09 くしゃみきた。キタキタ。多分今年初の花粉くしゃみ!
• 13:10 朝アレグラ飲み忘れてたので常備しておいたやつをゴクリ。
• 20:57 メモリ欲しいっていったらリモートデスクトップ使えって言われた。
• 21:11 とりあえず Debian GNU/Linux BOX の rdesktop で Windows 7 Professional にリモートデスクトップ接続してみた。あらあっさり。
• 21:37 ホームでの割り込まれっぷりがハンパない。
• 22:59 昼間にアップデートしたせいか、Debian GNU/Linux sid で KDE を起動すると画面が真っ黒になるようになってしまった。あら。
• 23:02 デスクトップ効果を無効にしたらとりあえず画面出た。
• 23:08 OpenGL だと駄目。XRender だと OK。Mesa のライブラリをアップデートしたからか?
• 24:35 しばらく放置していた AndFriends だが、やはり出来が悪いので退会。 @AndFriends_JP

• Joel on Software

今日のさえずり: 仕様書とプログラムの現況が異なる場合、現況を優先とします。

2011年03月22日

• 12:06 弁当 350円。 (@ 向日葵 和泉町店・カレー食堂) http://4sq.com/fjRCce
• 15:06 週次ミーティングで所属長がスルーするので、仕方なく自分で退職の宣言をしたった。普通何か言ってくれるよね?
• 15:29 缶コーヒー 100円。
• 15:30 @pureminami おお、そう思うことにします。
• 19:59 アトレもうちょっとガンバレ。
• 21:50 Facebook グループのメンバに管理人権限配った。
• 23:54 Facebook グループ作成者の自分が退会した時のために他の全員を管理人に追加したんだけど驚かせてしまったみたい。「管理人」って響きのせいかな。なると配りの気分だったんだけど。
• 24:14 MUJI.netメンバー登録したよ。

2011年03月23日

• 10:02 Mozilla Firefox, Portable Edition も RC が取れた 4.0 が出てる。
• 11:28 仕様書に「現況優先」と書きたい。「仕様書とプログラムの現況が異なる場合、現況を優先とします。」
• 11:33 RT @kansai_takako: 東電の電気使用状況を速攻でお知らせする「節電さん」作ったよ～ → @setsudensan ついでに API も公開しました http://t.co/2ufzjtd
• 12:08 ねぎ塩豚カルビ弁当 398円。 (@ セブン-イレブン 神田佐久間町店) http://4sq.com/dK34Ix
• 12:30 昨日の夜 LED ランタンとかチェックしていたんだけれど、単1形乾電池8本とか要求するのね。
• 15:46 スイートポテトバウム 158円。 (@ ファミリーマート 神田佐久間町店) http://4sq.com/gXIXda
• 19:56 ちょっとぐらい寄り道したかったけど 18:00 閉店。 (@ 無印良品 アキバ・トリム店) http://4sq.com/hCLi6y
• 20:05 RT @tokuhirom: 999 にでてくる、毎日地震がきてすべての家がつぶくれる町の話をおもいだした
• 20:37 帰り道、若めの夫婦が自動販売機でせっせとミネラルウォーター買ってた。乳児持ちなのかな。

今日のさえずり: 四谷大塚に「仕様書の読解力アップコース」とかあれば、小学生の時に受けたかった

2012年09月27日

• 09:53 今日は YAPC::Asia Tokyo 2012 #yapcasia 行きます。 (@ 株式会社ミクシィ (mixi, Inc.)) http://t.co/mwwTDXeY
• 10:02 四谷大塚に「仕様書の読解力アップコース」とかあれば、小学生の時に受けたかった。
• 14:19 オフィスから東京大学伊藤国際学術研究センターって赤坂見附乗り換えで OK?
• 14:23 出すもの出して(人体的なものではない)ほっとしたので、GTD 的にアレする。
• 15:39 --squash はスクオッシュって呼んでるんだけれど、他の人がスカッシュっていってて気になって英辞郎見たら、カナのところその両方書かれてた。
• 17:15 たーいきーん。
• 17:34 オフィス出る前に作っといたYAPC::Asia Tokyo 2012 の foursquare venue 1番乗り取られた。 #yapcasia
• 17:47 赤坂見附駅で5秒で乗り換えたのでわりと順調。
• 17:56 到着。 (@ YAPC::Asia Tokyo 2012 w/ 2 others) http://t.co/FZWWMiW5
• 18:03 チェックイン! @ YAPC::Asia Tokyo 2012にタッチ！ http://t.co/Ynbuo3Kn
• 18:10 Officeで使うPerl　Excel編 (@risou 氏) スタート! #yapcasia
• 18:21 また Windows でガリガリ Perl やりたい。 #yapcasia
• 18:38 @xtetsuji これからもよろしくお願いします!
• 18:40 UV - libuv binding for Perl (@typester 氏) 始まってました。 #yapcasia
• 19:01 Sqale の裏側 (@gosukenator 氏) スタート!#yapcasia
• 19:25 トーク面白そうだけど、聞かないでだらだら。 #yapcasia
• 19:26 発表聞きにいくよりタイムライン見てた方が内容把握できそう。 #yapcasia
• 19:53 @mushikabu 結局トーク聞かなかったんですが、まあよくやることですよー。
• 20:01 たいさーん。 #yapcasia
• 20:03 @mushikabu あ、どっちからどっちかですね。 Excel が操作されてたっぽい。
• 20:14 大手町駅改札出たけど、東京駅どっちか把握しないで人の流れにのってる。
• 20:17 OK. オアゾに出た。
• 20:36 帰りの電車でハッシュタグ読み完了。 #yapcasia
• 20:55 前夜祭で @lapis25 氏ヤバげだったのでポビドンヨードしました。
• 21:53 masartz 氏が「何しに行くんだよ。そんなこと言う奴は YAPC 行かなくていいって言ってやった。」って言ってるの聞いて惚れた。 #yapcasia
• 22:32 Android で XMPP ってどれがいいの。
• 22:35 @haruyama 紹介ありがとうございます。 Beem 入れてみます。
• 22:36 紹介してもらった Beem インストール。
• 22:48 明日の @lapis25 氏の Perl Ocean の発表に備えて http://t.co/uZLUjwys を読みつつ XMPP クライアントをせったぁー。 #yapcasia
• 22:56 XMPP とか、まえ何でやってたかなと思って確認したら Kopete だった。KDE のやつ。
• 23:40 明日土曜日な気がしてならない。
• 24:18 @_basi くっくっくっ。明日は夏休みで完全にプライベートデーなのです!
• 24:38 添い寝専門店「ソイネ屋」、「声優のたまご」の跡地にできたのかと思ったら微妙に違うビルらしい。

今日のさえずり: やる気にさせます! (ふくろう博士)

2012年11月28日

• 09:56 予想していなかった小雨模様。 (@ 株式会社ミクシィ (mixi, Inc.)) http://t.co/nlpZtoXc
• 09:58 今日も Windows 要再起動か。
• 10:10 ああ、やっぱり pLaTeX2e で仕様書を書きたい。
• 12:40 やる気にさせます! (ふくろう博士)
• 13:30 今シーズン初グラコロ。 (@ マクドナルド 渋谷新南口店) http://t.co/Igj2H1vJ
• 14:00 久しぶりに傘なしで雨に打ちひしがれた。
• 18:44 退勤 & ヒカリへ。
• 18:50 うらから。 (@ 渋谷ヒカリエ (Shibuya Hikarie) w/ 12 others) http://t.co/qvSfNVEi
• 19:03 第3.5回 データ構造と情報検索と言語処理勉強会 #DSIRNLP きました。 (@ NHN Japan 株式会社 渋谷オフィス) http://t.co/gRwMDSBB
• 19:31 あなたの知らないハッシュテーブルの世界 @kumagai 氏 #DSIRNLP
• 19:49 Hopscotch #DSIRNLP
• 19:54 こまめに詰め直すのか。 #DSIRNLP
• 20:22 スミマセン @kumagi 氏でした。 RT @Naney: あなたの知らないハッシュテーブルの世界 @kumagai 氏 #DSIRNLP
• 20:29 文書要訳入門 中級編 @hitoshi_ni 氏 #DSIRNLP
• 20:31 文書要約。うちのチームのホープも来れば良かったのに。 #DSIRNLP
• 20:38 自動化と人件費削減。人切り。 #DSIRNLP
• 20:47 日本語の作文技術読めという話。 #DSIRNLP
• 21:28 眼下 109。 http://t.co/vHiO2sL8
• 21:38 ブラウンのおでこを ｍ となぞってくるなど。
• 21:41 ハッシュテーブルの話は基礎の復習から最新トピックまでうまく導いてくれてわかりやすかったです。 #DSIRNLP
• 21:44 要約の方は直近でやること無さそうだけれど、言語尤度あたりは勉強しといたほうがいいかなという学び。 #DSIRNLP
• 22:45 熱量って言葉よくでてくるので、 KPI の単位をジュールにしたい。
• 23:11 ふい字が使えるのでゆる文字カメラ入れてみた。出力画像がクリッピングされないでオリジナルままだといいのにな。
• 23:18 @nekosuzu 携帯百景みたいな加工を、Android でしたくて。
• 23:27 Phonto も入れてみた。これで白ふちができれば良かったのに。
• 24:20 おっ、 Photo Editor というアプリで携帯百景っぽく加工できた。

今日のさえずり: Excel 方眼仕様書廃絶を訴えかけました

2015年11月25日

• 09:54 出社。 (@ 株式会社ミクシィ (mixi, Inc.) in 渋谷区, 東京都) https://www.swarmapp.com/c/bNTWE6uCVyn
• 11:05 年末調整の書類は今朝ようやく準備ができました!
• 13:10 Excel 方眼仕様書廃絶を訴えかけました。
• 22:13 Xperia Z5 をソフトウェアアップデートしたあたりから指紋認識がガタ落ちした気がしたので指紋再登録してみました。結果良くなった感じです。

「なぜ Excel 方眼仕様書だと駄目なのですか?」

先週ワークフロー改善内容についてレビューしたところ添付されていた仕様書フォーマットサンプルが Excel 方眼紙だったので、これを機会に止めましょうとお願いしておきました。 そうしたところ今日になってツッコミをいれた人と同じグループの別の人から「なぜ Excel 方眼仕様書だと駄目なのですか?」と質問されました。即答するとなんか適当なことを言ってしまいそうなのであとで回答しますねと答えておきました。

Excel 方眼仕様書をもらった時の嫌だなという感情は「ファイルでの管理だから」「Excel だから」「方眼スプレッドシートだから」など複数の混ざり合った理由からやってきます。

この中で「ファイルでの管理だから」「Excel だから」は環境によっては排除できない場合もあるし、ユースケースにあっている場合もあるので単純に良い悪いとはいえません。

しかしながら「方眼スプレッドシート」で書かれた仕様書というのはいつでも不便なので止めて欲しいです。書かれている文章の部分が論理的な入力になっていないのが一番嫌な点です。1文毎に別のセルに書くとか、字下げは次の列のセルからとか、箇条書き項目ごとに次の行のセルとか。仕様レビューや仕様変更での更新が非常にやりにくい。説明を書き足しにくい。

だからといってシート毎に大きな図形を貼ってその中にテキストを書けば良いといったものでもありません。それこそ方眼にする理由はないでしょう。

編集を阻む仕様書は、仕様の品質を上げるコストを高くするのです。

今日のさえずり: 「なぜ Excel 方眼仕様書だと駄目なのですか?」

2015年11月30日

• 18:22 「なぜ Excel 方眼仕様書だと駄目なのですか?」

今日のさえずり: Todoistプレミアムが切れた

2017年02月26日

• 12:29 Todoistプレミアムが切れた。今は Remember The Milk Pro なので継続しない。
• 22:57 そういえば Excel 方眼仕様書をようやく最近見かけなくなった。