仕様書の書き方

1 ：07/10/08 〜 最終レス ：11/12/04

なんか客がプログラム１行単位の精度での仕様書を
工数無しで作成する（プログラム作りながら書けば時間いらないってさ）ことを求めてくるんだけど
なんかいい手ないですか？

2 ：

>>1
お前の言う工数ってなんだ？

3 ：

コウ・スー（在日）

4 ：

断れよ。

5 ：

関数の仕様だけじゃなくて
中身のアルゴリズムまで仕様書に書かなきゃいけないんですけど
なんかいい手ありますかね？

6 ：

仕様書の提出を拒否する。

7 ：

>>6
それは会社との契約が請負いになってるらしく駄目らしいんだけど（つっても俺１人だけどｗ）
うーんどうしたものか・・・
なんかソースを１行単位で反映できて楽につくれる仕様書ってないもんでしょうか？

8 ：

なでしこで書けよ

9 ：

ぶっちゃけ、できてるよーな？できてないよーな？出来でもその場を誤魔化せればおｋなんですけどｗ
だってどういうフォーマットでどう書くって決まって無いから
フィーリングでいいとか悪いとか決まってるわけです

10 ：

ソースを仕様書として提出する。

11 ：

>>10
フィーリングだからそういう誤魔化し方はよろしくない
とりあえず形としてあればいいわけで・・・って感じではある

12 ：

俺何回発言しているんだろ・・・
＞工数無しで作成する（プログラム作りながら書けば時間いらないってさ）ことを求めてくるんだけど
これを拒否しろ
「プログラム読みながら脳内で仕様書作れば、わざわざ作る必要ないでしょ？」とでも言い返せ

13 ：

>>12
向こうはフィーリング主義なんでそんな喧嘩腰じゃなくて
なんかいい方法ないすかね？
無難にやっておけば無難に乗り切れる状況でもありましてですね・・・

14 ：

ソース読めないからだろ
というより、日本語に直せば読めると思ってるんだろ
わざとわかりにくいサンプルつくって、こんなのホントに必要ですか？
とでも聞くといいのでは？

15 ：

無難に？なにいってんのお前
マやめろ今すぐ

16 ：

>>14
形式的にも（納品物としても）必要なので納めなきゃならんことはならんのですが・・・

17 ：

必要なので必要です、とかわけのわからない思考パターンが
デスマから何から全ての元凶であることに気付や

18 ：

>>17
デスマーチにはなってないですよ

19 ：

一般論ってわかるか？

20 ：

>>19
通用しないことは認識してます

21 ：

何が通用なのかわからん
会話が成り立たなくなってきた

22 ：

(1)工数を要求する
(2)こんなもんになりますけど、ほんとに欲しいですか？と(4)で一部を作って尋ねる。
(3)こんなもんになりますけど、ほんとに欲しいですか？と(5)で一部を作って尋ねる。
(4)日本語にならないような思いついた言葉で文章を書く
(5)きっちりと時間をかけて書く

23 ：

単にソースのif→もし、とか置換して仕様書として提出すれば？

24 ：

まあ、仕様書をなんとなく書いてあるよなないような
ひっぱれればいいわけです

25 ：

// aを1で初期化する
int a=1;
// もしaが1であれば
if( a == 1 ) {
// "OK\n"を表示する
printf("OK\n");
}
こんな感じで延々と続いて何が楽しいのか

26 ：

>>25
int a=1; // a=1する
if( a == 1 ) { // もし a==1 なら
printf("OK\n");　// OK
}
...なんか変換ツール作れば出来るか？

27 ：

>>1の使用言語が分からんことにはなんとも

28 ：

>>1の日本語力では、仕様書を書かない方がいい気がする

29 ：

伝言ゲームになってない？

30 ：

>>29
なっていません。超能力試験になってます。

31 ：

>プログラム1行単位の精度
>工数なし
これは、生ソースを渡してくれって事じゃないのか？
へたに仕様書に起こすと実際の誤差出てくるし、指定言語とコーディング規約に則れば問題ないと思うんだけど。
向こうがソース読めないなら行単位の仕様書渡しても意味ないわけで。

32 ：

>>31
ソースだとわからないから日本語にしてほしいって感じ
日本語なら意味がわからないところを突っ込めるでしょ？
指定の言語はＣ言語だけどコーディング規約もなにも一切無しって感じ
要求仕様書（と言っても簡単なメモ書き程度のものなんだが）がどのソースのどこと一致してるかも
書いてくれとか非常にわけわからんもの要求しててソース書くより時間がかかってる状態
早い話ソースよめない人にも読んだだけでアルゴリズムが理解できて要求仕様書とも繋がるもんで
さらに設定値や変数の１つ１つが何を指しているのかわかるようにしてくれって
要求してるので割りに合わないもん要求してやがるなって状態
ちなみにその職場、プログラマいないし（まともなプログラマなんていなさそうだし）
ソースの書き方が悪いからソース読んでも俺等が理解できないんだとでもいいたさそう・・・
アフォらしいから１回１回テキトーに書いて見てツッコミあった箇所だけ修正して→繰り返し
ってのをテキトーに続けてる、まあ、お金はもらえるし文句いう立場でもないな
ただ、毎日毎日ガミガミガミガミうるさいったらないｗ

33 ：

フォローチャートと擬似言語を書けって事じゃね？

34 ：

対象になるソースの規模はどれぐらい？

35 ：

>>34
２万ぐらいかな？
規模自体はそんなでかくないんだけど俺１人しかいない上に通常の業務もあるんだよもん

36 ：

マジレスするとWBSを作る必要があるんじゃないかな？

37 ：

>>36
駄目だろｗ
だってあからさまに間に合わないスケジュールをぼかして
なんとか間に合うように見せてるのがバレバレなわけだしｗ

38 ：

今回の役には立たないとは思うけど、こういうのがあるな
文芸的プログラミング
http://www.amazon.co.jp/dp/4756101909/
http://ja.wikipedia.org/wiki/%E6%96%87%E8%8A%B8%E7%9A%84%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0

39 ：

フローチャートを渡せば良いだろ

40 ：

>>39
ソースみたほうが早いｗ
ソースから起こしたフローチャートも、
フローチャートから起こしたソースも
どっちも似たような検証いるからなｗ
いみねーｗ

41 ：

>>1
そんな仕様書は意味がない。

42 ：

>>1
ソース１行ごとにコメント付けて、
最後はgrepで行コメントだけ抜き出して、
ワード、エクセルに貼り付けて体裁整えればいいんじゃないか。
たぶん客は全パス通過テストのチェックシート用とかに使いたいんじゃないか。

43 ：

特別なご要望は追加費用になります

44 ：

>>42が一番ベストじゃまいか？
コメントに何を書いたかまでは問われないだろうしw

45 ：

１行１行に対する説明をコメントで書けばいいじゃん。
全体的な処理の流れは書かないのがコツ。

46 ：

まぁ各行にコメントを書いたものを抽出する形にしても、客は納得しないだろうな。
おそらく、日本語＆フローチャート化して渡せってことだろう。
マルチスレッドだったらるなｗ

47 ：

dumplistをそのまま提出しろよ

48 ：

つーかさ
仕様書なんてプログラムを組むために、渡されるものだろ
ゲームならプランナとかディレクタから、システム設計なら発注者から
ここで言われてるのは仕様書ではなくて、プログラムの解説書の事としか思えん
んなもん作るなら工数三倍がけでもして渡せ
文句言われるなら断れ
乞食になるな
うっとうしい

49 ：

>>48
こいつ、どんな会社で仕事してるんだ・・・

50 ：

むかしむかし、コンパイルリストというものがありましたとさ。
マクロ等等が展開された後のソースプログラムの帳票なんだけど、この帳票の重さでプログラムの値段が決まっていましたとさ。
客って超大手かコボラーじゃね？

51 ：

COBOLの現場では今でもソース一行単位の精度をもった仕様書が要求されてるよ

52 ：

世の中いろんな仕事があるもんさ。
しかし、少なくとも俺はソースと設計書が同期を取られているシステムを見たことねぇｗ
そりゃー、部分的には同期取られてることもあろうさ。
しかし、丸々一本のシステムがそのような状態になっているのみたことね！

53 ：

汎用機の現場へ行けば嫌ほど見せられる

54 ：

ステップ数単価でやってんのか

55 ：

変な文章
http://www3.toshiba.co.jp/hdd-dvd/products/hddvd/info/HDDVD_080219.html
> さて、弊社は、

56 ：

http://www.hotdocument.net/
じゃだめ？？

57 ：

おれ、>>1と同じことやらされてる・・・
仕様書なしで書きなぐったソースコードを、プログラムやったことない人間が「満足する」解説資料に起こすわけで・・・

58 ：

フローチャートを書けばいい。

59 ：

先生ノ
最初から最後まで、どこにも切れ目が入れられません

60 ：

マシン語でおk

61 ：

　　　　　　　　　　　 ＿
　　　　　　　 r-､' ´　　 ｀ヽr-､
　　　　　　　ｨ7　/l: ハヽﾊ ﾄヾ 　　 駄スレを沈めることは、この俺が許さん！
　　　　　　　 '|l |'´_`　´_ ｀| || 　　　信念に基づいて行動する。
　　　　　　　 |　|´ﾋ} 　 ﾋ}｀! l|　　　それを人は正義と言う。
　　　__ノﾞ).　从 l,　　_'_. 　|从　　　今俺が行ってることは、荒らしではない。
　,_'（＿ ﾉ_ヽ　ヾl.＞ - ,イ;ﾘ　　　　正義という名の粛清だぁ！
　{ f:ﾃ} {'f:ﾃ}',／＼ヽ--/／ヽ 　　　
　ヽ,r─‐ ､ｨ .､､ i l＞Y＜! i　'､ 　　　バーニング！
　/ iゝ＿ﾉ iヽ　/l　　 |l　　l 　 ',
　lﾝヽ/ムノじ

62 ：

http://www.google.co.jp/search?hl=ja&source=hp&q=basic%E8%AA%8D%E8%A8%BC+windows7&lr=&aq=5&aqi=g9g-m1&aql=&oq=basic%E8%AA%8D%E8%A8%BC%E3%80%80w&gs_rfai=

63 ：

>>51
設計者がロジックを記載しないとダメって言われてワロたw
それはPGの裁量じゃね？ww

64 ：

うちのPM、機能に関する指示でサクサクとかツーっととか連発。
俺はテレパスじゃないから、マジわからん。
でも朝礼の進捗チェックで画面デモ見せると、指さして「ナニコレw」とか笑うんだ。
ジョブズ信者ってみんなああなのか？

65 ：

⊂二二二(　^ω^)二⊃ﾌﾞｰﾝ

66 ：

しっかりコメント入れて、Doxygenで自動生成したものを提出すればOK。

67 ：

実装依存

68 ：

>>10
頭いいな

69 ：

>>32
プログラム知らない人向けにコア機能のプログラムを一行単位で書いたことあるが
そんときは客がまともだったから事情を説明して別途で工数もらったが

70 ：11/12/04

>>1
アホのIBMがおんなじこと言ってて爆笑した
「あとでツールに通したら仕様書を自動で作れっから
ソース一行ごとにコメント１ずつ書いとけ」とか言ってんの
できたもの見たら絶対に使えないようなゴミドキュメントができててざまあって思ったね