なぜソースじゃなく詳細設計を欲しがるのか

Javaを始めとするオブジェクト指向言語による開発になると、設計の手法も従来とは大きく変わる。 その結果、不要になるドキュメントが出てくる。 詳細設計のことだ。 ここでいう詳細設計とは、本来コードで記述する処理を、逐一日本語で書き下したものを指す。 てか、そんな物を読むくらいなら、現物のソース読めよって話だ。 だいたい、ソースに書くレベルの粒度の記述を、なんでいちいち日本語なんて表記揺れも甚だしいフォーマットで書かにゃならんのだ。 何よりソースに修正が入ると、遡って詳細設計も直さないと整合性が取れなくなるので、言うなれば二重に工数を掛けることになる。 「違うよ、設計を直して実装するんだよ」というが、合理性を重んじるSEやPGという人種が、実質同じ内容を何度も書きたがるわけがない。 それに、単体テストくらいまでの段階ならともかく、開発要員が縮小される結合テスト・システムテスト以降で、そんなこ

[chikurou]

ソースコードと同じ粒度なら要らないな。もうちょい俯瞰した資料は欲しい

[tick2tack]

なんでもいいんだが、非効率なやり方を要求するならその分の時間と金よこせとは思うよね

[packpak]

うちはそうもいかない。詳細設計に記述があれば仕様通り、なければバグその他と明確に武器にできる。逆に、サマリーさえ合えばそれ以上細かくする必要はないけど。現場によって説明資料として優秀なんだ、残念ながら

[findup]

コードと対の詳細設計ならいらない。昔はこういうドキュメントを作ってキングファイル何冊にも綴じて納品してた。目に見える「成果物」って意識があってたぶんその頃の名残が残ってるんじゃないかなぁ。

[nobububu]

発注する側(情報システム部門)の採用が専門職採用じゃないのが元凶で、それと会話できることをコミュ力と称して一次受けが新卒採用して。まあ、素人なんだよ。建前はプロでも。そしてこれが日本の生産性の低さそのも

[cider_kondo]

シーケンサの言語であるラダー図は電気回路図そのものなので電気図読める人は理解できる。逆も（だけじゃなくて裏も対偶も）然り。こういう話を読むとは電気屋でよかったと思う。

[atoh]

嫌ならそんな仕事受けなきゃいいじゃん。

[aukusoe]

「そして元請はITのプロなんだから、ソースなんてスラスラ読めて当然なわけで。英語読めない英語の専門家が存在しないのと同じ理屈ね」そりゃそうよ、その証拠にゲイツはHalo超強いし角川春樹の小説は超面白い。

[ch0ge]

元請けは、ソースはもちろん「ユースケース図、アクティビティ図、クラス図、シーケンス図、Javadoc」もそんなに読めないからな。だから日本語のドキュメントを求める

[muamqm]

javadocで済ましたいよね〜

[onefootinthegrave]

詳細設計はコンパイラないから表記の揺れ程度も人間がチェックだしねえ。 たしかに、ソース読めばいいじゃん、て思うんだけど、そうするならセットで変数名とかに日本語にしたいんだけど。 なぜかゆるされない。

[kizuki1010]

詳細設計がメンテナンスされてないのに必要有無を論じてもなぁというのはさておき、基本設計の粒度は正しいのかとか、責任分界とか、ソースレビューするときの判断基準とか役目は多いような

[ch1248]

UML+Javadocあれば十分だと思うが、謎の因習引きずって、コードと同じ粒度の設計書書かせてる現場かな。

[secseek]

100歩譲って詳細設計書を要求されるのは許してもいいと思います。しかし、それなら納品後に詳細設計書に書いてある内容を質問してくるのはやめてほしいです。いやみったらしく「設計書に記載のとおり…」って毎回返し

[ikazoike]

長いプロジェクトとかだとお金払うタイミングになんかしらの成果物がないと経理が怒る問題が発生する。設計書はそういうときに有効

[qaz76]

「なぜSIerはCD/UTを外注したがるのか？」って方がアレかも。。

[Error401]

本当に欲しがっているのは、大抵は、外部設計/基本設計とソースコードの間の、UIやデータベースの設計ではない何かだと思う。長いブログのtl;drみたいなもの。

[kknsd]

それコメントに書いときゃ充分なんじゃないのっていうブコメが散見される

[deep_one]

ソースのコメントが不足していると、「この部分がなんなのか」解析するのに無駄な時間がかかるぞ。設計書なら書いてあるだろ。

[te2u]

求める人がソースを読めないから？

[sin20xx]

正しい動作の定義をプロジェクト全体で間違えなく共有し、それを維持・継承できるならいいんじゃないかと。もともと詳細設計を細く書くというのは設計技法と管理の手法だからね。でもソースが仕様は非効率過ぎだわな

[houyhnhm]

インタフェースまでは必要。で、詳細設計書が必要になるのは、バグとかの時。想定しているロジックが何なのかをソースコードから再現するのは邪推になりがちなので。

[kiyo_hiko]

あれはクソコードというダンジョンを照らすたいまつ…。おもむろに開いたExcel方眼紙には謎の変数例えばflg1とかflg2の変化がフローチャートで書いてあり（意味は書いてない　´・ω・｀）、ぼくを少し救ってくれる

[vanbraam]

インターフェイス仕様(外部設計)書は必要だが,内部仕様(詳細設計)書はいらないだろう.UTで十分.privateメソッドのUT書くかどうかは悩み所だが,それはまた別の話;読みもしない詳細設計書書かせる為に倍の金額払うのは愚か

[tanority]

よくわからんがその場合なにを元にコーティングするんだ？あと設計バグもソースのせいにされたりしないのかな？

[l3l]

詳細設計書いらないから半額でお願いがOKならいいんじゃね?

[northlight]

クソほど見通しの悪いクラス設計とゴミみたいなコード書くのやめてから言えよ。

[mate_gai]

適切な粒度のものは、引き継ぎ用に作っておいてほしい

[hush_puppy]

クソコードとクソ詳細設計書とで、どちらの災禍がより大きいのだろうか。なんにしろクソメンバーをちゃんと排除するしかないのか。

[w1234567]

はてブの連中はウンコシステムをソースから改修できる超人ばっかなのかよ、すげーな。

[sona-zip]

日本は専門性を軽視しすぎ

[funnnon]

インとアウトが伝えられた仕様とあってないから仕様書がほしくなるんだよ。特殊な処理があるのかないのか。仕様にないならコードみたって間違ってるとしか言いようがないだが。コードは仕様把握には万能ではない

[kazkaz03]

節子、それ詳細設計書やない、プログラム仕様書や

[koko_0]

小規模開発で、きっちり整備されたコードならそれで良いんだけどな。長期間で多くの人間が一つのコードを修正してると、ネストしまくったスパゲッティコードになる。そういうときに設計書が欲しい。

[basyura]

基本的に要らないものは作らない派だけど、自分が一行も書いてない箇所のバグ取りをやるとしてソースしかないと言われたらなかなか辛いなぁ。ウンコードでも高度すぎても読めないしバランスだと思うけどそれが難しい

[confusion8]

「元請はITのプロなんだから、ソースなんてスラスラ読めて当然なわけで」出、出〜〜ｗｗｗｗ上流にフルスタックのスキルセット求め奴〜〜〜ｗｗｗ ｗｗｗｗ

[taichitary]

日本語で読めるように「なでしこ」で書く