「わし詳細設計書書くのやだよ」システム開発で細かければ細かいほど仕様変わった時の変更が爆増してメンテコスト爆上がりする。かけるべきコストはそこじゃない話に賛否両論

しのゆー𝕏酒クズエンジニア @shinoyu 元ニューハーフ風嬢のタチリバくそオカマ / 顔面工事300万程度のおじさん / 新宿で社長やってるソフトウェアエンジニア18年生 / 💻技術🎧 V系 🎀ロリィタの人 / 170スペ113 スプリング、骨ウェーブ、顔ソフエレ / 原則IT関連業のみフォロー mixi.social/invitations/@s… しのゆー𝕏酒クズエンジニア @shinoyu わし詳細設計書書くのやだよ(￣･ω･￣) 細かければ細かいほど仕様変わった時の変更が爆増してメンテコスト爆上がりする。かけるべきコストはそこじゃない。 必要なのは完成に必要要件がまとめられたもの。それを元に受け入れ試験書がつくられる。それクリアすればどう作ってようが構わんわけだ 改修コストを下げるための設計になってることは前提だけどね。 だけど、詳細設計書が必要となる現場はこの設計す

[hobbiel55]

各自が思い浮かべる「詳細設計書」のレベルがマチマチな気がする。うちの場合は詳細設計書の下にプログラム設計書というのがあった。さすがに作らなくなったけど、このレベルの話も混じっているのでは。

[devrabi]

実装知識のない人が詳細設計書と称するものを作り、本質的に何をしたいのか理解しない単価の安い外注に実装させ、出来た不具合だらけの成果物をコストをかけて評価する。それが開発だと思っている世界もあるようです

[suikyojin]

「厳密な意味で設計書と言えるソフトウェアドキュメントはソースコードだけである」というのは、1990年代頃から主張されている。私も賛成。設計書だと言うなら、その設計書から作れるものが同等でないとおかしい。

[vegnpomn]

基本設計書が顧客向けで詳細設計書は開発者用ということなんだろうが、詳細に起こしたほうがいいような複雑で重要な業務ロジックは基本設計書にも書いたほうがいいし、単に設計書でくくっちまえばいい気もしている

[murasuke]

メンツと体制次第かな。自社で開発要員揃えられて、設計者がコーディングもできるなら詳細設計は不要。外注(二次、3次受け)に作らせるなら、コミュニケーション手段として必要。

[kiki-maru]

世の中にはコードを日本語で書いただけみたいな存在意義のわからない詳細設計も結構存在するので、詳細設計の指している内容による。

[hogeaegxa]

CASEツールにみんな夢見たせいで、詳細設計書はExcelをエディタに日本語でコーディングするものと定義されて、夢破れた後も無駄と不幸をばら撒いてると思う。AIで歴史を繰り返そうとしてるのでこの定義は固定化されそう

[sgo2]

大体の場合レビューにしか使われない(ソースと同期取れてる保証が無いのでメンテ時にはノイズ同然)高コストなコミュニケーション手段という認識

[cinq_na]

逆にPGが100人とかもっと必要な案件で、詳細設計省いて製造する方法があるなら聞きたい。コードと1対1な昔よりも詳細設計の粒度は荒くなってるとは思うけど。

[izoc]

正直基本設計書だけで十分な気がする。それで足りなきゃ基本設計書に補足情報追加すりゃ良いし。コードと対になってるような粒度の設計書は無駄

[lycolia]

ケースバイケースだけど、レベルの高い人材でそろってない限りあった方がいいと思う。仕様の取りこぼし漏れとかを拾うことが出来ることもある。真に無価値なら誰もしないはずなので

[frontline]

20年前から変わらずだけど行き着くところ「スゴクデキル人とチーム」であれば、有っても無くても作る事になっても問題無いと思う。「スゴクデキナイ」が少しでも混じった時点で、書いても駄目だし書かなくても駄目

[cl-gaku]

誰かが一度日本語ソースコードを紛れ込ますと増殖して全部それになるから嫌い

[bellonieta]

元の人は「日本語(自然言語)で書かれた処理詳細」を詳細設計書と呼んでいて、それは確かに不要 絶対に実装とは乖離するはずだし、もし乖離してないならただ管理コストが増えてるだけ

[pwatermark]

設計書とソースコードとテストが同一になるなら設計書は要らん だいたい同一にならんから言い訳のために書類が必要になる

[ghostbass]

プログラミングコードはあまりに抽象化され過ぎて意図を読み解けるようにはできてない。実装に関する自然言語等の記述は必須

[hatest]

詳細設計書という名の憔悴設計書／詳細設計はPG向けの内容ですというやつらに限って、PGにやさしくない日本語と変なルールの記号だらけの設計書送ってきがち

[quick_past]

詳細設計書とは何で、どこまでの濃度のものかもまちまち。一定水準以上のプログラマだけしかチームに入れずにすむ職場なら良いんだけど、そうじゃないし、分散したコードを追いかけるだけでも鬱陶しい

[longyang]

配管も何もない犬小屋と一般家屋と高層ビルで求められるやり方違うのにお構いなしに話してて草

[s17er]

関数やクラスレベルのドキュメントはコード内コメントで書くとバージョン管理もできるし変更に追従しやすい

[lacucaracha]

本当に欲しいのはどうしてこのメソッドの切り方にしたのか、何を狙ってこのパラメータにしたのか、コーティングレベルでの動作概要なんかをまとめた『実装メモ』だったりするんだけどねぇ。

[lizy]

「詳細設計書」の定義が分からない、必要性を感じてないなら必要のないドキュメントなんでしょう

[n2sz]

まとめ内にもあるけど開発規模によるなあ。大きいとドキュメントないときつい。各人が全コードを把握できる規模だったらなくても何とかなるかもだけど。

[manaten]

詳細設計書が何を指すのかによるけど、ソースコードで表現できないものは何かしらドキュメントに残すべきではある。どんな前提条件のどんな業務フローで使われて、期待する動作・アウトプットは何か

[hdampty7]

詳細な仕様書はソースコードとの乖離が問題になるので多くの場合は不要だけれど、複雑なビジネスロジックやデータ量等の外部制約から試行錯誤したような場合には欲しい。

[tamanecoplus]

SI業界なら古き伝統があるけど、Web業界はどうしてるのか、わたし気になります

[clubman023]

設計者と開発者が分かれてる開発がもう嫌だわ

[sjn]

設計は書いた方がいい、設定は設定したものをコメント書きして残すだけでいいと思う派 / ソフト開発論って用語定義をまとめる気がない分野だと思うんですよ…なんなんでしょうね

[strow0343]

「詳細設計書」といっても会社によって実体が違うのでそのまま議論しても不毛。個人的にはコード見れば分かるものかつ視点も変わらないもの(コードと一対一のものとか)は不要

[tanority]

新規で入った人はソースを読めって事？ 開発規模にもよるけどどっちが効率的なんだろう あと設計責任ってどこになるの？

[Eiichiro]

よく建築が例に出されるけど、画面設計書にあたる図面はあるが内部の詳細設計はしてないんよね。だから部品都合や内部の取り合いで仕様変更が起きて、現場監督が変更指示書やスケジュール変更を徹夜で組んでると。

[razihai]

詳細の定義次第だけど、少人数だったりオフショアしないならいいんじゃない？っていうお気持ち(あって助かったこともあれば、なくて助かったこともあるのでケースバイケースだよ)

[btoy]

PCが1人1台じゃなかった頃は実装やデバッグの時間が限られていたから事前に詳細設計やローレベルな詳細フロー書いて上司の承認もらってからPCで実装してたけど。1人1台になってからはソースをdoxygenに突っ込むだけ。

[junglejungle]

詳細設計書なんて書いても誰も読まない＆誰もメンテしなくなり古い情報になるので、結局、コードにコメントを書いておくのが一番良い。コードを読めない設計者なんて必要ない。

[cpw]

うちは可能な限りドキュメントを作らない方針。ただし、可読性の高いコードを書けるエンジニアしか採用してない。コミュニケーションを減らすためにバックもフロントかける必要がある

[ebibibi]

詳細設計書という名前の、プログラムを日本語で書いた謎のドキュメントを見たこと、作らされたことがある。吐き気がするような代物だった。

[peketamin]

見りゃわかるような内容はスキップしてえー

[Karosu]

テストの根拠証明と工数削減のために書く