X
ソースコードを日本語訳したレベルの詳細設計書ってどう？ [無断転載禁止]©2ch.net
■ このスレッドは過去ログ倉庫に格納されています
0516仕様書無しさん
垢版 |
2017/10/15(日) 14:11:30.15
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」の和」を代入する。」

という文字列に変換する
同じ考え方で変換規則を作り込んで行けばソースから日本語の仕様書を生成することができる
誰か作ってくれ
0517仕様書無しさん
垢版 |
2017/10/15(日) 17:20:46.45
エクセル設計書って大量の小さいクラスと相性悪いよなぁ
クラスをシートで分けるとシート数大杉だし
ファイルで分けると開くのめんどくさすぎ
0518仕様書無しさん
垢版 |
2017/10/15(日) 17:24:18.00
>>517
Excelかどうかじゃなくて、大量の小さいクラスをいちいち設計書に起こしてるのがバカすぎw
0519仕様書無しさん
垢版 |
2017/10/15(日) 17:28:00.24
>>518
設計書とコードが同期してないとレビューで袋叩きのズタボロにされる
0520仕様書無しさん
垢版 |
2017/10/15(日) 17:30:28.42
大量の小さいクラスに向いた設計の表現方法はないの？
0522仕様書無しさん
垢版 |
2017/10/15(日) 19:13:18.63
>>521
javadocみたいなもの？
0525仕様書無しさん
垢版 |
2017/10/15(日) 22:15:06.32
規約にはしないけどレビューで指摘したら直せよ
0526仕様書無しさん
垢版 |
2017/10/15(日) 22:59:35.81
もちろんですとも現作業終了後ただちに直します
（テストさえ通ってしまえばこっちのもの）
0527仕様書無しさん
垢版 |
2017/10/15(日) 23:04:05.31
レビュアーがマージするからレビュー指摘クリアしないといつまでたっても終わらんぞ
0528仕様書無しさん
垢版 |
2017/10/15(日) 23:08:03.74
そこまでヒマなレビュアーはあんまり見たことない
0529仕様書無しさん
垢版 |
2017/10/16(月) 09:53:25.70
>>526
ソースコードレビュー完了より先にテストっておかしくないかい？
0533仕様書無しさん
垢版 |
2017/10/17(火) 03:50:36.05
>>524
バカが読めないコードはダメって規約ができるのかよw
0535仕様書無しさん
垢版 |
2017/10/17(火) 21:22:01.43
>>534
バカが読めないコードが全部使用禁止になるのか
0536仕様書無しさん
垢版 |
2017/10/17(火) 21:28:48.45
規約とはトレードオフでどちらかに割れるようなお題を片方に寄せるためのものだと思ってた
でも現実には誰もがその判断は間違ってると思っていても逆らえないただの足枷になってしまっている
0537仕様書無しさん
垢版 |
2017/10/17(火) 21:59:56.23
半年間くらいずっとExcelとWordで似たようなコピペ設計書を作る日々を繰り返したことがあるが、
結局その設計書が使われることは無かったな

基本クラスの仕様が少し変わる度に数千あるファイル全て手直ししないといけなくなったので
0538仕様書無しさん
垢版 |
2017/10/17(火) 22:12:19.00
シート[受注]

継承元: 無し

状態変数:
受注番号(文字列(20))
受注日(年月日)
明細(受注明細のリスト)

処理:
受注額取得:
入力:無し
出力:受注額(金額)
処理内容:
明細から(単価*数量)を選択して合計して返す


設計書ってこんな感じでいいんじゃないかな？
みんなどう書いてるの？
0539538
垢版 |
2017/10/17(火) 22:14:43.14
これに加えて綺麗に罫線を引くと見栄えも完璧
0540仕様書無しさん
垢版 |
2017/10/17(火) 22:36:19.54
>>538
1行を10行にするつもりで書いてたわ
おっさん連中は文字が沢山あると嬉しいらしいです

処理内容：
① 合計値を格納する変数totalを宣言する
② ①で宣言した変数totalに0を代入する
③ 明細リストをループする処理に入る
④ 明細から単価と数量を乗算し、①で宣言した変数totalに加算する
⑤ ③明細リストのループが終了
⑥ 変数totalを戻り値に代入する
⑦ 関数を終了する
0541仕様書無しさん
垢版 |
2017/10/17(火) 22:55:53.66
ちょっと聞かせてもらいたいのだけど、商用製品で仕様書や設計書無しで他人に製品評価させるってありなのか？
遅れているじゃ無くて作る予定が無い
0542538
垢版 |
2017/10/17(火) 22:57:14.62
>>540
わかりにくくなってるじゃんw
0543540
垢版 |
2017/10/17(火) 23:48:17.35
>>542
分かりづらいだろ？
更にソースに連番で①～⑦まで処理別に書くんやで

// ① 合計値（ｒｙ
int total;

// ② ①で宣言（ｒｙ
total = 0;
以降続く・・・

半年後、大炎上した
0545仕様書無しさん
垢版 |
2017/10/17(火) 23:53:02.74
インターフェースって設計書に書くと拒否されるから別の言い回しないかな
0549KAC
垢版 |
2017/10/18(水) 00:40:25.31
>>538
それは設計書じゃない。
設計書ってのは、「設計した」結果が記載されるものだ。
0551仕様書無しさん
垢版 |
2017/10/18(水) 07:55:46.69
設計書は標準的なコーダーが施工すれば同じコードが仕上がるようになっていなければならない。
したがって>>1以外の設計書はありえない。
0553KAC
垢版 |
2017/10/18(水) 12:50:50.21
>>550
そうなら、「設計ができていない」と判断するしか無い。
0554仕様書無しさん
垢版 |
2017/10/18(水) 19:11:48.14
「やろうと思えば機械的にソースコードに変換可能」が設計書の定義だろうね
機械的にソースコードに変換できないということは曖昧さが残っているということだ
曖昧な設計は設計ではなくただの妄想
0556仕様書無しさん
垢版 |
2017/10/18(水) 19:32:03.08
つまりスレタイみたいな詳細設計書は無駄ということたな
0557仕様書無しさん
垢版 |
2017/10/18(水) 19:37:20.06
設計書自体は無駄でもそれを書かされてるお前らの苦労を見る事が上流の人達の娯楽になり
結果上流の人達のパフォーマンス向上に貢献する事になる
やっぱりソースコードを日本語訳したレベルの詳細設計書は必要悪なんだよ
0558仕様書無しさん
垢版 |
2017/10/18(水) 19:46:58.40
抜け毛が増えてきた
いやだ
ハゲたくない
だれか助けてくれ
0559仕様書無しさん
垢版 |
2017/10/18(水) 20:20:39.17
>>557
設計書は生成してるんだなぁ
工数なしで費用だけ頂いてすいやせんね
0560仕様書無しさん
垢版 |
2017/10/18(水) 20:21:08.73
そうやっていつも他力本願だからハゲるんだよ
0562仕様書無しさん
垢版 |
2017/10/18(水) 20:33:14.70
切っても剃ってもハゲはハゲ
0563仕様書無しさん
垢版 |
2017/10/18(水) 21:03:09.78
ハゲないためにDNAというソースコードを修正せねばなるまい
0565仕様書無しさん
垢版 |
2017/10/18(水) 21:19:09.87
DNAにどれだけ無数の欠陥があろうともハゲだけは受け入れる事はできない
0567仕様書無しさん
垢版 |
2017/10/18(水) 22:09:53.46
>>558
ハゲはどうせ帰っても抜け毛を数えるぐらいしかやることないだろうから、毎日終電までサビ残して経済に貢献しろ
0568仕様書無しさん
垢版 |
2017/10/18(水) 22:15:06.16
ハゲだが帰宅したら楽しいクッキングタイムだ
抜け毛を数えてる暇はない
0573仕様書無しさん
垢版 |
2017/10/19(木) 07:17:31.60
ソースと対の詳細設計書はもちろんソースコード一行一行にもコメント書くんやで
0574仕様書無しさん
垢版 |
2017/10/19(木) 07:46:09.81
シェルスクリプトを書けるようにならないといけなくなって、本を一冊買った
サンプルコードの一行一行に、これはなにをしているというのがコメントで書かれていた
ありがたかった
0575仕様書無しさん
垢版 |
2017/10/19(木) 07:52:27.42
>>573
メソッドドキュメントコメントにも詳細な処理内容を書かなきゃ
0576仕様書無しさん
垢版 |
2017/10/19(木) 22:29:58.97
>>574
マジレスすると、それはコードの意味がわからない人に
一行一行「説明してくれる」のがありがたいのであって
一行一行「コメントしてくれる」のがありがたいわけじゃない

コードが読める人＝例えば英語が読める人
に対して、一単語ずつ意味を説明されてもうざいだけ
0578仕様書無しさん
垢版 |
2017/10/19(木) 22:59:47.22
>>576
お前のようなできるプログラマでも、そんなダサいコメントだらけのコードに関わることがあるのか？
0579仕様書無しさん
垢版 |
2017/10/19(木) 23:10:30.51
>>578
そりゃあるだろ？
一人でプログラミングしてるわけじゃないんだ。
十数年前の学生の頃に、そんなコード書いていたやつがいたんだよ
0580仕様書無しさん
垢版 |
2017/10/19(木) 23:22:58.36
すべての行にコメントがついてるアセンブラコードとかあったな
0583KAC
垢版 |
2017/10/19(木) 23:53:57.26
詳細設計書がしっかりしてるならコメントは不要。
少なくとも、このスレでコメント云々語るのはすれ違い。
0586仕様書無しさん
垢版 |
2017/10/20(金) 12:25:31.97
だがしっかりしたコードはこの世に存在しないので詳細設計書は必要
0589仕様書無しさん
垢版 |
2017/10/21(土) 00:56:33.91
詳細設計って何を指しているんだろう？
機能仕様の下位に位置するドキュメントかな？
どんなにコードがしっかりしていても、プログラム全体を把握するドキュメントは必要と思う。
ブロック図、シーケンス図、状態遷移図等。
0590KAC
垢版 |
2017/10/21(土) 02:25:10.36
>>589
詳細設計という概念が考えられた時代を考慮に入れるとおのずと解る
0591仕様書無しさん
垢版 |
2017/10/21(土) 06:33:38.80
ビルドコストランコストが高すぎたんだ
だから設計書を書くしかなかった
つまり現代では不要
0592仕様書無しさん
垢版 |
2017/10/21(土) 06:41:36.35
>>589
殆どのシステムはコンテキストマップがあればあとはコードとドキュメントコメントで十分
概念が複雑なものはUMLに頼らずそれを表現する的確なモデルを作る
例えば剛体シミュレータを作るのにUMLは最適解じゃないだろ
まず必要なものは物理数学モデルだ
0594仕様書無しさん
垢版 |
2017/10/22(日) 23:03:17.29
訳のわからない言い訳ばかり言ってないで設計書書け底辺共
0595仕様書無しさん
垢版 |
2017/10/22(日) 23:22:59.85
今時になって設計書なんか書いてる底辺がなんか言ってる
0596仕様書無しさん
垢版 |
2017/10/22(日) 23:44:41.58
>>593
じゃあ今まではValueObjectを使ってなかったがために設計書が必要になってたのか

意味わからんなw
どういう設計書を書いてたんだよw
0597仕様書無しさん
垢版 |
2017/10/22(日) 23:54:55.54
>>596
そうだよ
ValueObjectを使っていなかったから基本的な型のロジックがあちこちに分散して制御不能になってた
それを設計書でどうにかして誤魔化そうとしていた
0598仕様書無しさん
垢版 |
2017/10/23(月) 02:32:58.82
Value Objectって言いたかっただけだろ。
はやくフローチャートを書く仕事に戻れよw
0599仕様書無しさん
垢版 |
2017/10/23(月) 18:51:21.76
誰も読まない設計書をサビ残で仕上げてこそ底辺プログラマ

苦痛を与えることに意味がある
0600仕様書無しさん
垢版 |
2017/10/23(月) 18:56:13.87
詳細設計書は誤字脱字なく書け

コード一行にコメントを書け

メソッドドキュメントコメントには処理フローを書け

だから、みなし残業60時間用意しとるんやからな
0601仕様書無しさん
垢版 |
2017/10/23(月) 19:34:04.93
>>600
自動生成できるものに数倍の工数を使えて嬉しいね
楽して稼げるから下請けとしては助かりますわ
え？手書き？またまたご冗談を…
0602仕様書無しさん
垢版 |
2017/10/23(月) 19:37:42.65
自動生成遅っwwww
ゼンマイ式コンピューターでも使ってんのか>>601の会社はw
0604仕様書無しさん
垢版 |
2017/10/28(土) 15:27:16.31
機械的にソースコードに変換可能
か

ならばそれをコンパイルすれば？
と笑ってしまうww
0605仕様書無しさん
垢版 |
2017/10/28(土) 15:56:25.70
某社の製品でエクセル設計書をプログラムに変換可能とか宣伝してたから文書読んだら
形式固定の表データからコード生成&ビルドするだけで笑わせてもらった
エクセルVBAと大差ない
0606仕様書無しさん
垢版 |
2017/10/28(土) 16:09:33.89
笑うポイントがおかしい人ってキモいよねw
0608仕様書無しさん
垢版 |
2017/10/28(土) 19:01:43.26
笑うポイントがおかしい自覚がある人にアンカされとるwキモw
0610仕様書無しさん
垢版 |
2017/10/29(日) 01:43:34.94
「神掛かりのパフォーマンスを出すモノを見た」が
「どうやってそれを実現したのか私にはわからない」から
「形式を模倣」することに徹する

に陥るのはこの世の常じゃあないのか？
で、最終的には見た目バンザイと
0611仕様書無しさん
垢版 |
2017/10/29(日) 01:47:57.16
個人的にコードジェネレータを勧めたいひとは

「ぶっちゃけあなた同じ事やってるんでしょ」かつ
「それでメシ食えてるから今後もずっとそれをやっていきたいんでしょ」のうえ
「相手がいうことは正しいか間違ってるかを知りたいんじゃなくて、個人的にキモチイイ見え方かどうかだけが価値判断基準の人」かなぁ

つまり、プログラミングとか好きじゃないのね、でも立場上ブログラマとかSEの類なんス
そういう条件そろってる人割と多いからコードジェネレータ勧めることよくある
0612仕様書無しさん
垢版 |
2017/10/29(日) 08:47:24.23
設計書の通りにプログラムを書けと言って上流から渡される細かすぎる(その割に誤算だらけの)設計書に対する皮肉として
設計書の通りで本当に動くならコードジェネレーターでも作ればいいんじゃね？と皮肉で返したのが始まり
本当に設計書からコードを生成しようとは別に誰も考えていない
0613仕様書無しさん
垢版 |
2017/10/29(日) 08:52:34.70
そもそも設計書の通りにコード書けるならコード要らなくね？
設計書からマシン語作れば解決
0614仕様書無しさん
垢版 |
2017/10/29(日) 08:54:41.76
コードを読めない人の為に設計書を書く
なら解らんでもない
0615仕様書無しさん
垢版 |
2017/10/29(日) 09:01:24.46
設計には業務知識だけでなくプログラミングの領域の要素も入ってこざるを得ない
プログラミングの素人がリポジトリとかサービスとかインターフェースとかパッケージとかイベントとかインフラストラクチャーとかコントローラーとかビューとか言われたとして果たして正しく理解できるだろうか
プログラムを読めない人は設計書も正しく読めない
そんな人は最初から相手にするだけ時間の無駄だ
0616仕様書無しさん
垢版 |
2017/10/29(日) 09:07:17.81
バカ上司「プログラムをそのまま日本語したものが設計書だ。
お客様はプログラムは読めないが日本語化したものなら読める」

僕「識別子を日本語化してキーワードをマクロで日本語化すれば素人でも読めるってこと？」

バカ上司「うるさい。設計書は納品物なんだから文句言わず作れ」
■ このスレッドは過去ログ倉庫に格納されています
ニューススポーツなんでも実況