X
ソースコードを日本語訳したレベルの詳細設計書ってどう？ [無断転載禁止]©2ch.net
■ このスレッドは過去ログ倉庫に格納されています
0441仕様書無しさん
垢版 |
2017/10/08(日) 02:18:55.25
>>433
i = 1 # watirはスクレイピングをキメたtableのインデックスを1から始めるので殺してやりたい

今はどうか知らんけど
0442仕様書無しさん
垢版 |
2017/10/08(日) 02:36:17.02
詳細設計でどんだけ細かく書いてもエラー出るかどうかは結合やるまでわかんね
細かく書いて書いて書きまくって読み手がシクることは超ザラ
シクってたらこっちの説明の仕方が悪かったってことになるんで再連絡だろうが、遅れるとご愁傷

V字のアレなら主義まげて早期の結合テスト
アジャイルだろうがDevOpsだろうが早期に一気通貫できてるかどうかのテスト
そうでないとミスが判明しない

で、可能な限り早期に自動化しないと死ぬ
0443仕様書無しさん
垢版 |
2017/10/08(日) 07:33:58.94
>>442みたく書き手（設計書書く人）と読み手（コード書く人）が別人だとコードレベルの詳細設計書はだめだろうなｗ
0444仕様書無しさん
垢版 |
2017/10/08(日) 08:10:04.22
設計書でもDRYとかSOLIDを守らないとダメなんだよね
コーディングのスキルがない文系SEはそういうの知らないからもうめちゃくちゃ
コードをコピペで書く人は設計書もコピペだらけ
0445仕様書無しさん
垢版 |
2017/10/08(日) 12:06:05.61
>>444
SOLIDなドキュメントってどういうこと？
例えばSOLIDのDはドキュメントだとどうなるの？
0448仕様書無しさん
垢版 |
2017/10/08(日) 19:26:56.93
>>442
自動化考えるプロジェクトがソースコードレベルの機能仕様書作るだろうか？作るのかな。わかんないが。
0449仕様書無しさん
垢版 |
2017/10/08(日) 21:50:34.15
コードレベルの仕様書って意味あんのか？
客が見てもわからんだろ
コードを書いてバグを取り除いてから仕様書に移した方がいい
0450仕様書無しさん
垢版 |
2017/10/08(日) 22:32:42.50
そもそもコードレベルの仕様書って客に見せるもんじゃないだろアホ
0451仕様書無しさん
垢版 |
2017/10/09(月) 07:55:17.42
客に見せないならコードレベルの設計なんかいらん
最初からコードを書けばいい
0452仕様書無しさん
垢版 |
2017/10/09(月) 08:41:42.96
ある言語で完成されたシステムを他言語に移植する仕事で、元の言語のコードをそのまま張り付けた詳細設計書は見たことあるｗ
0454仕様書無しさん
垢版 |
2017/10/09(月) 17:30:44.97
>>452のようにプログラム言語で書かれているものがあるならそのソースコードを詳細設計書にするのはありだろうな。
0455仕様書無しさん
垢版 |
2017/10/09(月) 17:54:18.38
レガシーシステムが業務に対応しきれてないからモダンな環境に移行して保守性を獲得しようって案件だと完全に失敗なんだけどそれ
0456仕様書無しさん
垢版 |
2017/10/09(月) 20:23:12.39
Excelスクショと同等のIT業界の悪夢
0457仕様書無しさん
垢版 |
2017/10/09(月) 20:26:08.87
スクショ地獄は自動化フレームワークのおかげでだいぶ楽になったよ
あんなの手作業でやるのは日本企業だけだろうね
0459仕様書無しさん
垢版 |
2017/10/09(月) 20:35:13.03
>>458
金になるならいくらでも撮りますよ
損するのは日本企業だけだし
0462仕様書無しさん
垢版 |
2017/10/10(火) 07:59:27.92
設計書なんかどうでもいいんだよ。早く動くの出せよIT土方ども
0463仕様書無しさん
垢版 |
2017/10/10(火) 19:22:02.95
「設計書通り」を真面目に実現しようとするとコード並みに詳細な設計書が必要
どう考えたって時間の無駄だわ
0464仕様書無しさん
垢版 |
2017/10/10(火) 19:24:17.39
設計書並みにアバウトなコードを書けばいいだけやんか
0465仕様書無しさん
垢版 |
2017/10/10(火) 19:28:10.99
ザル設計をそのままコードにしてバグが出ると設計書通りに書けって文句言われっからなぁ
設計書をコメントでコピーして1行1行翻訳していけばいいのか？
0466仕様書無しさん
垢版 |
2017/10/10(火) 20:30:28.37
そりゃお前のコードにアバウトさが足りんのと違うか？
ちゃんと設計書通りのアバウトさにしないから叱られるんや
0467仕様書無しさん
垢版 |
2017/10/10(火) 20:36:50.85
仕様書の通りを厳守してエクセルをプロジェクトに追加して納品
0469仕様書無しさん
垢版 |
2017/10/11(水) 07:40:17.11
上司が無能の原因の7割は部下が無能で動かす手足がないからだもんな
無能集団じゃ誰がリーダーやったって変わらんよ
日本の政治を見ればわかるだろ
0470仕様書無しさん
垢版 |
2017/10/11(水) 16:37:43.20
仕様書通りにコード書いてテスト部隊に回したらいっぱい指摘されて泣きそう。てか泣いた。
0471仕様書無しさん
垢版 |
2017/10/11(水) 19:37:39.32
仕様書通りなのにいっぱい何を指摘する事があるんだその無能テスト部隊は
0472仕様書無しさん
垢版 |
2017/10/11(水) 20:37:30.16
なんか気に入らない使いにくい気がする程度の事でも障害にされる
品質管理部門とかいうお荷物
0473仕様書無しさん
垢版 |
2017/10/11(水) 20:59:43.21
なんという狂ったプロジェクトなんだw今すぐやめるべきだろそんなとこw
0474仕様書無しさん
垢版 |
2017/10/11(水) 21:14:41.34
コーダーどもは品質管理の言うことを黙って聞いていればいいんだよ
0475仕様書無しさん
垢版 |
2017/10/11(水) 21:33:30.54
満を持して品質管理気どりのテスター登場w
0477仕様書無しさん
垢版 |
2017/10/11(水) 23:22:01.07
外部発注された品質管理のためのコードレビューってのがあって
大量のプログラム未経験者と一緒にぞろぞろと参加した

何十人もいたけど
Insertメソッドが一度に一行しか登録できないことに誰も気が付かず
くっつけたらまったく動かなかったらしい
0478仕様書無しさん
垢版 |
2017/10/11(水) 23:28:12.87
上は上で規約を提示してしつこく言っときながら
フォーマットの誤りをツールで洗い出して全部指摘した会社があったんだけど
ありがとうございますすごいですねーとか言いながらそこが真っ先に切られた

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

がんばって一杯指摘はしたが、一体何の仕事をしたのか今もってわからない
0480仕様書無しさん
垢版 |
2017/10/11(水) 23:58:43.09
うちでも似たようなツール作ったけどリーダーが空気読んで
先にお伺いたてて指摘にはのせなかった

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

そのときに世界の不条理を学んだ
0482仕様書無しさん
垢版 |
2017/10/12(木) 00:15:29.56
そうか
規約はチェックされないのか
いいことを聞いた
0483仕様書無しさん
垢版 |
2017/10/12(木) 07:25:59.27
アホな規約作って紙出しして一人で必死に規約レビューやってるバカもまだこの世には存在するから気をつけろよw
0486仕様書無しさん
垢版 |
2017/10/12(木) 19:30:41.97
>>484
もちろん派遣のプログラマが直すよ
俺らはチェックして可否を出すだけ
0487仕様書無しさん
垢版 |
2017/10/12(木) 19:47:01.50
レビュアーが詳細設計書を基準に指摘する気力がなくなるぐらい
仕様書ガン無視して要件定義から実装
0488仕様書無しさん
垢版 |
2017/10/12(木) 19:54:18.07
>>487
そういうのは読まずにNG出していいルールにしておくと捗るよ
誰にでもわかるコードはレビュアーにもわかるコードでなければならない
0489仕様書無しさん
垢版 |
2017/10/13(金) 16:36:13.56
スレタイ通りの詳細設計書があるなら>>487みたいなのが許されるはずがない。
0491仕様書無しさん
垢版 |
2017/10/13(金) 22:20:07.98
インタプリタに与えると動く仕様書
ビルドすると実行可能ファイルができる仕様書
ビルドすると特定の言語のソースコードができる仕様書

ソースコードを日本語化した設計書と認められるのはこの三種類のみ
もちろん自然言語の日本語で書かれてる前提ね
0492仕様書無しさん
垢版 |
2017/10/14(土) 16:16:25.00
どんなに詳細設計書を書いても動かすたびにおかしい動きが見つかる。
0493仕様書無しさん
垢版 |
2017/10/14(土) 16:40:29.89
バグ報告
プログラムを使いデバッグ
プログラムの修正箇所を特定する
仕様書の1対1に対応する箇所を修正する
プログラムの1対1で対応する箇所を修正
(あくまで仕様書の変更を元にプログラムを修正するので、デバッグで得た知識が無くても修正できなければならない)
プログラムをテスト
仕様書とプログラムを同時にマージ

アホくさ
0494仕様書無しさん
垢版 |
2017/10/14(土) 17:32:57.07
>>493
お前は今二つの嘘をついたな
すぐにわかっちゃうんだそういうの

嘘1：仕様書
真1：プログラム設計書

嘘2：アホくさ
真2：ボクは無能だからバグが多すぎて設計書まで直す時間がないよぅ～
0495仕様書無しさん
垢版 |
2017/10/14(土) 17:41:28.75
仕様書は広義に設計書の事も含む

アホくさ、が正しい
0496仕様書無しさん
垢版 |
2017/10/14(土) 17:52:55.75
有能な人がこんなネタスレに書き込むわけがない。
0497仕様書無しさん
垢版 |
2017/10/14(土) 17:59:48.58
回帰テストめんどくさいから詳細設計書で完璧にバグ出さないようにしろよな
0498仕様書無しさん
垢版 |
2017/10/14(土) 18:00:59.65
白紙の設計書と空のプロジェクトを同期させる
あとは変更を二重に適用管理するだけ

ん？これもう片方だけでいいんじゃないの？
0499仕様書無しさん
垢版 |
2017/10/14(土) 18:16:25.86
>>498
なんかうまい事言ってるつもりらしいけどどうしてそうなるのさサッパリ理解できんwすまんなw
0501仕様書無しさん
垢版 |
2017/10/14(土) 19:03:42.97
>>499
設計書とプログラムは1対1
なので設計書に加える変更とプログラムに加える変更は等価
最初に白紙の設計書と空のプログラムを用意したので設計書とプログラムは常に等価
等価ならどちらか片方だけであればおk
0502仕様書無しさん
垢版 |
2017/10/15(日) 05:10:28.01
>>1のいう設計書ってどんなの？
1～nまでの和を出す要求だとどんな風に書くのかしら？
0503仕様書無しさん
垢版 |
2017/10/15(日) 09:12:17.25
>>502
nを引数として受け取って総和を返却する関数

1.変数「ループカウンタ」を1で初期化する
2.変数「総和」を0で初期化する
3.変数「ループカウンタ」が引数「n」以下である間以下を繰り返す
3-1.変数「総和」に変数「ループカウンタ」を加える
3-2.変数「ループカウンタ」をインクリメントする
4.変数「総和」を返却する
0504仕様書無しさん
垢版 |
2017/10/15(日) 09:29:17.65
>>503
パッケージ
クラス
メソッド名
引数名
型

設計書なんだからもっと正確に書けよ
0506仕様書無しさん
垢版 |
2017/10/15(日) 10:02:41.51
>>505
は？じゃないよ
書けよ
設計書なんだろ？
なんで必要な情報が書かれてねえんだよハゲ
お前はメソッドの中身だけコーディングしてコンパイル通ると思ってんのか？
冗談じゃないよまったく
0507仕様書無しさん
垢版 |
2017/10/15(日) 10:05:00.66
>>503
その現場で
return Enumerable.Range(1, p).Sum();
なんて書いたらレビューで揉めるなｗ
0508仕様書無しさん
垢版 |
2017/10/15(日) 10:09:58.68
>>507

コードレビューにて

バカ「そのコードはダメだ」
天才「何がダメなんでしょうか？」
バカ「読めない人がいる」
天才「今はコードのレビューでしたよね？」
バカ「どういうことだ？」
天才「読めない"人"がいるわけですよね？」
バカ「だから何だ？」
天才「コードに問題が有るのではなく、人に問題が有るということですよね？」
バカ「！？」
天才「コードのレビューをしましょうや？その能力がないのですか？」
0511仕様書無しさん
垢版 |
2017/10/15(日) 10:37:59.11
>>507
うちの上司だったら設計書との対比が取れていないので分かりにくいって絶対に受け入れないだろうね
設計書そのものがすでに分かりにくいのは見て見ぬ振りだ
0513仕様書無しさん
垢版 |
2017/10/15(日) 10:52:05.07
いや対比の例としてだされたお題からずれてしまってる>>507がガチアスペw
0514仕様書無しさん
垢版 |
2017/10/15(日) 11:04:08.71
>>502への答えとそれと対比したコードを書けよ
>>503では情報が不足しているので設計書バグ
>>507は設計書とまったく違うコードを書くアスペ
0515仕様書無しさん
垢版 |
2017/10/15(日) 13:27:59.55
今時の言語に沿ったコードレベルの日本語詳細設計書書ける人材が必要だなw
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を戻り値に代入する
⑦ 関数を終了する
■ このスレッドは過去ログ倉庫に格納されています
ニューススポーツなんでも実況