大量のドキュメントは本当に必要なのか？無駄だなよ

**デフォルトの名無しさん** · 2021/02/08(月) 03:32:53.15

高品質なソフトほどドキュメントは少ない

Why you need ARCHITECTURE.md
https://www.reddit.com/r/programming/comments/le46br/why_you_need_architecturemd/

**デフォルトの名無しさん** · 2021/02/08(月) 10:15:38.58

実体との齟齬が大きすぎて殆どの場合役に立たない

**デフォルトの名無しさん** · 2021/02/08(月) 12:18:13.80

ソースがドキュメント(mtz)

**デフォルトの名無しさん** · 2021/02/08(月) 13:49:59.63

アプリのドキュメントはともかく、OSのAPIやライブラリの関数や、
classなどのドキュメントはとても重要で、ソースがドキュメントと
いう考え方は絶対駄目。
それをやるから互換性の問題で悩まされ、そのOSやライブラリを使った
アプリが不安定化する。
ソースは一時的なものであって、たまたまそのバージョンのOSや
ライブラリでのみ通用する事情であることが多いから。

**デフォルトの名無しさん** · 2021/02/08(月) 13:58:22.09

もし、安定したOSを目指すなら、むしろソースは非公開にして、ドキュメントで
公開されている仕様のみでアプリを作った方が安定することもある位。
たとえば、fopenやprintf、argv[]やatoi、strtodなどの互換性は、
ソースを見なくてもあらゆるプラットフォームで割と高い。
逆にLinuxのGRUB(ディスクのマルチブートツール)などはLinuxのソースに
基づいてプログラミングされているようで、OSのバージョン間の互換性が低く、
非常に不安定。
しかも、マルチブートしたいだけなのに自分でスクリプト言語を書かなくては
いけない事が多く、僅かでも間違うとディスクの破損事故につながったり、
OSが起動しなくなって簡単には復旧できなくなる可能性がある。
これは、正式なドキュメントによらずにソースの解析に基づいてプログラミング
してしまっていることが要因だと考えられる。

**デフォルトの名無しさん** · 2021/02/13(土) 21:12:43.85

仕様書と設計書の区別がないのか？

**デフォルトの名無しさん** · 2021/02/13(土) 21:17:26.95

>>5
残念ながらLinuxはUNIXの仕様が正確にわからなくて、細かいところはかなり異なるものになった。

C言語もUNIX用に作ったので、仕様が明示されておらず、同じコードでもバラバラで、完全な環境依存になっている。

**デフォルトの名無しさん** · 2021/02/13(土) 21:27:21.74

ドザExcelerの弊害、仕事終わったつもりでいる

**デフォルトの名無しさん** · 2021/02/13(土) 21:54:32.67

コードと一緒で意味あるドキュメントもあるしクソなドキュメントもあるってだけ。
コードと一緒で長くても短くても品質とは関係ない。

**デフォルトの名無しさん** · 2021/02/13(土) 23:42:33.96

品質という言葉で片付けるやつは危険人物

**デフォルトの名無しさん** · 2021/02/13(土) 23:52:02.10

成果物はドキュメントではなく動作するコードです。
コード知らない人の設計書は穴だらけ。

**デフォルトの名無しさん** · 2021/02/13(土) 23:54:03.07

まともなドキュメント書けないSIerみたいなやつはコードもクソだよ。

**デフォルトの名無しさん** · 2021/02/14(日) 00:13:24.81

ドキュメンテーションが苦手で、コーティングが得意なんていうのは、仕事ではありえないんだよな。

**デフォルトの名無しさん** · 2021/02/23(火) 09:16:11.85

得意苦手というよりは、特定のドキュメントが存在することで誰が得するの？って話では？
特定のドキュメントって具体的に何なのかは知らないけど