◎正当な理由による書き込みの削除について:      生島英之とみられる方へ:

大量のドキュメントは本当に必要なのか?無駄だなよ ->画像>1枚


動画、画像抽出 || この掲示板へ 類似スレ 掲示板一覧 人気スレ 動画人気順

このスレへの固定リンク: http://5chb.net/r/tech/1612722773/
ヒント:5chスレのurlに http://xxxx.5chb.net/xxxx のようにbを入れるだけでここでスレ保存、閲覧できます。

1デフォルトの名無しさん
2021/02/08(月) 03:32:53.15ID:JYkDV+U9
高品質なソフトほどドキュメントは少ない

Why you need ARCHITECTURE.md
https://www.reddit.com/r/programming/comments/le46br/why_you_need_architecturemd/
2デフォルトの名無しさん
2021/02/08(月) 10:15:38.58ID:7fZBDePn
実体との齟齬が大きすぎて殆どの場合役に立たない
3デフォルトの名無しさん
2021/02/08(月) 12:18:13.80ID:5JxS4RLe
ソースがドキュメント(mtz)
4デフォルトの名無しさん
2021/02/08(月) 13:49:59.63ID:dyvUCrTq
アプリのドキュメントはともかく、OSのAPIやライブラリの関数や、
classなどのドキュメントはとても重要で、ソースがドキュメントと
いう考え方は絶対駄目。
それをやるから互換性の問題で悩まされ、そのOSやライブラリを使った
アプリが不安定化する。
ソースは一時的なものであって、たまたまそのバージョンのOSや
ライブラリでのみ通用する事情であることが多いから。
5デフォルトの名無しさん
2021/02/08(月) 13:58:22.09ID:dyvUCrTq
もし、安定したOSを目指すなら、むしろソースは非公開にして、ドキュメントで
公開されている仕様のみでアプリを作った方が安定することもある位。
たとえば、fopenやprintf、argv[]やatoi、strtodなどの互換性は、
ソースを見なくてもあらゆるプラットフォームで割と高い。
逆にLinuxのGRUB(ディスクのマルチブートツール)などはLinuxのソースに
基づいてプログラミングされているようで、OSのバージョン間の互換性が低く、
非常に不安定。
しかも、マルチブートしたいだけなのに自分でスクリプト言語を書かなくては
いけない事が多く、僅かでも間違うとディスクの破損事故につながったり、
OSが起動しなくなって簡単には復旧できなくなる可能性がある。
これは、正式なドキュメントによらずにソースの解析に基づいてプログラミング
してしまっていることが要因だと考えられる。
6デフォルトの名無しさん
2021/02/13(土) 21:12:43.85ID:k+FkZinH
仕様書と設計書の区別がないのか?
7デフォルトの名無しさん
2021/02/13(土) 21:17:26.95ID:k+FkZinH
>>5
残念ながらLinuxはUNIXの仕様が正確にわからなくて、細かいところはかなり異なるものになった。

C言語もUNIX用に作ったので、仕様が明示されておらず、同じコードでもバラバラで、完全な環境依存になっている。
8デフォルトの名無しさん
2021/02/13(土) 21:27:21.74ID:Hi5efe9w
ドザExcelerの弊害、仕事終わったつもりでいる
9デフォルトの名無しさん
2021/02/13(土) 21:54:32.67ID:cu3O8Dcb
コードと一緒で意味あるドキュメントもあるしクソなドキュメントもあるってだけ。
コードと一緒で長くても短くても品質とは関係ない。
10デフォルトの名無しさん
2021/02/13(土) 23:42:33.96ID:8rFjwvle
品質という言葉で片付けるやつは危険人物
11デフォルトの名無しさん
2021/02/13(土) 23:52:02.10ID:Hi5efe9w
成果物はドキュメントではなく動作するコードです。
コード知らない人の設計書は穴だらけ。
12デフォルトの名無しさん
2021/02/13(土) 23:54:03.07ID:cu3O8Dcb
まともなドキュメント書けないSIerみたいなやつはコードもクソだよ。
13デフォルトの名無しさん
2021/02/14(日) 00:13:24.81ID:0ZOTyIFU
ドキュメンテーションが苦手で、コーティングが得意なんていうのは、仕事ではありえないんだよな。
14デフォルトの名無しさん
2021/02/23(火) 09:16:11.85ID:KorSI7L1
得意苦手というよりは、特定のドキュメントが存在することで誰が得するの?って話では?
特定のドキュメントって具体的に何なのかは知らないけど
15デフォルトの名無しさん
2021/02/23(火) 15:42:19.69ID:Adetb3EO
NECとかに要求される大量のExcelファイルは本当に無駄だと思う
16デフォルトの名無しさん
2021/02/23(火) 17:34:52.62ID:c7t5V9po
極端に一時的な資料になっているドキュメントも困る。
17デフォルトの名無しさん
2021/02/23(火) 17:43:14.11ID:0iI/BmGY
コードが完成してから書くドキュメントには価値がある
18デフォルトの名無しさん
2021/02/23(火) 17:50:04.63ID:NOTz+wKC
>>16
誤解のない意思疎通のために必要なら
一時的なものでもドキュメント書いた方が結果的に安上がり

ルールとか規約のためだけに書いてるものはだいたい無駄
19デフォルトの名無しさん
2021/02/23(火) 19:28:10.56ID:82+bZbmq
>>17
各ファイルのステップ数とか書き込むExcelとかに?
20デフォルトの名無しさん
2021/02/23(火) 20:09:46.89ID:JuUT33rQ
>>19
そういうのは自動生成すればいいだけだからどうでもいい
21デフォルトの名無しさん
>>18
作って放置して逃げてきた自覚がありますか?
22デフォルトの名無しさん
2021/02/24(水) 09:20:29.14ID:cUgjNbyW
ほとんど仕様どうりに作れない、特に今は
23デフォルトの名無しさん
2021/02/24(水) 12:25:09.13ID:/ijFpzJL
Linux界ではよくソースが仕様書と言われます。
24デフォルトの名無しさん
2021/02/24(水) 14:34:55.93ID:cUgjNbyW
枯れてるJavaとかならなぁ、flutterとかだと新しいプラグインで「あーこんなやり方あるの?/できないの?」みたいな事も多いからなぁ
ListView.builderの中のListView.builderとか一工夫必要だしなぁ
API mockでプロトタイプアプリ作ってエンドと合意してから要件他まとめる感じ
25デフォルトの名無しさん
2021/02/24(水) 17:07:52.91ID:fxCeKAet
linux kernel読むのにソースだけ読み始めても無理があるだろ。
明らかにドキュメントが必要だし、実際役に立ってる。
26デフォルトの名無しさん
2021/02/26(金) 03:55:10.19ID:5d4w5oMJ
>>24
地図のZ社のカーシェアアプリ?
27デフォルトの名無しさん
2021/02/26(金) 05:54:24.34ID:K8Xef+5I
Ruby では、ソースコードのクラス定義やメソッド定義箇所に、

YARD の記法に従いコメントをつけることで、自動的に文書が作られる
28デフォルトの名無しさん
2021/02/26(金) 09:46:35.99ID:/ZYd6oEI
>>14
コード書かない人が仕事したことを装う為に必要
29デフォルトの名無しさん
2021/02/26(金) 11:12:08.06ID:JSIqicAG
>>28
書かせるのが仕事なんだから
コード以外にもたくさん書かせたほうが仕事ができる男なんだよ
30デフォルトの名無しさん
2021/02/26(金) 11:13:03.78ID:KlI32NiE
役に立つドキュメントを書ける人とそうでない人がいる
31デフォルトの名無しさん
2021/02/26(金) 13:38:55.78ID:WvFkELqd
>>30
これはそうだな
本当に役立つドキュメントを書ける人は20人に1人もいない
32デフォルトの名無しさん
2021/02/26(金) 14:09:11.03ID:GphNZQIs
まあそれはコードでも同じなんだが、コードの場合糞でも動くってところが厄介。
33デフォルトの名無しさん
2021/02/26(金) 14:46:17.25ID:MVwmWMo6
ドキュメントはクソでも動かさないから修正されない
ドキュメントこそクソができないようにレビューしなければいけないのだが
クソでも動かさないから間違っていても客から文句は言われないのでレビューもしない
ドキュメントがクソだとコードはクソにしからない、これはドキュメントのせい
ドキュメントがクソ方がもっと厄介
34デフォルトの名無しさん
2021/02/26(金) 14:51:22.12ID:RFmyNSeu
そだよ
上流ドキュメントの質が一番重要だから君たちより高い金もらって
ドキュメントだけ書いてあとは君たち下請けに投げてるんじゃないか
クソの下請けがクソにしかならないのは当たり前
35デフォルトの名無しさん
2021/02/26(金) 14:52:39.36ID:MVwmWMo6
>>34
だからドキュメントのレビューさせろって言ってるんだが?
36デフォルトの名無しさん
2021/02/26(金) 16:04:06.59ID:GphNZQIs
>>34
糞しかできないんじゃその高級なドキュメントとやらに価値はないがな。
37デフォルトの名無しさん
2021/02/26(金) 17:17:33.51ID:HGT/q+n3
>>36
そだよ
客は本当の価値なんて分からないから下請けがクソでしたってことにして清算するだけ
本当の価値に対して金が動くわけじゃないから
38デフォルトの名無しさん
2021/02/26(金) 17:23:04.47ID:HGT/q+n3
>>35
すればいいじゃんw
レビューすらさせて貰えないのは君の会社の管理体制の問題だろ
その程度の交渉力すらないならドキュメントの質に関係なくクソ確定だよ
39デフォルトの名無しさん
2021/02/26(金) 18:04:11.49ID:MVwmWMo6
ドキュメントの内容が正しいか
ちゃんとテストしましたか?
テストは重要ですよ
40デフォルトの名無しさん
2021/03/03(水) 12:36:34.16ID:+sKk2o8N
>>33
これは本当にそう思う

・ドキュメントはテストできない
・ドキュメントは静的解析できない

これがドキュメントの抱える最大の問題

まあ静的解析はできなくもないが
標準的なエコシステムが無いのでコストが高すぎる
独自のエクセル設計書解析システムを持ってる現場で働いたことがあるけど
解析が重すぎ&成果しょぼすぎて全く役に立ってなかった
41デフォルトの名無しさん
2021/03/03(水) 13:41:07.73ID:Lej/VXGz
ドキュメントもテストできるよ
自動化はまだ難しいだろうけど
42デフォルトの名無しさん
2021/03/03(水) 20:42:50.69ID:cFLgprZs
そもそもテストが必要になる時点でクソドキュメントだけどな。
43デフォルトの名無しさん
2021/03/03(水) 21:37:51.18ID:I2SjeTGZ
だから全てのドキュメントは、クソドキュメントだからテストするんだよ
44デフォルトの名無しさん
2021/03/03(水) 21:54:41.54ID:SQOFGo4F
ドキュメントをレビューする時に何をレビューしてんの君たちww
45デフォルトの名無しさん
2021/03/03(水) 22:02:48.37ID:I2SjeTGZ
ドキュメント作ってるやつがレビューをさせないんだよ
バグありのまま出来ましたって出してくる
大量に持ってくるからその場でレビューできる量じゃない
そして実際に作ってる段階で漏れや矛盾が見つかる
46デフォルトの名無しさん
2021/03/03(水) 22:20:48.99ID:R+9xzQvR
>>45
意味がわからん
受け取る側が勝手にレビューすればいいじゃん
その場でレビューする必要なんてないぞ
47デフォルトの名無しさん
2021/03/03(水) 22:26:42.67ID:R+9xzQvR
納品するやつが受け入れテストさせねーんだよ
バグありのまま出来ましたって納品してくる
そして実際に運用してる段階で不具合が見つかる


検収とか受け入れテストとかすれば良くない?
48デフォルトの名無しさん
2021/03/03(水) 23:26:40.83ID:/CRX0BjF
>>47
なんで御社はそんなところに発注してんの?
49デフォルトの名無しさん
2021/03/04(木) 09:54:52.43ID:OjWW0m8I
>>46
スケジュールの問題、遅れて遅れまくった上に
これで作れと言ってくる
レビューしてバグを戻すと、更に開発時間が減る
50デフォルトの名無しさん
2021/03/04(木) 09:56:46.29ID:OjWW0m8I
そもそも下流でレビューするという工程が含まれてない
上流に戻すという工程が含まれてない
51デフォルトの名無しさん
2021/03/04(木) 10:38:39.26ID:tiaJgzoo
>>50
工程管理に不具合があるなら修正すればいいだけじゃん
修正できないのは君の能力不足が原因

自分の能力不足を他人のせいにしてるうちは成長しない
52デフォルトの名無しさん
2021/03/04(木) 11:52:45.85ID:OjWW0m8I
>>51
それを修正するには、上流は偉くない、
難しいことをしてるわけじゃない、給料を減らすべきだ
という流れにつながるから上流は拒否するんだよ
53デフォルトの名無しさん
2021/03/04(木) 14:56:43.77ID:KL6FyXLz
>>52
それが解決策だと思うならそうすればいいじゃない

拒否されてハイそうですかって引き下がるしかできないならそれは君の能力不足
最も実際には何も行動してなくて自分の能力不足の言い訳をグチグチと垂れ流してるだけだろうけど
54デフォルトの名無しさん
2021/03/04(木) 15:54:22.24ID:iUXXoDD8
能力は関係ないな。契約の話だから。
55デフォルトの名無しさん
2021/03/04(木) 16:13:51.36ID:dHD8vkAI
そういう契約しかできないというのも能力の問題
そういう契約しかできないような会社で働く選択肢しかないというのも本人の能力の問題

問題だらけのドキュメントを提出してくるやつは
技術的能力は低くてもそれ以外の能力が及ぼす影響についていくらか理解してる分だけ
レビューさせないと愚痴るだけのやつに比べれば100倍マシ
56デフォルトの名無しさん
2021/03/04(木) 16:14:25.34ID:iUXXoDD8
もしかして一人で働いてるんか?
契約を開発が担当するわけないだろ
57デフォルトの名無しさん
2021/03/04(木) 18:12:12.84ID:rD8/nwrJ
発注側が飴対応で舐められてるのか受注側が確信犯でヤバいのかその両方なのか
58デフォルトの名無しさん
2021/03/04(木) 18:28:10.38ID:CgZMeLpz
>>56
理解できないんだね
君みたいな考え方しかできない開発者は例外なく使えない
例外なく、ね
59デフォルトの名無しさん
2021/03/04(木) 19:32:19.14ID:iUXXoDD8
>>58
使える開発者が存在するなら、俺以外がすでにやってる
60デフォルトの名無しさん
2021/03/04(木) 21:06:47.63ID:FIso/ueX
そりゃそんな契約しかできない会社だもん、使えるやつがいるなんて誰も思わないよww
とことん頭悪いね
問題がある現状を変えるために君は何をしたの?
愚痴ってるだけ?
61デフォルトの名無しさん
2021/03/05(金) 00:44:01.22ID:LQ4vdgyw
> 君は何をしたの?
転職

周りの人間を育てるよりも
すでに育っている人に変えるほうが
自分の時間を使わなくてすむ
時間は有限
62デフォルトの名無しさん
2021/03/05(金) 11:13:26.36ID:8hKplFoN
>>61
まともな会社に転職してたら
「ドキュメント作ってるやつがレビューをさせないんだよ」なんて言わないわなw

ニューススポーツなんでも実況



lud20250402121431
このスレへの固定リンク: http://5chb.net/r/tech/1612722773/
ヒント:5chスレのurlに http://xxxx.5chb.net/xxxx のようにbを入れるだけでここでスレ保存、閲覧できます。

TOPへ TOPへ  

このエントリをはてなブックマークに追加現在登録者数177 ブックマークへ


全掲示板一覧 この掲示板へ 人気スレ | Youtube 動画 >50 >100 >200 >300 >500 >1000枚 新着画像

 ↓「大量のドキュメントは本当に必要なのか?無駄だなよ ->画像>1枚 」を見た人も見ています:
宗教は本当に必要なのか?
学校行事は本当にすべて必要なのか?
高性能なゲーム機は本当に必要なのだろうか?
     諜報活動は本当に必要なの?      
「英語」は本当に必要なのか ・・・大学関係者から漏れる「英語不要論」
「英語」は本当に必要なのか ・・・大学関係者から漏れる「英語不要論」
【性生活】「遅漏の彼をイカせたいからまんこを締めたい」? 挿入中の痛みを我慢する努力は本当に必要なのか[11/20] ©bbspink.com
【野球】<今だに根強い日本野球の「長時間練習」の信仰>12時間練習は本当に必要なの?平日7時間、休日12時間以上の練習も珍しくない★2
巨人に山田哲人は本当に必要か?吉川尚輝が「飼い殺し」の恐れも
人口減少 老人だらけ テレワーク時代にリニアは本当に必要か? [kiki★]
【】人口減少&テレワーク時代にリニアは本当に必要か? [砂漠のマスカレード★]
【ワクチン】「あなたは打ちますか?」 新型コロナワクチンの“3回目”接種は本当に必要? 専門家の見解は… [夜のけいちゃん★]
【野球】巨人に山田哲人は本当に必要か? 湯浅大、吉川尚輝が「飼い殺し」の恐れも〈週刊朝日〉 [砂漠のマスカレード★]
【ワクチン】「あなたは打ちますか?」 新型コロナワクチンの“3回目”接種は本当に必要? 専門家の見解は… ★2 [夜のけいちゃん★]
【自動車】いまだ蔓延るEVの「航続距離が不安」の声! まずバッテリー容量の拡大が「本当に必要か」を考えれば答えは出る ★11 [ぐれ★]
【自動車】いまだ蔓延るEVの「航続距離が不安」の声! まずバッテリー容量の拡大が「本当に必要か」を考えれば答えは出る ★6 [ぐれ★]
【自動車】いまだ蔓延るEVの「航続距離が不安」の声! まずバッテリー容量の拡大が「本当に必要か」を考えれば答えは出る ★9 [ぐれ★]
無駄なモノって世の中には絶対に必要だよな
福井から公務員は投票にいく必要はなく無駄だ
声優って本当に必要なのだろうか?
【話題】「アニメにエロ要素は必要ない」に共感多数 「原作が面白いのに無駄なエロを足すな」という声も
有識者「数学とかできる必要ありません。人生で役に立ちません。勉強してる時間無駄です。」
「MT免許」、必要最低限が判断できず金を無駄遣いするバカという評価に落ち着き始める
俺「大工の修行に5年?フン、時間の無駄だね!」大工見習い「大黒柱5cm間違えましたサーセン」俺(あっこれいるわ修行必要だわ)
モニターの120Hzとか144Hzとか本当に必要なのか?正直60Hzで十分だろ
職場は本当に必要?:コロナ後もテレワーク、「オフィス消滅」企業が続々★10 [トモハアリ★]
過疎が過疎で居続ける理由 「地方活性化は本当に必要?」 どう?(´・ω・`) 
コロナ休校 「遊びよる子がおるバイ」と苦情、在宅確認の「抜き打ち家庭訪問」は本当に必要?
【東京五輪】トランスジェンダーの選手が初の五輪代表に 「その枠」は本当に必要か(水野詩子) ★2 [首都圏の虎★]
玉川徹はどのような存在? 羽鳥慎一「番組内では本当に面倒くさいけど、絶対に必要な存在です」 [朝一から閉店までφ★]
藤井厳喜「駅のアナウンスまで韓国語でやると自分達は特権階級と勘違いしてしまう」 ネット「中国語や韓国語は本当に必要ない!
三崎優太氏「令和ロマンが自粛って本当に必要なのか?」「完全にクリーンな人間なんて存在しない」「もっと取り締まるべきことあるだろ」 [冬月記者★]
【メディア】45回目放送でも地球を救えていない現状… 『24時間テレビ』は本当に必要? 有観客・無観客以前の問題か[05/01]
【作家】<百田尚樹氏>コロナ禍で売り上げ激減も...「小説家で『金をくれ』と言った人はいない」「金は本当に必要な人に回せ!」 [Egg★]
【東京】小池知事の肝いり「1.6億円」TOKYOモニュメントに批判殺到…7億円プロジェクションマッピングに続く無駄遣い「やりたい放題!」 [ぐれ★]
バンドメンバーのコメントは必要なのか
本当に必要なのは 大人になることなんかじゃなかったんだ
【経済】本当に老後に2千万円必要なのか ★3
嫌儲すら誰も言わないけどリニアって本当に必要なの😣
【気付き】俺たちに本当に必要なのは岬ちゃんじゃなくて山崎だったという事実
本当に中国は日本に侵略するのかな?そうなったら米中戦争だけど。改憲は必要なのかな?
【1週間に1枚】看護師「1週間ほど前からマスクを使おうとすると、本当に今、必要なのか問われるようになりました」★2
こども家庭庁、前年度比約2兆円増の7兆3270億円 この組織は少子化の歯止めになってる? 本当に必要なのか ★2 [お断り★]
こども家庭庁、前年度比約2兆円増の7兆3270億円 この組織は少子化の歯止めになってる? 本当に必要なのか [お断り★]
真希波・マラ・フェラシトリマス👉この新キャラシンエヴァに必要だったか?
【サッカー】<ヴィッセル神戸>最多8人に上る外国籍選手の去就が気になる!来季の補強ポイントは?イニエスタのバックアップは必要か?
🐱「社長。キツネ先輩ってうちの会社に本当に必要な人材ですか?」
料理界最大の謎「アク取り」 本当にアレをこまめに取り続ける必要があるのか?実は大して意味が無いんじゃ…
クローズアップ現代+「その校則、本当に必要ですか?ルール改革の最前線に密着!」
日本の文系研究者「よし、今日は海外の研究者の誰のどんな理論をパクろうかなー」→すまん、こいつら本当に必要か?
料理界最大の謎「アク取り」 本当にアレをこまめに取り続ける必要があるのか?実は大して意味が無いんじゃ…
【悲報】自衛隊、また問題を起こしてしまう…自衛隊車輌が男性を轢殺、当然即死。なあ自衛隊って本当に必要か?
【東大生YouTuber】国民の象徴とかいうGHQが適当に付けた役割のために毎年数百億円の国営宗教を運営する必要あるんですか?★7
今日見て思ったけどつばきファクトリーに一番必要なのは新沼希空だな
ドキュメント72時間「失礼ですがお仕事は何されてるんですか?」 うるさいんじゃい!仕事しなきゃダメなのかよ!
朝起きたら枕元に大量の髪の毛が置いてあったんだけど、これサンタさんからのプレゼントなのか?
女性「エアコンの設定温度は28度!28度じゃなきゃ嫌なのよ!」 それ逆に電気代の無駄じゃね?費用対効果考えろよ
橋下徹「日本に一番必要なのは 独裁ですよ 独裁ですよ」安倍晋三
そもそも副キャプテンって必要なの?梅澤のために新ポストを作ったのがキモいんだよ
ポイント稼ぎは時間の無駄である、働け!
【悲報】日本人気く「オンラインカジノが犯罪っておかしくね?誰にも迷惑をかけてないし、彼(女)らに必要なのは刑罰ではなく、治療だよ
青田買いは必要なのか?
山口真帆は本当に正義なのか?
二次元世界は本当に二次元世界なのか?
不老不死は本当に良いものなのか?
真央ちゃんは本当に浜崎が好きなのか?
06:13:27 up 53 days, 7:12, 0 users, load average: 9.54, 9.09, 8.73

in 1.5141201019287 sec @1.5141201019287@0b7 on 060919