「FOSSのドキュメントが残念な状態で知りたいことがわからなかったら、どうやって解決する？」記事へのコメント

至上のドキュメント、それはソオス

[Anonymous Coward]

オープンソース界隈の人って、

「ホホホホ、ドキュメントがだめならソオスを読めばいいじゃない？」

って考えてるよね？

確かにマニュアルに書いていないオプションが見つかったりするけども。

そういえばtexのソースコードってドキュメントとごちゃごちゃに混ざっていて、Ｃ言語にするために一度変換するんだったっけ。

Re:至上のドキュメント、それはソオス

[Anonymous Coward]

オープンソース界隈の人って、

「ホホホホ、ドキュメントがだめならソオスを読めばいいじゃない？」

って考えてるよね？

だから一般にはいつまで経っても浸透しないんだよね。そのくせ、～が普及しないのはなぜか？ってあほな議論をする。

Re:至上のドキュメント、それはソオス

[Anonymous Coward]

それもなんか違う。一般に浸透しているソフトだと「コレとコレを設定すればおk」みたいな簡易説明サイトがあっちこっちに出来る→本家のドキュメントは整理されない…

とゆーか、本家のドキュメントなんて誰もみないでその手の説明してくれるサイトばっか参照される

この辺の流れはFOSSに限らず、プロプラでもゲームソフトでもなんでもソー
Q&Aサイトでも本家のマニュアルじゃなく簡易説明サイトのリンクが貼られちゃったりするし…

Re:

[Anonymous Coward]

言われて見れば、プロプラのドキュメントも碌に読まないな。開発でも。

Re:至上のドキュメント、それはソオス

[qwerty (20776)]

簡単に動かせるようになるまで解説サイト、
動くようになったら公式のマニュアルしか読まないようにしてる。

なのでマニュアルが糞なOSSは使用しないようにしてる。
# RHEL も使用やめたいが難しい…。

--
[Q][W][E][R][T][Y]

Re:

[Anonymous Coward]

MSDNは結構読む。昔に比べればクオリティ落ちたけども。

Re:至上のドキュメント、それはソオス

[meamcarrier (41359)]

そうなんだ？ 昔、初めて見たとき(就職1年目)は、「さすがドキュメントだけで金を取ることだけのことはある」って印象だったが

Re:

[Anonymous Coward]

落ちたといってもあのレベルは凄いと思いますよ。

Re:

[Anonymous Coward]

確かにレベルは凄いんだけど
日本語ページでAPIを無かったことにするのはやめてほしい…

比較的新しいページは翻訳してないページを自動翻訳してるけど
これもそのまま日本語で使ってる単語を直訳されて意味不明に…

他のドキュメントを見てるとMSDNへの不満は贅沢な悩みだとは思うけど。

Re:

[Anonymous Coward]

ゲームソフトに関しては「攻略法を見て効率的にやりたい層」と「自分で手探りで攻略法を編み出して行きたい層」がいて
ゲーム会社もどちらにも対応できるように、ゲーム本体につける説明書は最低限にしてるだけだろう
前者に対しては攻略本という形でデータが供給されるし、最近はWikiとかもできるようになってきたけどさ

実用ソフトで「自分で手探りで使い方を編み出せ」とかあったら間違いなくゴミクズだけどな

Re:

[Anonymous Coward]

3DSにしろvitaにしろ、最近のゲームソフトはパッケージで買っても紙マニュアル無しで（あってもペラ紙1枚）オンラインマニュアルだけど、オンラインマニュアル読んだ事なんてないぜ。
なにせ始まる時に無駄に長いチュートリアル（大抵スキップ不可のオマケ付き）をダラダラとやらされるからな。
オンラインマニュアルなんてセガサターンでポーズ押した時に出てくる格ゲーのコンボ表見たのが最後だわ。

Re:至上のドキュメント、それはソオス

[Anonymous Coward]

「オープンソース界隈」の人と「オープンソースの中の人」が別だから。
そういう議論をしてる人は、基本的に開発者ではない。

Re:

[Anonymous Coward]

つまり開発者は普及させることは考えてないと言いたいのね？