詳しすぎる詳細設計書 - SiroKuro Page

「詳細設計書」と呼ばれるドキュメントがあります。各処理の入出力や処理概要を記載した文章です。 入力： 「性別と身長のペア」のリスト 出力： 男性の平均身長」と「女性の平均身長」の差 処理概要： 変数「男性の合計身長」「女性の合計身長」「男性の人数」「女性の人数」を 0 で初期化する 入力を受け取る 入力されたリストから要素を読み込む 入力されたリストの要素数だけ以下を繰り返す 要素を１つ読み込み、条件分岐する もし要素が男性なら、変数「男性の合計身長」に身長を加算し、変数「男性の人数」を１増加させる もし要素が女性なら、変数「女性の合計身長」に身長を加算し、変数「女性の人数」を１増加させる 次の要素を読み込む 「男性の合計身長」÷「男性の人数」−「女性の合計身長」÷「女性の人数」を、変数「計算結果」に代入する 出力する イメージとしては、こんな感じ。各社それぞれ、どんな詳細設計書を書いてい

[slash_01]

詳細設計書はコーディングが終わった後に作れば良いと思うんだ。保守する人のために。

[gothedistance]

つ http://d.hatena.ne.jp/int128/20080415/1208271021 / assertできる条件だけを記述すればいいはず。 一語一句同じように書きなさいってことは生産性の低下を招くだけ。でもねぇ、工程分断されているとココまで必要な場合ががが。

[coppieee]

ここまでいくと日本語プログラミング言語使ったらいいんじゃない？

[ottonove]

スキルアップ

[ntaoo]

詳細設計書よ滅びろ

[kkotyy]

"実際書いてみて異様なほど書き直したい気持ちに満ちあふれているんですが、そのためには詳細設計書が異様なほどに邪魔になります。詳しすぎるんです。" 悩みはみな同じ。

[hiroomi]

全体見てないのかも。

[flakwing]

詳細設計について

[tohtas]

設計

[s5ot]

設計

[j5ik2o]

コード一行一行に対応付く設計書は書きたくない。アジャイルに反するしね。

[zu2]

詳細設計の文化の存在理由はなんだろう

[daira4000]

"実装するには物足りず、基本仕様としては詳しすぎる"

[yujiorama]

設計=プログラム動作の日本語化、という文化があるからなぁ。レビューする人が理解できないからだとか聞いた

[Ehren]

あるある

[tittea]

ppとの違いは粒度だけ？

[paella]

ここで書かれている詳細設計書は本当に詳細設計書なのかなあ。関数仕様書とかになるのでは。

[kawaoso]

今やってる仕事がまさにこれでちょっと悲しくなった。。。やっぱ詳細設計書なんてイラネー

[tarchan]

ソースコードと1行ずつ対応してる設計書とか邪悪すぎる

[kodaif]

"システムのことを中途半端にしか指図しないからです。システムを見ているようで、実は目を瞑りながら口だけ出しているという感覚ですね。実装するには物足りず、基本仕様としては詳しすぎる、そんな役回りです。"

[Nagise]

詳細設計書は実行して結果が正しく動くかを確認することもできなければブレークポイントを打つこともできないし、リファクタリングの機械サポートもできない。不便なものでプログラミング。便利なものは使わない

[katzchang]

こうやって、能力が活かされることなく時間だけが過ぎていく。と考えると吐き気がしてきた。

[holypp]

～COBOL 最強説ここに爆誕。～　あるある。javaなら詳細設計書は書かずにテストコードを死ぬ気で書いた方がいい。