ソースコードを日本語訳したレベルの詳細設計書ってどう？

>>655
お前みたいな下請けはコストのことなんて気にしなくてよろしい
ゴミを作るのにかけたコストはどうせ元請けが支払ってくれるんだから

コードを読めない人の為に設計書を書く
なら解らんでもない

せ、セロリン？ってやつ使ってます

まぁ日本には「仕様書に価値がある」ということで
Σプロジェクト（コードジェネレータ + 専用OS・ハード開発）を試みてオオゴケしたとか
日本は世界に先駆けて積極的に業務でコードジェネレータ使ったとか(主に金融とか自治体のフレームワーク用）
そういう独特の文化がある

日本のSIにおけるドキュメント重い問題の解決策は今のところ
「仕様書からコードを生成する超高速開発ツールの使用」以外ないと思う
まぁ「超高速開発」のアレはAccessのアレ程度の機能しかないんで
規模が大きくなるとみずほになるが

うちでも似たようなツール作ったけどリーダーが空気読んで
先にお伺いたてて指摘にはのせなかった

その会社はきっちりやってたように見えた、
ただ欠点といえばそこのリーダーの顔が今でいうコミュ障っぽくてたよりなさそうだったんだ

そのときに世界の不条理を学んだ

>>498
なんかうまい事言ってるつもりらしいけどどうしてそうなるのさサッパリ理解できんwすまんなw

意味わからんだろ？
所詮その程度の頭ってことだ

ソースコードをただ日本語訳したようなものは設計書ではない。

そんな設計書があるなら、それは設計自体がおかしい。

sum = sum + 1;

これををパースして

assign(
var(“sum”),
add(
var(“sum”),
const(1)
)
)

こんな構文木を作る
辞書に{ “sum”: “合計” }を登録する
構文木を文字列に変換する

const(1) -> 「1」
var(“sum”) -> 「合計」
add(a, b) -> 「aとbの和」
assign(a, b) -> 「aにbを代入する。」

つまり

「「合計」に「「合計」と「1」の和」を代入する。」

という文字列に変換する
同じ考え方で変換規則を作り込んで行けばソースから日本語の仕様書を生成することができる
誰か作ってくれ

それは構成仕様

>>296
カスしかいない職場で働いてるんだな
かわいそうに

入社したばかりの新卒が作ったシステムです
高いのは仕方ないでしょう？

とか言うつもりかｗｗｗ

レビュアーがマージするからレビュー指摘クリアしないといつまでたっても終わらんぞ

>>114
> 顧客との同意書ではなく、顧客の業務知識をより正確にコードに反映させるためのツール
> 詳細設計書ってのはそういうものだ

実際には伝言ゲームで間に一人増えただけだけどなｗ

業務知識を正確に反映させるためには、顧客が直接プログラミングするのがいい。
当たり前だろ？コミュニケーションの数は少なければ少ないほどより正確なる。

それができないなら、顧客とプログラマが直接やり取りする。
その時に使うコミュニケーションツールは両者がわかるものでなければ意味がない。
これも当たり前だろ？

じゃあ詳細設計書は顧客が理解できるのか？って話。顧客は詳細設計書を理解できない。
つまり詳細設計書では顧客の業務知識を正確にコードに反映させることは出来ない。

詳細設計書でできることは詳細設計書を書いたやつと、それを見るやつの
コミュニケーションツールだよ。けっして顧客の業務知識を伝えられるもの
なんて思ってはいけない。

あれ使うなこれ使うなって使用禁止令が

>>294
仕事でコード書いたことないんだろうな
コメントはコードと同期しないし
コメントを書き換えるのが面倒だからと変な修正をする奴も居る
プライベートのリポジトリ以外ではコメントを禁止した方が良いぞ

白紙の設計書と空のプロジェクトを同期させる
あとは変更を二重に適用管理するだけ

ん？これもう片方だけでいいんじゃないの？

ハゲに人権なし

アジャイルなんてただのプロセスだからね
導入したからってお前らの能力が上がるわけでもない

>>234
何言ってんの?
浸透してたら除くって日本語分からんのか?
それに当然分かりやすいなら何の問題も無い。
しかし少なくともPseudocodeが分からなかった奴も擬似コードは分かってたわけだよな。
つまりその時点では意志疎通という意味では擬似コードの方が優秀だったわけだ。
にもかかわらず”常識”とか言うから言われちゃうんじゃ無いの?俺みたいな奴に。

あとやたらプロジェクトって言葉を使う奴も地雷臭がするな。
お前1人でチマチマやってるのの何がプロジェクトだよって言いたくなる。
当然、それなりの規模ならプロジェクトで問題ないけど。

自分を大きく見せようとする奴は要注意。

>>88
> 自動生成できるほど詳細な設計書から自動生成したコードは整合性が取れないから動かないことがほぼ保証される

なんで自動生成したコードを書き換えるんｗ
自動生成できるなら書き換える必要が無いはずだ。

自動生成できずに、手動で書き換えるから
整合性が取れなくなってんだろｗ

いい加減設計書からコードは自動生成できないって認めてしまえよ。
そしてその理由が、設計書には情報が足りてないからだって理解しろ。
自動生成が悪なんじゃないんだよ。（例えばソースコードからバイナリの生成は自動化できてる）

その元となる設計書の存在が悪なんだよ。

pseudo code

未だにウォーターフォールモデルで開発やってんのか

>>636
要するに君が下手くそなんだよ
実装が手続き汚染されるのは手続き脳から離れられないから(頭が硬い)
責務を全うするのにいらんメソッドなんかない
インターフェースがあるから影響範囲を最小化できる
ダメージが軽微なうちから修正しながら進めるから修正コストが最小化される
OOPに必要なドキュメントは詳細設計書ではなくストーリー

詳細設計書つくるんならソースでもきれいにして桶

>>579
十数年前のことをよくもまぁ飽きずに何度も語れるもんだw

R&D部門だとよくあるけど

>>196
手書きで書いた図をスマホで撮って貼り付けしたらいいんじゃないか？

「僕ちゃんは絶対正しいの！白いカラスはいるの！！」
プログラマーってこんなんばっか

細かすぎる設計書でもあるだけマシだろ
現実世界の詳細設計書は細かすぎるどころかスカスカのゴミじゃねえか
上流が悉く仕事をしていないからな
細かすぎるなんて贅沢な不満なら言ってみたいわ

>>357
「限られる」のほうやね

例えば「あなたへのオススメ: ドラッガーを読んでも勝てないと悟った女子マネージャーが肉体を駆使したら」
みたいなレコメンドエンジンつけようとしたら死ぬと思う

　　　　　　　　　　　　　 ミﾐ ヽヽヽヽﾘﾘﾉﾉノノ
　　　　　　　　　　　　　ミ　　 ,,､,､,､,､,､,､,､､ 彡 ／￣`Y ￣ヽ
　　　　　　　　　　　　　 l 　i”” 　　　　　　　i彡/ / / l | | lヽヽ
　　　　　　　　　　　　　.|　」　　　⌒’　’⌒　　|/ //　⌒　 ⌒ヽ
　　　　　　　　　　　　 ,ｒ-/　　 -･=-, ､-･=-　||/　 （●） （●）
　　　　　　　　　　　　 l　 　　 　 ﾉ( ､_, )ヽ　　|| | 　　⌒　･ｨ　 ヽ
　　　　　　　　　　　 　 ｰ’ 　　 ノ､＿_!!＿,.　　||　　　ﾄ-＝-ｧ　ﾉ
　　　　　　　　　　　　　　|.　　 　 ヽニﾆｿ　　 l |　　　|-ｒ ､/　/|
　　　　　　　　　　　　　　ヽ 　 　　　　　 　 /.|| | ＼＿｀ﾆ’_／ ||
　　　　　　　　　　/⌒＼〆⌒ヽ”ーー”　⌒ヽ／⌒ヽ ＿ﾉ　　　　　　　　　　
　　　　　　　　　../　　ﾉつ＼　・　　　　　・　／＿人.　ヽ /　　　　　
　　ｸﾞｯﾎﾟ o0○/　 /(　3　　＼　　∩　　／　`-と　)　○0o　　　　　　　　　
　　　　　　(　　`　/､＿ﾉヽ 　　　 (:::)(:::) 　　　/＿ﾉ’ ‘! 　　)゜
　　　　　　　＼＿)　　　　|　　　: : : __　　 : : :｜　　ノ(＿ノ
　　　　　ｸﾞｯﾎﾟ　　 　((　　ヽ＿＿　|　| ＿＿ノ　／　　　　　))　　　
　　　　　　　　　　　　／ ⌒　　　 (:::)(:::)　　　　⌒ー―、
　　　　　　　( ⌒￣￣　　　　　　　人　　　　　　　　　　ヽ　
　　　　　　　＼　　＼__＿＿＿＿ノ　ヽ＿＿＿＿.／　 　)　　.＿_/￣/　　　/二二二/_　　/”’７　　　 /￣ ￣/　 /￣/　/”’７
.　　　　　　　　＼　　＼　　　　　　　　　　　　　　／　　／ 　/___. 　　￣./ /　＿＿　　/　 /　/　___ / ￣　 ￣/　 ￣　　/　./　
　　　　　　　　　　＼　　＼　　　　　　　　　　　／　　／　　　　ノ /　/i￣!.￣　 __,ノ　/ 　/　/_ノ / ‾/　/二,.´ 　＿___.ノ　./　
　　　　　　　　　　ε(　￣￣)　　　　　　　　　(￣￣　)3 　　/_,./__./ ヽ､_>　　/____,／　/＿____,.ノ　i＿＿__/ 　/＿_____.／

図が書けないじゃんってことじゃね

>>346
自己紹介乙

>>239
fizzbuzzでもプロジェクトだけど？
訳のわからんオレオレ定義振りかざして何言っちゃってんのお前ｗ

そもそも詳細設計書ってひとくくりにして議論するのが間違いですよね
唯一普遍の詳細設計書など存在しないのだから、うちの会社ではこうしてます、へえそうなんですか、以上の議論はできません
以上をもちまして、このディスカッションは閉じさせて頂きます
以後、書き込みは控えてください

さあ盛り下がってしまいました↓

>>378
だから案件によるとしか・・・。
小規模で責任がない案件ならいいんだけどね。
アジャイルのデメリットは品質を担保する機能が小さいかまったく無いってとこなんだよ。
だからそのシステムを知ってる人間を業務に縛りつけてしまう。
俺なんか1月1日に女房子供置いて実家から東京に始発の新幹線で戻ったこともあるよ。
しんどいぞアレは。

図を生成するコードとデータを書く
なお製品コードより複雑な模様

自動生成遅っwwww
ゼンマイ式コンピューターでも使ってんのか>>601の会社はw

どうやら「僕が考えた最強の設計書」のようだけど残念ながら意味不明

基本設計書は「こう作ります」ってのを書いて
詳細設計書はどこの会社でも書くところはもうソース貼り付けろよってレベルのもんを
深夜残業して書かされたな
ぶっちゃけ詳細設計書はソース書いてから作ったほうが早い気がする

そもそもこの粒度で詳細設計書を書くことは絶対見積りに入ってないし
おそらく詳細設計書は作るだけで検討などしてる時間はないのではないか?

という経験から詳細設計書は基本設計書とソースのつなぎをする程度の内容でいいのではないかと思う

クラス図→絶対役に立たない
シーケンス図→何も表現できない
処理フロー→ソース見たほうが早い

詳細設計書によくある項目って全部役に立たない

>>207
お前は無能

詳細設計書がしっかりしてるならコメントは不要。
少なくとも、このスレでコメント云々語るのはすれ違い。

>>93
話が変な方向に飛躍しているな。
本来の詳細設計書とは、
「コードに書くだけでいい」というレベルの記載がされているものをさす。

設計書からコードが起こせないというのはお前の勝手な思いこみ。

コードだと複数ファイルを開き処理を追わなければ関連やシーケンスが見えてこない
絵に書いておけば紙一枚眺めるだけで一瞬で内容を理解できる
コードが設計として役に立つのはメソッドまでだよ
メソッド程度のサイズならコードの方が早く理解できて正確である事が多いことを認めよう

いきなりエクセル使って設計すんな。
なんどもエクセル書き直して
恥ずかしいと思わんのか？

酒でもくらいながら書いてんじゃないよな

>>484
もちろん派遣のプログラマが直すよ
俺らはチェックして可否を出すだけ

入出力

>>472
それは仕様バクだから仕様書変更しろよ？

黒塗りの四角と白抜きの四角でドット絵でどうだ
フォントを小さくすれば滑らかで美しいグラフィックになる

アジャイルというかプログラミングの基本である分割統治を徹底するだけだろ
丸ごと設計して丸ごと実装っていう流れがいかにアホなことか
サービスをコンテキストで分割してそれぞれアジャイルで回して行けばいいんだよ

バグ報告
プログラムを使いデバッグ
プログラムの修正箇所を特定する
仕様書の1対1に対応する箇所を修正する
プログラムの1対1で対応する箇所を修正
(あくまで仕様書の変更を元にプログラムを修正するので、デバッグで得た知識が無くても修正できなければならない)
プログラムをテスト
仕様書とプログラムを同時にマージ

アホくさ

>>164
背伸びしたい年頃なのはわかるよ

上は上で規約を提示してしつこく言っときながら
フォーマットの誤りをツールで洗い出して全部指摘した会社があったんだけど
ありがとうございますすごいですねーとか言いながらそこが真っ先に切られた

結果レビューで規約を気にするものは誰もいなくなりましたとさ

がんばって一杯指摘はしたが、一体何の仕事をしたのか今もってわからない

>アジャイルならその辺のサラリーマンPGでもいいシステムを作れるようになる
それはどうだろう?
Agileな仕組みで回そうとしたら開発者に求められるスキルもそれなりに必要。
ただ全員高いスキルが必要なわけでもないし、ナレッジシェアもしやすいけどね。

うちに会社（メーカー）はウォーターフォールで開発。
アジャイルにしたらもっと良い製品作れるかな？

>>631
アホか
お前の使ってる開発環境は静的解析もできない欠陥品かよ

>>300
やり直すわけないだろ
バカか？
コメント消したらなぜか動かないとかいつの時代だよ
ていうかビルドと自動テストで十分なレベルだろ

>>151
設計なんてディレクトリツリーを見ればわかることだよ

設計書はアート

改修の一番最初の段階（現場レベル）ってのは
既存バグの修正やリファクタリングだろ？

要件曖昧ズブズブなお仕事
楽しいです(^q^)

レビュアーが詳細設計書を基準に指摘する気力がなくなるぐらい
仕様書ガン無視して要件定義から実装

でつね（笑）

>>578
そりゃあるだろ？
一人でプログラミングしてるわけじゃないんだ。
十数年前の学生の頃に、そんなコード書いていたやつがいたんだよ

まだお前らウォーターフォールモデルで開発してんのか

上司が無能の原因の7割は部下が無能で動かす手足がないからだもんな
無能集団じゃ誰がリーダーやったって変わらんよ
日本の政治を見ればわかるだろ

おれの経験では、
詳細設計書に３日かけたところは、
ソースを打ち込むのは１時間とか、
そんな感じ。