![](http://oshiete.xgoo.jp/images/v2/pc/qa/question_title.png?e8efa67)
A 回答 (3件)
- 最新から表示
- 回答順に表示
No.3
- 回答日時:
> 中小企業ではとっつきにくいドキュメントだと誰も使ってくれないけれど、大企業は「どうせ誰かが解説記事を書いてくれるから初心者に分かりづらくても構わない」と考えているのでしょうね。
いいえそういうことでは無いです。誰向けかと言うことで、一般ユーザー向けは正確さより分かりやすさ優先だし、技術者向けは、わかりやすさより正確さ・厳密さと言うことです。わかりやすさと、正確さ・厳密さは両立しません。中小企業が作っていても、技術者向けは正確さ・厳密さ優先でないと誰も使ってくれません。
まあ、技術者向けと、一般ユーザー向けを両方書いてくれればいいのでは?というのは言えますね。ただ、一般ユーザーというのもレベルは様々なので、「初めてプログラミングします」という人からすべてをカバーするのは無理でしょう。
No.2
- 回答日時:
本家のドキュメントは、それが全世界のプログラマの拠り所なので、正確・厳密であることが重要であり、初心者に分かりやすいかどうかは最初から目的にしていません。
なので、初心者には分かりづらいのだと思います。
機械翻訳が読みづらいのはまた別の問題ですが。
特定の環境で特定の目的について書かれた個人のブログは、その条件が自分と合致するのであれば、役立ちます。合うのを探すのが大変ですが。
あるいは、初心者向けに書かれた解説の文章ということであれば、初心者がとっかかりをつかむのには良いかと思います。
上級者には役立たないので、本家のリファレンスを読むことになります。
中小企業ではとっつきにくいドキュメントだと誰も使ってくれないけれど、大企業は「どうせ誰かが解説記事を書いてくれるから初心者に分かりづらくても構わない」と考えているのでしょうね。
No.1
- 回答日時:
APIの仕様を完全かつ正確に記述するためですね。
コンピュータや言語に関する専門知識と読解力がないと読みづらい、解らないという結果になります。
>同じ内容でも個人が書いたブログを読んだほうがよほど分かりやすいです。
不完全かつ不正確で良いからですね。
一般的にはそれでAPIを使用する事は出来るが異常時の対処や使いこなすことは無理と言う事でしょう。
正確さは当然としてかつ分かりやすく書くこともできると思うのですけどね。
完全さが必要なリファレンスはともかく、それが必要でないチュートリアルでも分かりづらいと思うのですよ。
例えばこのAWS OpsWorksのドキュメント
https://docs.aws.amazon.com/ja_jp/opsworks/lates …
タイトルが「AWS OpsWorks とは何ですか?」なのでOpsWorksを知らない人が最初に読むような文書だと思います。
しかしOpsWorksとは何なのか簡潔な説明が無いので、OpsWorksを知らない人がこれを読んでも分かるようにならないんじゃないでしょうか。例えAWSの他のサービスを使っていても。
一方、第三者が書いた記事はこちらです。
https://codezine.jp/article/detail/7304
「OpsWorksを用いると、短時間で手軽にアプリケーションを動かす環境一式を自動構築することができ、要件に応じて柔軟に構成を変更できます」
分かりやすくないですか。
異常時の対処といいますが、エラーの説明などは詳しく書いていなく、大体ググッてフォーラムで情報を見つけることになるんじゃないでしょうか。ある件では結局バグで数ヶ月以上放置されていました。
お探しのQ&Aが見つからない時は、教えて!gooで質問しましょう!
関連するカテゴリからQ&Aを探す
おすすめ情報
デイリーランキングこのカテゴリの人気デイリーQ&Aランキング
-
この XML ファイルにはスタイル...
-
ブログやYoutubeで勝手に人の記...
-
URLを知る人だけが見られるブロ...
-
gooブログのブログ名を変更した...
-
FC2は登録しても安全ですか?
-
ブログをホームページのトップ...
-
アクセス解析にかからないでブ...
-
突然更新が途絶えたブログ
-
FC2のブログにて、現在アクセス...
-
exciteブログのパスワードの変...
-
http://wrs.search.yahoo.co.jp...
-
アクセス解析が怖い。
-
一般的なブログを閲覧しようと...
-
大日月地神示 ←について ご存知...
-
gooブログの「編集画面」に...
-
GOOブログへのコメントの仕方
-
amebaで嫌がらせをされ困ってい...
-
ブログに悪意のコメント
-
ブログ管理者にはばれる?
-
ブログのコメントのIPアドレス...
マンスリーランキングこのカテゴリの人気マンスリーQ&Aランキング
-
この XML ファイルにはスタイル...
-
一般人が書いたブログって誰も...
-
ブログやYoutubeで勝手に人の記...
-
ブログのコメントについて
-
動詞-て + らして って どうい...
-
URLを知る人だけが見られるブロ...
-
画像をクリックしたら別の画像...
-
FC2は登録しても安全ですか?
-
大日月地神示 ←について ご存知...
-
アクセス解析に出てくるfaceboo...
-
ブログを書いている人は、だれ...
-
スカシカシパンを拾う際に
-
ブログで企業やお店を「さん」...
-
自分のブログ、誰に読まれてる...
-
ブックマークをすると相手に個...
-
検索しすぎました
-
exciteブログのパスワードの変...
-
突然更新が途絶えたブログ
-
URLの貼り付けと名前の変更につ...
-
平成名前辞典とは・・・・?
おすすめ情報