詳細設計書とコーディング用紙と - きよくらの備忘録

「詳細設計書F**k」「SIer、Sxxt」的なお話は定期的に（日常的に？）ネットやTwitterのタイムラインを賑わせているように思います。つい先日もそんな感じのblogエントリが少しバズっているのを目にしました。 よくdisられる感のある詳細設計書*1。これは作られるのでしょうか。必要だから？ではなぜ必要？ 『最近の開発では詳細設計書は必要ない』というニュアンスの発言も耳にします。では昔は必要だったのでしょうか。そもそも何のために生まれたのでしょうか。 ……話しは変わりますが、今私はちょうど、年度末のアレコレでとても現実逃避したい気分だったりします。ということで、気分転換に、昔のことを思い出しながら与太話を書いてみたいと思います。 これから書くお話は、以前 ― 正確な時期は覚えていませんがおそらくは10年前くらい ― 私がSIerに勤務していたころ、今でも尊敬している大先輩のエンジニア

[todesking]

IT業界、無能の集まりなのでは……

[heavenshell]

新入社員研修で COBOL やらされたときにコーディング用紙で書かされたわ。因に 2000 年代の話し。

[rryu]

根本を改善するのではなくコードから詳細設計書を生成するソリューションを作ってしまう辺り、業の深い業界ではある。

[kabisuke]

あーまさにこれですわー／ちなみに、未だに机上デバッグをやり、しかも机上デバッグでの指摘数を品質指標にするという現場もあります（白目）

[ikosin]

本筋と関係ないけど、当時の「パンチャー」の役割を今のプログラマに求めてる会社がブラックな SIer なのかなって感じた

[sheile]

16年ほど前に工業高校でやったのは「フローチャートを描く→コーディングシートを書く→端末から入力して汎用機で処理」だったな。部屋名が「穿孔室」だったわけで、歴史ありそう。面倒で逆順でやってたけど。

[nyop]

むかーしむかしのおはなし。まぁ社内規定とかISOとか医薬のバリデーションとか医薬のバリデーションとか医薬のバリデーションとかいろいろあるよね。

[nakaji999]

ずいぶん昔の時代の話は飲み会の席でえらい人から聞いた気がするｗ

[W53SA]

紙にコード書くのめっちゃ不毛感しかない

[tyoro1210]

『一応、生まれて使われてきた理由があるなら、その理由が無くなったなら止めて終わらせる必要もある』

[Drunkar]

「試行錯誤しながら…机上デバッグする。 フォーマット的な正確さを求められるコーディング用紙より、手書きで図や注釈を入れられる詳細設計書の方が、修正の手間も少ないし試行錯誤がやりやすかった。」

[VoQn]

“一応、生まれて使われてきた理由があるなら、その理由が無くなったなら止めて終わらせる必要もあるよね”

[yokichums]

なぜ詳細設計が必要か。コーディング用紙時代は必須だった話

[mmorita44]

端末の無い時代、IT土方は平和でしたということか…

[creaism]

流石にここまでレガシーではないけど、未だにこれに近い事をデジタルでやってる現場は在る。業務のプロだけど、PGは？？な人に、ロジック等を説明するのに詳細設計書はいるかな。資料は須く誰の為に作成するかが重要

[fumisan]

フローチャートを書くのはデザインの範疇だけど、疑似コードを書くのは愚。

[ishisaka]

ホストのアプリケーションではコンパイルにも時間とコストがかかる。実動作も時間とコストがかかる(時間でお金払うからね)気軽にテストなんか出来ないし、ビルドし直しも簡単じゃ無い。完璧と思えるまで机上

[qtamaki]

形骸化説

[f-shin]

それはさすがに古すぎないか！？と思いつつ、バグ率の基準にステップ数から求めてたりするしなぁ。古くからのソフトウエア管理基準が都市伝説化して、誰も変えられず、足引っ張ってるのか!?

[beckle]

なるほどねー

[maru624]

パッケージソフト以前のことをまだやってるんだ

[Dolpen]

全てに置いて詳細設計書が完全な無駄とはいわないけど、それを書く環境が警告もエラーも出ない環境だというのが完全にレガシーでしかない。詳細設計書が静的解析もコードジェネレートもできるようになれば良いのに。

[konishika]

過去の遺物ってやつだよなぁ

[holypp]

丁寧。

[Nagatani]

まぁ、これですよね。うん、涙ぐましい。

[nnnnnhisakun]

IPA発注の案件は基本的にPMBOKに沿ったプロジェクト運営で成果物に詳細設計書（単体テストの対となる設計書）があるのだから、存在意義を否定するわけありませんね。

[Lumin]

IPAや経済産業省あたりに「詳細設計書は過去の遺物、今やJavadocなどのドキュメントで充分に代替可能！未だに作ってる奴はクソ！化石！とんでもないアホ企業！！！！」と声高に叫んでもらわないとこの病気は治らない。

[hiroyuki1983]

COBOL時代の名残だよね。COBOLだと詳細設計書は絶対必要だけど。プログラムがフラグや意味不明なコード値の羅列なので、解読書（詳細設計書）がないとどうにもならない

[warauashi]

納得。

[JULY]

もし、この時代と同じレベルの詳細設計書を要求しているとしたら、それは無駄だと思う。ソースコードの解説資料みたいな物であれば、無駄ではない。

[cad-san]

泣ける

[Sediment]

詳細設計書ってプログラミング独特の奴か。パンチカードは見たことないけど、これは無駄だろう…

[masaru_b_cl]

お姉さん萌えるｗ

[teracy_junk]

ああ、ようやく合点がいった…