プログラマの雑談部屋 ★64

[1 仕様書無しさん 2019/03/15(金) 22:14:01.71]

※前スレ
プログラマの雑談部屋 ★62
https://medaka.5ch.net/test/read.cgi/prog/1551007254/
プログラマの雑談部屋 ★63
https://medaka.5ch.net/test/read.cgi/prog/1551744733/

[967 仕様書無しさん 2019/03/22(金) 16:55:14.20]

>>945
個別のモジュール毎に工数割り当てて
実際に結合をさせてみる工程ってないとこのが多いな
結合テストはあるけど
結合実施工程はあんま見ない

[968 仕様書無しさん 2019/03/22(金) 17:14:28.19]

質問！
今使ってる設計書は処理毎に番号が振られてるやつで
「3-5-2で取得した値を〇〇加工する」みたいなタイプなんだけど、
仕様変更の改修漏れが積み重なって項番が信用ならないというクズ設計書になってる
今後新規に設計書を作る時に備えてオススメの書式とか考え方とかあれば教えて欲しい

[969 仕様書無しさん 2019/03/22(金) 17:19:17.27]

自分勝手にやっていいなら自分ならTeX を使うが、Word のリファレンスを使い倒すというのが現実的な解だろうな

[970 仕様書無しさん 2019/03/22(金) 17:44:55.53]

>>944
ウォーターフォーるではそれがデフォルトだからあきらめろん
アジャイルならこんなことにはならないけどね〜^_^

[971 仕様書無しさん 2019/03/22(金) 18:00:16.32]

>>968
最初から番号を書くな！
名前で管理しろ！
これしかない！
冗談じゃないぞ？
マジで言ってるからな！！

[972 仕様書無しさん 2019/03/22(金) 18:35:01.74]

>>968
変更時に一斉置換すれば辻褄が合うはず

2-5-4ウンコ作成
→3-5-4ウ○コ作成

[973 仕様書無しさん 2019/03/22(金) 18:46:39.27]

>>972
変更すると後ろの項番全部ズレるわけ

変換ツール作るか
ドキュメントとソースの紐付けにクラス名やメソッド名だけにするとか？

[974 仕様書無しさん 2019/03/22(金) 18:52:02.03]

番号管理なんて未だにあるんだ
COBOLの案件かな？

[975 仕様書無しさん 2019/03/22(金) 19:00:07.26]

普通の設計書ならだいたいWordで事足りるけどね。
「3-5-2で取得した値を〇〇加工する」みたいな設計書だとつらいわな。
プログラムそのまま設計書にしましたみたいなのだとな。

ソースコードにコメントと参照名埋め込んどいて、
項番付きのドキュメントを自動生成するツール作ったらいいんじゃね。

[976 仕様書無しさん 2019/03/22(金) 19:04:14.40]

>>966
その女性がむちゃかわいいなら
うちでひきとるぞ？

[977 仕様書無しさん 2019/03/22(金) 19:31:51.22]

3-5-2:
これこれこういう手順で取得した値を変数ホゲに代入
3-5-3:
ホゲを加工してうんたら〜

常識的に考えて↑でいいだろう
プログラム1回でも書いたことあるなら自然と出てくる発想だと思うけどな

ちなみに俺のようなプログラムの達人だったら3-5-2を抽出して1つの問い合わせとして定義するだろうね

[978 仕様書無しさん 2019/03/22(金) 19:58:40.36]

プログラムならそうだが、仕様書だと「変数ホゲってどこよ」ってなるから
番号で書かなきゃならんルールで困ってるっていう話でしょうに。

てか設計書の体なんだから「変数ｘｘｘへ代入」じゃだめでしょう。

[979 仕様書無しさん 2019/03/22(金) 20:12:52.07]

>>978
今議論してるのはコードの日本語訳タイプの詳細設計書だろ？
ならば変数はアリではないかな？
変数って言葉が実装寄りで気に入らないのなら

3-5-2: これこれこういう手順で取得した値をホゲと定義する
3-5-3: ホゲを加工してふがふがする

これで変数という実装を意識しなくてよくなったな

開発者なら表層的な問題ではなく本質を見極めることが大事だ
この問題はツール替えるとか書式を替えるとかそういう話じゃない
番号で参照したらズレたとき困るという事象の本質は番号では間接化として不十分ということだ
なので正しい答えは名前を割り当てて間接化すればOKとなるわけだな

[980 仕様書無しさん 2019/03/22(金) 20:36:46.38]

>>979
本質を見極めていないのはきみだ。
「3-5-2で取得した値を〇〇加工する」と書いてあるんだから
項番で参照するというルールなのは明らかでしょう。

そもそもすべての変数をドキュメント内に定義するつもりかい？
プログラムならスコープの範囲内で名前が被らなければよいが、
ドキュメント内でまったく被らないようにすべての名前を定義するのは無理と気づけ。

[981 仕様書無しさん 2019/03/22(金) 20:47:18.43]

>>980
可能やで
変数名も項番のように振ればええんや
項番は番号ではなく意味もあるはず
例えば

3-5-4

3-Unko
5-Auto
4-Csv

UnkoAutoCsv
となる
3-5-5は
UnkoAutoXxxx
となるでしょ？

[982 仕様書無しさん 2019/03/22(金) 20:48:14.06]

>>980
常識的な感覚で考えればスコープは3-5-*かつ3-5-2以後だろう
なんのために階層化して管理しているか考えればわかるよね
常識なんか知らないというなら規約化して周知すればいい

そもそも>>979の書き方なら変数に縛られることはないよ
したがってメソッドが重複しないように実装できるのと同じ理由で
ドキュメント内で重複しないように設計することが可能
もし不可能というなら設計がモノリシックで大きすぎるのだろう

[983 仕様書無しさん 2019/03/22(金) 21:12:33.25]

>>981
そのような自然言語からかけ離れた名前を定義しまくったドキュメントの存在意義は？

膨大な得体の知らない「番号付き名前」の定義をいちいち調べなければ読み解けず、
それはプログラムそのまま、より可読性を落としただけのガラクタでしょう。


>>982
スコープが明確なら話は簡単。
「本章の3番で取得した値を〇〇加工する」と書けばよい。

実際はそうではなく、ドキュメント全体に渡り参照があるから困ってるって話でしょう。

[984 仕様書無しさん 2019/03/22(金) 21:20:12.24]

プログラマならdoc2html書いてリンク切れ検出すればいいだけだろ
リンク切れを直す仕事はSEに押し付けろ

[985 仕様書無しさん 2019/03/22(金) 21:29:51.37]

>>983
とりあえずおちつけよ
設計修正の蓄積で「本章の３番」がズレてわけわかんなくなるからどうにかしてってのが発端だろ
あんたのロジックだとスタート地点に戻ってるぞ

[986 仕様書無しさん 2019/03/22(金) 21:45:39.56]

こういうくだらない事に悩んでる時間を使って自分でコード書いたらすぐ済むだろうに
日本のSEさんはなんですぐ外注するのかなあ

[987 仕様書無しさん 2019/03/22(金) 21:47:49.55]

>>985
現実的に項番の最後の最後だけならメンテに困ることはないんだわ
万が一間違っててもすぐに気づいて修正可能だし

[988 仕様書無しさん 2019/03/22(金) 21:54:49.64]

>>986
大手が外注しなかったらきみが職を失うだけだがそれでよいのかい？

[989 仕様書無しさん 2019/03/22(金) 21:57:46.48]

大手で内製プログラマやってるわ
すまんな

[990 仕様書無しさん 2019/03/22(金) 21:58:25.20]

かまわんよ

[991 仕様書無しさん 2019/03/22(金) 22:03:28.04]

>>989
大手社員ならあえて外注した方がよい理由は分かると思うが？

[992 仕様書無しさん 2019/03/22(金) 22:08:44.49]

既存のナンバリングに合わせようとするから番号の振り直しが発生する訳で、仕様変更で追加された処理はv2-1-1とか、既存とは別の番号帯にすれば問題ないんじゃないの？

昔やってたプロジェクトで6〜8が12の下に移動とか頻繁にあって並び順がぐちゃぐちゃになってる設計書があった

最初は面食らったけど、項番はただのユニークな文字列であって数字ではないと割り切ってからは割と苦にならなかったな

実際数字が足りなくなってアルファベットとかも出てきてたし綺麗に書こうとこだわるとシンドイばっかりで中身が疎かになるよ？

[993 仕様書無しさん 2019/03/22(金) 22:14:12.12]

vip

[994 仕様書無しさん 2019/03/22(金) 22:15:06.43]

>>987
逆に言えば最後の最後以外は手間がかかるんだよな
1つ直したら後続の項番全部ずれるとかやってられんわ
しかもあんたの脳内だと3-5-2みたいな明らかにプロセスの途中の項番もグローバルに参照される可能性があるんだろ？
そんなん絶対修正したくない

[995 仕様書無しさん 2019/03/22(金) 22:20:03.35]

vipにもitスレ立ってるけどここと変わらんくて感慨深い
一人で何百レスしてる奴とか>>986>>988みたいなやり取りしてたりとか無能に傷つけられた経験が思い起こされてイライラしてる奴とかw

[996 仕様書無しさん 2019/03/22(金) 22:30:56.63]

>>992
それぞれが思い思いにユニークな文字列を割り振ってかぶる可能性は？
かぶってるかどうかも順番に並んでないと探しにくいのでは？


>>994
そう、誰もやってられない。
だからメンテされずにぐちゃぐちゃになっているのでしょう。
設計書をそもそもそんな形式で書いてることが問題だと思う。

[997 仕様書無しさん 2019/03/22(金) 22:35:06.48]

>>995
vipってどこじゃ？面白そうだからリンク張れ

[998 仕様書無しさん 2019/03/22(金) 22:35:21.16]

>>996
ツールあれば楽だけどね
VisualStudioがドキュメントと連動してないってだけだろ
そんな難しくない文字列置換で一発だし

[999 仕様書無しさん 2019/03/22(金) 22:37:19.20]

日時で作成した機能Idでドキュメントと括り付けて
項番は項番で振るのはどうだろう？

[1000 仕様書無しさん 2019/03/22(金) 22:41:20.11]

1000なら来年度は仕事がうまく行く