- 1 名前：仕様書無しさん mailto:sage [2011/11/26(土) 11:26:56.24 ]
- 外部だの内部だの基本だの詳細だの…
曖昧な基準で書かれた、いろいろな名前で呼ばれてて
「これってどうなの？」「意味あるの？」といった物に出くわす事も少なくない
しかし、純粋にプログラミングだけをして食べていくことは、昨今じゃ難しく
避けて通れない、否が応でも作る機会に出くわしてしまう、そんなドキュメントたち
設計書や仕様書についても、マ視点で語ろうぜ
・自分のなかでの仕様書/設計書の呼び方と分け方
・成功談、失敗談
・仕様書/設計書は何を使って作成する？(Word/Excel/HTML/手書き！)
・仕様書/設計書に含める図の作成方法や使っているツール紹介
・炎上プロジェクトでみた(よくない意味で)素晴らしい仕様書/設計書
・そもそも仕様書/設計書って本当に必要なの？
・こんな仕様書/設計書は、ぶっちゃけアリ？ナシ？
などなど、設計書にまつわる話題を募集
- 201 名前：仕様書無しさん mailto:sage [2012/01/07(土) 23:55:59.98 ]
- >>200
お前の人格まで否定しないから、反論してみろよ。
- 202 名前：仕様書無しさん mailto:sage [2012/01/07(土) 23:58:54.79 ]
- 図星と指摘することが反論そのものだろｗ
- 203 名前：仕様書無しさん mailto:sage [2012/01/08(日) 01:44:23.33 ]
- ゆとりは会話もできないのな
- 204 名前：仕様書無しさん mailto:sage [2012/01/08(日) 04:23:40.76 ]
- >>201
やっぱりね。おまえは打たれ慣れてないっつーか、社会に揉まれてないっつーか、そんなところだな。
経験浅いから使ってる言葉に重みがねーんだよ。
後出しジャンケンの意味も履き違えてるみたいだし。
聞きかじった言葉だろ？
すぐに感情的な反応するとこ見ると
あながち間違いじゃなかったみたいだ。認めろよ。
- 205 名前：仕様書無しさん mailto:sage [2012/01/08(日) 04:32:41.63 ]
- もう一つ言うとだな、お前の思ってる言葉の裏に隠されてる真意なんて誰も知らないって。
何だよ真意って。最初から真意言えばいいのでは？
利益優先だとか工程ガーとか、そんなんじゃ仕様書いたことあるかどうかも疑わしいわ。
背伸びしなくていいよ。等身大でいいんだって。
- 206 名前：仕様書無しさん mailto:sage [2012/01/08(日) 05:35:43.65 ]
- ※関係ない人ごめんなさい。
>>204>>205
話の流れをいったん整理する
設計してから要件を定義するという話をしていたから、俺が
「それは設計ではなく、要件を定義するために顧客から要求を引き出す作業であって、
要件が明確化して、機能が確定した段階ではじめて設計が固まる」
という話をしていたわけだ。
そこで、お前が
「合意をとった上で始めて設計が固まる と思ってるなら、まだ青臭いな。
合意はその時点での合意でしかない。」
って頓珍漢な横槍を入れたよな？(本人？)
合意を取ったことに対して"その時点での"設計が固まって、
後で変更を依頼されたら、仕様変更で再設計だよな？
で、俺が返したのは、
「"俺が"初期段階の決定事項が全てだと思っているわけではなく、
設計と要件定義の区別がついていないやつがいるからそういう答えをした。
会社として利益が見込みがあるのであればそういう仕事もする。」
で、お前が
「カチカチの行程のほうが開発会社の利益になる。
臨機応変に対応したら仕事が減る。」
で、俺が
「カチカチのほうが確実な見込みが取れるから安全だけど、
実際には利益が見込まれるならそういう客にも付き合う。」
- 207 名前：仕様書無しさん mailto:sage [2012/01/08(日) 05:36:06.12 ]
- で、お前が
「話を後付けするな。確固たる主張がないなら折れろよ。
言い逃れ野郎。人格否定されてると勘違いするな。素直に認めろよ。」
で、俺が
「>>162で書いたことの意味を正しく認識できていない。
カチカチにするより利益が上がるという意味ではなく、
利益が上がるなら仕事として受けるという意味。」
で、お前が
「どうした？図星すぎてテンパったか？」
で、俺が
「お前の人格まで否定しないから、反論してみろよ。」
で、お前が
「図星と言ったのが反論。」
「経験不足にみえる。言葉に重みがないからわかる。
言葉づかいも間違えている。図星だろ認めろよ。」
「お前の心の中なんか知るか。最初から真意言え。
利益優先だとか工程ガーとか、そんなんじゃ仕様書いたことあるかどうかも疑わしいわ。
背伸びしなくていいよ。等身大でいいんだって。」
ここから、返信 ← new!
「真意って言ったけど、書いてなかったことではなく書いていたこと。
お前が話しの流れを読めていない上に、どんどん話をずらしていった。
そして、図星が反論になっているという意味がいまだにわからない。
冷静に自分のレスとスレの進行を眺めなおしてこい。」
- 208 名前：仕様書無しさん mailto:sage [2012/01/08(日) 05:38:28.50 ]
- そろそろダルいのと、もうだいぶ他の人に迷惑かけてるから、
次で誤解が埋められなかったら終わりにしよう。
- 209 名前：仕様書無しさん mailto:sage [2012/01/08(日) 10:48:23.37 ]
- こうゆうやつらがいたらデスマになりそう
- 210 名前：仕様書無しさん mailto:sage [2012/01/08(日) 12:15:41.06 ]
- 細かい事はいいんだよ見たいな奴は危険。
また、一見細かく見えてどんどん話がずれて行く奴も危険。
- 211 名前：仕様書無しさん mailto:sage [2012/01/08(日) 12:50:18.74 ]
- 話の発端は、要件定義やらずに設計書を要求してくる客がいるというところから始まってる。
おそらく、お互いが最終的なシステムをどういったものにしたいかイメージできないからだと思う。
このような場合、試作を見て要件を出してもらうプロトタイプモデルとかがあるわけで、
その変形版って捉え方でいいんじゃないかな？
- 212 名前：仕様書無しさん mailto:sage [2012/01/08(日) 12:53:45.13 ]
- >>207
あんたまたやらかしてるよ。。認めればいいのに。
頭凝り固まってる。
- 213 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:00:43.93 ]
- >>212
相変わらず、何の具体的な指摘も反論も出来ないのな。
という事で終わりな。
- 214 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:09:57.07 ]
- >>209
PM,PLだったら最悪だな。
特に行き詰まったときに、精神論や人格論ばかり振りかざす奴。
うつ病患者量産するからな。
PEだったら、チームから外してもらうよ。
- 215 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:29:04.39 ]
- そろそろ仕様書、設計書の話に戻そうぜ。
- 216 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:45:19.85 ]
- 相手の意見なんて一切お構いなしに、自分の信念に基づいた見えない弱点を作り出して、
そこを突くことで勝ちに浸る、って奴はどこにでもいる
そもそも発端が、憶測から相手を過小評価することで気持ちよくなりたい相手なんだろ
んなの、いち早くレスする価値がない相手だって気づいて、スルー決め込むのが最適解だわ
わざわざ同レベルで争い続けるから、無駄レスが続くんだよ
- 217 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:46:21.94 ]
- >>216
自分に言え
- 218 名前：仕様書無しさん mailto:sage [2012/01/08(日) 13:47:49.66 ]
- >>204
やべぇ、こういうおっさんうちの職場にいるわｗ
こいつの書く仕様書が半端じゃなく使えないけど、声でかいからみんな困ってる
- 219 名前：仕様書無しさん mailto:sage [2012/01/08(日) 14:01:32.66 ]
- 反論しなければ周りにバカ遺伝子撒き散らすし、やりあえば不毛だし、生きている事自体が害でしかない。
- 220 名前：仕様書無しさん [2012/01/08(日) 14:08:21.26 ]
- 討論はどんどんすべきだし、途中まではいい感じだったけど
人格否定が始まったら終わりにすべきだな
「現場にたまにいるわ」のあたりからディベートとして成立しなくなったな
- 221 名前：仕様書無しさん mailto:sage [2012/01/08(日) 14:25:44.51 ]
- 仮想敵設定を誤るとこうなる
- 222 名前：仕様書無しさん mailto:sage [2012/01/08(日) 16:03:21.72 ]
- はいはいぬるぽ
- 223 名前：仕様書無しさん mailto:sage [2012/01/08(日) 18:31:36.88 ]
- 2chに何か期待した時点で負けだろ。
- 224 名前：仕様書無しさん mailto:sage [2012/01/08(日) 22:39:22.01 ]
- 自分の書き込みに、全部同一人物がレスしてると思うなw
ここはIDもついてない板だぞ
IT開発者は少しくらいはアスペルガー気味なところがあっていいけどもちょっとは気付け
ちなみに >>144 >>168 >>174 >>178 とかは同一人物
>>168 の書き込みが悪かったな。
>>162のカキコの意図を取り違えていたよ。ていうか半分は論点ずらしだったわけだが
それも2ちゃんだ
- 225 名前：仕様書無しさん mailto:sage [2012/01/08(日) 23:30:03.79 ]
- 設計書の形式、ExcelもWordもダメだとすると、何がいいんだ？
- 226 名前：仕様書無しさん mailto:sage [2012/01/08(日) 23:43:04.95 ]
- 最後に頼りになるのはTEXTでしょう。
- 227 名前：仕様書無しさん mailto:sage [2012/01/08(日) 23:48:33.49 ]
- jpg
- 228 名前：仕様書無しさん mailto:sage [2012/01/08(日) 23:57:47.71 ]
- >>224
現場にたまにいるわ。
詭弁使ってドヤ顔してるやつ。
確固たる主張がないなら折れろよ。
- 229 名前：仕様書無しさん mailto:sage [2012/01/08(日) 23:59:11.28 ]
- >>224
ごめんなさい。
「確固たる主張がないなら折れろよ。」
って言って見たかっただけです。
- 230 名前：仕様書名無しさん mailto:sage [2012/01/09(月) 03:41:58.89 ]
- そもそもマイクロソフト様は設計書は何で書いてるんだろうな？
まさか、Word？
- 231 名前：仕様書無しさん mailto:sage [2012/01/09(月) 03:42:20.26 ]
- Excelは保守を考えないなら楽だけどな
- 232 名前：仕様書無しさん mailto:sage [2012/01/09(月) 04:05:14.81 ]
- >>230
HTML
- 233 名前：仕様書無しさん mailto:sage [2012/01/09(月) 09:11:55.31 ]
- >>232
技術資料は全てMSDNとして公開されるわけだからHTMLだな。
- 234 名前：仕様書無しさん mailto:sage [2012/01/09(月) 11:05:24.05 ]
- >>231
保守は、設計書の保守って意味？
- 235 名前：仕様書名無しさん mailto:sage [2012/01/09(月) 11:27:49.61 ]
- >>233
ということはhtmlは何で書いてるの？
メモ帳？Ｗord？
- 236 名前：仕様書無しさん mailto:sage [2012/01/09(月) 14:56:46.29 ]
- ホームページビルダーだよ
- 237 名前：仕様書無しさん mailto:sage [2012/01/09(月) 14:59:52.64 ]
- プロが包丁でじゃがいもの皮を向いていても
一般の人は皮むき器でいいと思うよ。
真似することはない。
- 238 名前：仕様書無しさん mailto:sage [2012/01/09(月) 15:19:34.57 ]
- >>235
独自の管理？ツールがあるんだろ。
ドキュメントコメントと関連付けられたフォームに、
入力するとMSDN生成してくれるやつが。
- 239 名前：仕様書名無しさん mailto:sage [2012/01/09(月) 16:03:59.55 ]
- >>238
ドキュメントコメントって設計書か？
少なくともソースが存在しない時点では書けないよな？
- 240 名前：仕様書名無しさん mailto:sage [2012/01/09(月) 16:05:43.03 ]
- >>236
他社製品www
- 241 名前：仕様書無しさん mailto:sage [2012/01/09(月) 16:35:25.48 ]
- >>239
ドキュメントコメントは仕様書だな。
作る順序は作業の進め方によるけど。
何かツールでモデリングしてコードの雛形作ってる事のほうがおおいか。
- 242 名前：仕様書無しさん mailto:sage [2012/01/09(月) 23:07:12.36 ]
- >>235
HTMLはVisualStudioでだ。
- 243 名前：仕様書無しさん mailto:sage [2012/01/09(月) 23:18:19.04 ]
- HTML形式で文書を作成するってのが想像つかないんだよな。
一般企業だと、文書は文書作成ソフトで作成して
提出時に用紙に出力するって流れで固まってるよね。
HTML形式を用紙に出力すると、体裁崩れちゃうし…。
- 244 名前：仕様書無しさん mailto:sage [2012/01/10(火) 00:05:27.42 ]
- >>243
それは、HTMLとCSSが使いこなせていないからでは…？
- 245 名前：仕様書無しさん mailto:sage [2012/01/10(火) 00:15:59.17 ]
- ﾈｽｹの4がﾃﾞﾌｫだった時代のｵｼﾞｻﾝなんだけれど、今からHTMLとかCSSとか覚えようとしたら
どっから覚えたらいいんだ？ ﾃｰﾌﾞﾙとTRとTDで組むとかしたらｼｰﾗｶﾝｽ級の扱い受けるんだろうなぁ
- 246 名前：仕様書無しさん mailto:sage [2012/01/10(火) 01:01:16.88 ]
- CSS3使えばいいよ。
テーブル使う理由の3カラムレイアウトとか
やっとCSS3に含まれることになったから。
www.htmq.com/css3/column-count.shtml
対応しているブラウザはまだないけどなｗ
- 247 名前：仕様書無しさん [2012/01/10(火) 01:29:42.23 ]
- レビューの議事録って誰が書いてる？
レビューされる人(設計を説明する人)？レビューする人(レビューアー)？
- 248 名前：仕様書無しさん mailto:sage [2012/01/10(火) 01:54:55.38 ]
- 特に決めてないけど、される方が書いてるかな。
- 249 名前：仕様書無しさん mailto:sage [2012/01/10(火) 02:06:52.77 ]
- テーブルレイアウトは、方眼紙の延長だわな。
それだけである程度のレイアウトができてしまうから、
それぞれに適した手段を一つ一つ学ぶ手間がかからないので、馬鹿でもなんとかなる。
HTMLは文章や単語に文字で表せない意味付けをするためのもので、
スタイルシートはその文書などの部品をどう配置するか、どういう見た目にするか、
みたいなただのの設定だから、誰でもすぐ覚えれるし、別に難しいことはないはずなんだけどな。
- 250 名前：仕様書無しさん mailto:sage [2012/01/10(火) 02:10:21.59 ]
- >>247
れびゅーいが書いてれびゅーあが確認するって事が多いんじゃないかな
指摘事項とかを書き出して、対応内容まで書いて、対応してるかどうかを確認する、って流れになるだろうし
どうでもいいけど、このレビューイって呼び方がなんかこう好きになれない
ｷｬﾊﾊ ﾚﾋﾞｭｰｲ
- 251 名前：仕様書無しさん mailto:sage [2012/01/10(火) 02:28:18.68 ]
- >>249
CSSには長らく段組という機能が無かった。
また角丸を実現する方法もなかった。
結局は、段組用、角丸用に調整したHTMLを書かないといけず
それを実現するためのテクニック（バッドノウハウ）が必要なので
難しいものとなってる。
CSSは要求するデザインを満たせるものではなかったんだよ。
十数年たってこれからやっとましになるかなってのが現在の状況
- 252 名前：仕様書無しさん mailto:sage [2012/01/10(火) 15:11:04.08 ]
- >>245
なぜそのような発想になるのでしょうか
- 253 名前：仕様書無しさん mailto:sage [2012/01/10(火) 20:28:00.12 ]
- ﾈｽｹの4がﾃﾞﾌｫだった時代のｵｼﾞｻﾝ が、Web全盛期の世の中でHTMLを無視してきたってやばいよ。
たとえ、まったく異なる分野の技術者だったとしてもです。
そんなことだから「どっから覚えたら」などという発想になるんです。
- 254 名前：仕様書無しさん mailto:sage [2012/01/10(火) 20:32:50.83 ]
- ﾈｽｹの4がﾃﾞﾌｫだった時代のｵｼﾞｻﾝなんだけれど
の裏に長年苦労してきて、あんたらの知らないことイッパーイ知ってる俺様
って含みがあるから腹立つ。
↓どうしてこれで止められなかったんだ？HTMLを知らない、それだけでいいじゃん。
HTMLとかCSSとか覚えようとしたらどっから覚えたらいいんだ？
ﾃｰﾌﾞﾙとTRとTDで組むとかでいいの？
- 255 名前：仕様書無しさん mailto:sage [2012/01/10(火) 21:20:09.14 ]
- >>254
お前、病気じゃないか…？
>>245
今時、Webのフリーツール沢山あるんだし、UIライブラリも沢山あるし、適当に中身覗いてみればいいんで無い？
- 256 名前：仕様書名無しさん mailto:sage [2012/01/10(火) 21:53:22.32 ]
- 納品用にhtml印刷した時に目次とページとかフッターとか入れられますか？
- 257 名前：仕様書無しさん mailto:sage [2012/01/11(水) 00:32:30.20 ]
- >>256
CSSでメディアタイプってのがあってそれを使うと画面表示と印刷するときで
ちょっと違う出力に出来る。
- 258 名前：仕様書無しさん mailto:sage [2012/01/11(水) 09:29:40.98 ]
- Officeソフトには、オートシェイプ機能があるけど
HTML形式で、オートシェイプと同じように自由に挿入したり、コメント入れたりできるの？
- 259 名前：仕様書無しさん mailto:sage [2012/01/11(水) 10:12:05.94 ]
- >>258
SVGでやればいいのでは？
- 260 名前：仕様書無しさん mailto:sage [2012/01/11(水) 10:58:59.68 ]
- HTMLの印刷だけはもうやりたくないわ…。今はマシになってんのか？
仕様書というか納品物レベルの印刷ロジック組むのが死ぬほど面倒だった。
一画面一ページで収まるように書かれていれば楽なんだがな。
ページまたぎのテーブルとか死ねる。
- 261 名前：仕様書無しさん mailto:sage [2012/01/11(水) 15:00:13.71 ]
- >>259
SVG対応してるブラウザ少なくない？
それともHTMLで仕様書作るなら、IE9は必須って事なのか？
- 262 名前：仕様書無しさん mailto:sage [2012/01/11(水) 20:04:28.50 ]
- そんなの客と取り決めろよ…
- 263 名前：仕様書無しさん mailto:sage [2012/01/11(水) 20:05:43.30 ]
- HTML使いこなせないのと使いたくない理由で、言い訳並べてないか…？
ドキュメントの媒体なんて臨機応変に使い分けろよ。
- 264 名前：仕様書無しさん mailto:sage [2012/01/11(水) 20:14:04.33 ]
- だからってExcel方眼紙スタイルはないわ
- 265 名前：仕様書無しさん mailto:sage [2012/01/11(水) 20:18:44.11 ]
- 早くて便利なら、理解できる仲間うちで使う分にはいいだろ。
まぁ、俺は使わないけど。
- 266 名前：仕様書無しさん mailto:sage [2012/01/11(水) 20:55:37.15 ]
- xhtml なら簡単に変換できそう。
- 267 名前：仕様書無しさん mailto:sage [2012/01/12(木) 00:23:55.42 ]
- xhtmlは出力形式。
何かからxhtmlに出力するのはありだが、
xhtmlから他の何かに変換するものではない。
なぜならXML（データ）にHTML（人間用文書構造）が含まれた結果
データとして処理しにくくなるからだ。
- 268 名前：仕様書無しさん mailto:sage [2012/01/12(木) 00:56:32.52 ]
- 印刷なんて紙の無駄でしかないと思ってるけど、
印刷が前提ならWordあたり使ってちゃんとやるのが一番手っ取り早いわ
あと、ただの愚痴だけど、番号つき段落で処理途中に挿入されて番号がずれる、みたいなものや
変更点の文字色を変えるような必要になるものを、Excel方眼紙で作るな市ね
- 269 名前：仕様書無しさん mailto:sage [2012/01/12(木) 01:12:45.76 ]
- >>267
さすがに xhtml を直に書きたくはないけれど、
目次付きの印刷品質の pdf にするのは簡単だよ。
見出しも番号を自動で付けてくれるし。
- 270 名前：仕様書無しさん mailto:sage [2012/01/12(木) 08:32:38.92 ]
- >>267
引っ掛かるんです一応言うがxhtmlは、
htmlをxml基準で曖昧さを排除し、
パーサーの簡略化と互換性の強化を目指したものだぞ。
別に人間用情報が入ってても構わん。
そういう部分を分離したけりゃXSLTを使う
- 271 名前：仕様書無しさん mailto:sage [2012/01/12(木) 10:25:06.15 ]
- >>269
rest？興味だけで実用してないんだよな。
ツールはやっぱりSphynx？
- 272 名前：仕様書無しさん mailto:sage [2012/01/13(金) 01:03:38.06 ]
- >>270
曖昧さを排除したからといって扱いやすいとは限らない。
人間用に手を加えたXHTMLはCSSやJavaScriptで
必要なdivやspanがあちこちはいるから純粋なデータではなくなる。
やってみればわかるが、純粋ではないデータ（それはしばしば変更される）
であるXHTMLからXSLTを使って変換するのは苦痛でしかない。
- 273 名前：仕様書無しさん mailto:sage [2012/01/13(金) 17:05:57.86 ]
- 様式に口うるさいヤツいるけど、矛盾点を突くと
「それは別の工程だから」とか「それは前のプロジェクトのでいまはこうだから」
とかいって結局、「いまの自分の書き方が正しいからね、既に書き終えた人は修正してね」の一点張り
- 274 名前：仕様書無しさん mailto:sage [2012/01/13(金) 18:43:45.12 ]
- >>273
それ、お前の理解力が低いだけじゃないよな…？
- 275 名前：仕様書無しさん mailto:sage [2012/01/13(金) 22:23:18.64 ]
- 一度書き終えてOK貰った書類を、全部書き直せなんてマジキチ。デスマじゃん。
- 276 名前：仕様書無しさん mailto:sage [2012/01/14(土) 02:51:22.99 ]
- >>275
書き直しの理由くらい添えてレスしろよ。
- 277 名前：仕様書無しさん mailto:sage [2012/01/14(土) 03:02:21.06 ]
- リクエストパラメータで渡す項目一個一個書いたり、
入力チェックエラー時のメッセージを一個一個書いたり、
これくらいソースだけでいいだろと思ってしまうんだが。
ドキュメントに必要なのは画面イメージと処理フロー図、
簡単な処理詳細と、処理で使うDBのテーブル情報くらいでいいと思うんだが…
- 278 名前：仕様書名無しさん mailto:sage [2012/01/14(土) 03:38:48.42 ]
- >>276
ただ一言、『わかりづらい』という理由だったりする。
ユーザー側の設計者だけでなく、誰が見ても何がどこに書いてあり、内容が即座に理解できるようにと。
- 279 名前：仕様書無しさん mailto:sage [2012/01/14(土) 06:53:39.69 ]
- それは妥当な理由だ。
理解できない書類作る方が無駄な作業だろ？
- 280 名前：仕様書無しさん mailto:sage [2012/01/14(土) 09:29:54.69 ]
- わかってないね
金がとれるドキュメントであることが重要なんだよ
日本のプログラマーは嫌儲なのか
金儲けが下手くそ
- 281 名前：仕様書無しさん mailto:sage [2012/01/14(土) 12:54:34.34 ]
- >>277
パラメータやメッセージは、ちゃんと書かないとプログラム作れないだろ。
不要なのは、項目名の後に項目IDをつけろ、つけるなとか言う文章表現的なものや、
外部設計書なのにプログラマが実装できるように、集計ロジックを書けとか言うもの。
Excel設計書だから、枠から文字がはみ出てるとか、漢字に誤植があるとか…
- 282 名前：仕様書無しさん mailto:sage [2012/01/14(土) 13:00:45.89 ]
- >>278
それは無理難題かもしれないな。
俺も昔やられた。
プログラムと一緒で、ある一定レベルまではわかりやすく書けるのは事実。
(日本語の使い方や、用語の定義の仕方、書く順番等)
ただ、想定する読者の優先度による可読性のトレードオフが発生する。
だから、誰が見ても解るドキュメントなんてない。
まずやるべきは、ドキュメントが誰にどのように使われるのかを定義する事。
次に、前提とする読者の知識レベルを定義。
次に、読者が複数いる場合、優先順位を決める。
相手の立場になって考える事は重要だが、無理なものは無理だ。
から、先に予防線をはる。
そういう文句を言う上司は多い。
- 283 名前：仕様書無しさん mailto:sage [2012/01/14(土) 13:01:43.89 ]
- >>277
何に使われるドキュメントか理解してない事が原因だな
- 284 名前：仕様書無しさん mailto:sage [2012/01/14(土) 13:25:26.71 ]
- そういう見た目や体裁、文体への指摘は、
レビュアー側が自分の好みでレビュー結果のブレが出るから、一概にどっちが悪いとは判断できないな
書式を厳格にするなら、プログラミングでの制約などと同じように
個々の裁量にまかせず仕組みで解決するのが最適解なんだけどな
言語みたいな感じで共通の書式がほしいわ
そういう金に直結しないドキュメント整理に費やす時間が勿体無い
いろんな人が見るようなマニュアルとかだとそりゃちゃんとやるべきだけど
業務系の割と簡単なWebシステムとか、万人が確認するわけでもない
仕様まわりの内部向けドキュメントとかでそういう事繰り返して工数削ってるのは、すごく無駄を感じちゃう
その体裁まわりの時間で、モック作ったりそれでUI検討したり、実装したりテストしたりしたほうが有意義だろうに…
- 285 名前：仕様書名無しさん mailto:sage [2012/01/14(土) 14:00:03.50 ]
- 俺自身は、本当に誰にでも理解できる設計書が存在するとは思ってないが、
受け入れを行う顧客担当者が考える「誰にでも理解できる設計書」を求められる。
結果として、顧客担当者が納得するレベルかどうかを手探りで設計書を作るわけだが、
俺はそいつじゃ無いので、何度も何度もやり直しを喰らうハメになる。
- 286 名前：仕様書無しさん mailto:sage [2012/01/14(土) 15:01:28.91 ]
- >>285
顧客担当者が考える「誰にでも理解できる設計書」の段階で、だいぶ無理があるよな。
審査する人間がどの程度スキルや経験持ってるか分からないから
初心者向けに書くのか、経験者向けに書くのか凄く曖昧なんだよ。
大抵、見積時点では後者向けのドキュメントを想定してるみたいだけど、
開発が進むにつれて人数増えてくると、初心者とかいろんな人間が混じるから、
より詳しいドキュメントが必要になってしまってる現実もある。
俺は、設計書渡されたPEがプログラム作れる最低限必要な条件や項目が記載されていればいいと思ってる。
- 287 名前：仕様書無しさん mailto:sage [2012/01/14(土) 15:03:10.54 ]
- >>285
そもそも顧客担当者が理解不足をドキュメントのせいにしている可能性もあるな…
- 288 名前：仕様書名無しさん mailto:sage [2012/01/14(土) 16:00:50.97 ]
- >>287
担当者いわく、自分なら今まで打ち合わせをしてるから理解できるけど、今後担当が変わった時に仕様が伝わらないような設計書はダメってことらしい。
俺には、人ん家の未来の担当者レベルを予知する能力は無いっての。
- 289 名前：仕様書無しさん mailto:sage [2012/01/14(土) 16:35:55.38 ]
- >>288
具体的に指摘してもらって、そこだけなおせ。
自分で考えろって言われたらそのまま出して、これで解るレベルの奴を雇えって言え。
両方ダメなら殴っていいぞ
- 290 名前：仕様書無しさん mailto:sage [2012/01/14(土) 16:39:53.41 ]
- >>288
レベルの低い担当者だと、自社の業務の流れすら分かってない奴もいるからな。
そんな奴にまで分かる設計書書けとか言われても困るw
- 291 名前：仕様書無しさん mailto:sage [2012/01/14(土) 17:27:53.80 ]
- 説明書とかじゃないんだから、日本語の言い回しレベルでの指摘しかしない奴は、
すぐにでも担当からはずしてほしいわー。
よくそういう指摘をしてる場面を見かけるから、
ああいう人はレビュアーからはずしたほうがいいんじゃないか、って思ってしまう。
レビューする奴が当てにならないときは、わざと間違えた内容を混ぜてみるといいな。
ちゃんと要点を確認する人ならすぐに指摘してくれる。
もし仮に通ってしまっても、そこは後で気づいたことにして再修正かければいいし。
性格悪いやり方だけど、事前に危険回避できるって意味では手のうちだと思う。
- 292 名前：仕様書無しさん mailto:sage [2012/01/15(日) 15:38:38.07 ]
- 誤字脱字はレビュー以前の問題だからな。
勘違いすんなよ。
言い回しへの言及は説明書レベルなら普通にやる。これもレビュー以前の問題だ。
ワザワザレビューで指摘されてんだから有難くおもえ。
- 293 名前：仕様書無しさん mailto:sage [2012/01/15(日) 18:18:25.72 ]
- >>286
> 俺は、設計書渡されたPEがプログラム作れる最低限必要な条件や項目が記載されていればいいと思ってる。
そんな丁寧に書かれた設計書なんて滅多にないけどな。
その業務特有の用語すら説明されていない設計書ばかりだ。
- 294 名前：仕様書無しさん mailto:sage [2012/01/16(月) 00:08:26.23 ]
- プログラム仕様書をA HotDocumentで作るから使い方を調べとけといわれてる
で、やってみたら〜.designer.vbを読み込んでくれない
やり方わかる人いたら、教えてくださいな
- 295 名前：仕様書無しさん mailto:sage [2012/01/16(月) 21:24:11.70 ]
- HotDocumentは仕様書を作るものではなく、
仕様がわからないソフトの解析の
ちょっとしたヘルプができるかな？みたいなもの。
あとは、客にこんなに作りました！って
騙すものだから、
designer.vb程度読めなくても
いいじゃないかアハハハはは
- 296 名前：仕様書無しさん mailto:sage [2012/01/18(水) 11:48:26.13 ]
- >>293
それでどうやってプログラム作ってるの？
- 297 名前：仕様書無しさん mailto:sage [2012/01/18(水) 12:15:35.23 ]
- >>296
知ってる人に聞けばいい。
- 298 名前：仕様書無しさん mailto:sage [2012/01/18(水) 13:37:44.51 ]
- 知ってる人「知らない」(嘘)
とか、平気であるけどな。
人格破壊の負のスパイラル。
- 299 名前：仕様書無しさん mailto:sage [2012/01/18(水) 14:19:36.20 ]
- できるできないじゃない。
やるんだ。
- 300 名前：仕様書無しさん mailto:sage [2012/01/18(水) 16:57:42.59 ]
- >>299さんがこわいです。
- 301 名前：仕様書無しさん mailto:sage [2012/01/18(水) 17:45:14.51 ]
- >>299
とりあえず仕様固めて頂けませんかw
|
 |
