12/10/09 12:34:17.78
それは仕様書だね。設計書とは違う。
915:仕様書無しさん
12/10/09 20:20:14.25
UMLがどうのとかはぶっちゃけどうでもいいよ。求められれば使うだけ
だがな、ドキュメントとして文章めいたこと書くのにExcel使うのはいい加減やめにしてもらいたい
二度と修正を入れない使い捨てなら構わんが、保守を考えたらExcelドキュメントなんてうんこよりひどい
916:仕様書無しさん
12/10/09 21:19:43.34
ワードで書くよ～って言ったら嫌な顔するくせに
917:仕様書無しさん
12/10/09 22:27:10.85
まともに変更履歴も残さないUMLは使い物にならない
設計書で重要なのは変更履歴と変更理由
現状はソース見れば誰でもわかる
918:仕様書無しさん
12/10/09 23:41:24.45
それはバージョン管理システムの仕事だろ。
UMLでも、変更ごとにコミットしてコメントちゃんと入れれば無問題。
バージョン管理システム使わずにコメントだけで変更履歴残そうとして
しっちゃかめっちゃかになったソースだと、ろくに流れも追えなくなる。
919:仕様書無しさん
12/10/10 07:15:32.32
たとえバージョン管理システム使ってても
diff取れないバイナリで書いてりゃ威力半減
920:仕様書無しさん
12/10/10 07:40:25.34
そのあたりは使うツールによりけりだが・・・
とりあえず、diff が取れる代替え手段ってなんかあるの？
921:仕様書無しさん
12/10/10 07:42:02.80
diff とか言い出すと、 word や Excel より TeX だよな。
922:仕様書無しさん
12/10/10 17:36:08.65
TeXだと冗長になるし、なんかそれ用のエンジン使うのが賢いんだろうな。本当は。
923:仕様書無しさん
12/10/10 20:40:25.74
>>920
エクセルに1文1セルで書いて、隣の列に
1列1バージョンで改変有無と理由を記載
フィルタを使えば瞬時に差分が見られる
924:仕様書無しさん
12/10/10 20:54:09.99
>>923
それで事足りる案件なら、自分だって Diff もバージョン管理システムも、
UML も使わないよ。
925:仕様書無しさん
12/10/10 23:46:17.39
そういうのは大抵が打ち消し線だらけだったりカラフルだったりになるから
いろいろ糞だけどね
場当たり対応をコード以外でも多用してるだけだし
926:仕様書無しさん
12/10/11 06:43:08.22
技術文章としての体裁を要求されたり、図表使ったら終わるだろ、それ。
927:仕様書無しさん
12/10/13 13:18:12.48
上流工程の資料の作成が凄いネックになってる気がしてならない。
開発者の視点で厳密に書くと「こんなんじゃユーザがわからん」といってハネられる。
ユーザにわかるように書くと表現があいまいになって、開発者には意味不明になる。
この矛盾に悩みつつ、ダメだしを回避する資料を完成させるのに絶望的に時間がかかって、
プロジェクトの予備工数がほとんど消える。
最後にはタイムオーバでダメ出しする人間が折れることになるが、
なんだかんだで、ユーザにも開発者にも3割方意味不明な資料ができあがる。
この3割方意味不明な資料を使って予備工数がない状態で開発がスタートする・・・。
928:仕様書無しさん
12/10/13 15:51:58.47
ユーザー用と開発者用それぞれ別のドキュメント作ればいいだけでは？
むしろ作るべきでは？
929:仕様書無しさん
12/10/13 16:10:43.54
まず、そのための工数がとられてるプロジェクトをみたことがない。
あと、開発スタート後に鬼のように湧いてくる仕様変更を、
二重化したドキュメントに反映してメンテナンスしていくコストも大変。
930:仕様書無しさん
12/10/14 17:30:47.51
dfdとer(テーブルと多重度のみでOK。カラムは主キーのみでいい)意外不要。
931:仕様書無しさん
12/10/14 17:43:10.49
一人で作る程度のシステムで、クライアントがそれで納得してくれて、
その後の運用メンテも同じ担当者が続ける前提なら、それでなんとかなるかもしれん。
932:仕様書無しさん
12/10/15 02:52:27.14
成果物が糞じゃない前提なら、ドキュメントの必要性は減ると思うよ
webとかだったら画面遷移とかあると理解度は上がると思うけど、
マニュアルと動くものがあれば事足りるからなくてもいい
クラス図があると関連は理解しやすいけど
名前やパッケージ、IDEの機能で追っかけるのは簡単だからなくてもいい
まぁ作成や保守にかかるコストと教育にかけるコストと、教育対象者の質次第だな
劣悪なのはドキュメントがいくらあっても結局理解しないし、
できる奴は(ちゃんとしたシステムであれば)その場にあるので難なくこなせると思う
933:仕様書無しさん
12/10/15 12:49:11.89
技術的なドキュメントとして重要なのは基本設計と運用設計のほうだと思う。
基本設計資料がちゃんとしていれば、詳細設計は無くてもなんとかなる。
でも今、実際は、基本設計、運用設計、詳細設計で、ドキュメント量の比率としては、2:1:7 ぐらいじゃないか。
自分は、6:3:1 ぐらいでもいいと思う。
934:仕様書無しさん
12/10/15 15:22:41.07
詳細設計書 = ソースコードだからねぇ。
本当の必要な量で言えば、一番多い。
だけど、ソースコードを補足するものだけに
すれば、逆に少なくなる。
詳細設計の量が多いところは
ソースコードが詳細設計書だって
わかってない。