私たちはどうして公式ドキュメントが読めないのか？ - Qiita

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 少しプログラミングを覚えてきた初学者が、さらに力をつけるために必要なのが公式ドキュメントを読むことだと思います。 公式ドキュメントには、日本語の記事には書かれていないような詳細な説明や、APIの使用方法、そしてリリースノートなど、実装には不可欠な情報が掲載されています。 しかし、公式ドキュメントが上手く読めずにつまづく人も多いのではないでしょうか？慣れていない人にとっては、技術について書かれたドキュメントを読むのは難しいものです。 この記事では、つまづいてしまう人が少しでも減るように、公式ドキュメントが読めない原因と対策をいくつか書いて

[sisya]

正常系の説明しかされておらず、少しイレギュラーなポイントがあると全然説明が無いというパターンが公式には多いと思う。はまりポイントやOSなどの環境込みで説明する個人記事のほうがわかりやすい場合は多い。

[dexia2]

最近の開発（Web）だと検索しても解決方法が見当たらなくて、公式リポジトリのIssueをみに行くしかないことが多いです。問題があってもそのライブラリを使っているリポジトリを探した方が早いので、ずっとGitHubにいます

[gabill]

リファレンスは枝葉過ぎて、チュートリアルは根っこ過ぎる。枝葉と根っこの中間地点をフォローしてくれる情報が求められてる気がする。

[MzdA0w73tg]

どうしてQiitaのコミュニティガイドラインが読めないのか？

[uunfo]

これかなあ「原因3. 全体像を理解していない」勘が働かないんだよね。あと実用的なサンプルが乏しい

[cl-gaku]

詰みポイントは結局Issueに頼るのあるあるだな

[tsutsumi154]

日本語で検索すると先に変なブログばかり出て公式ドキュメントにたどり着かないので最近は英語で検索してる/変なって言ったら悪いか あれはあれで参考にしてるけど

[Kil]

「公式ドキュメントだけでは解決できない問題」はもちろんある。でも、「だから公式ドキュメントなんて読まない」という理論展開されたら、お前バカだろ、としか言えない。

[nakex1]

仕事や生活のさまざまな場面に法律は関わっているのに条文を読まないようなものだろう。弁護士等の専門家になるか，すごくシビアな場面に出くわさないかぎり，それで済んでしまうことも多い。

[ch0ge]

公式ドキュメントが会社のプロキシで制限されていて読めない (つらみ)

[nekoruri]

公式ドキュメントを最初からきちんと読みにいく初学者は初学者でいる期間が短いからでは(つまり負の生存バイアス)

[isaisstillalive]

検索しても公式ドキュメントがトップに出てこなかったり、9年前に更新が止まってる私家版リファレンスがしゃしゃり出てきたりと探すのが非常に面倒なんだけどこういうのどうにかならんのかな

[pf_siedler]

"原因3. 全体像を理解していない"がわりと大事な気がする。あと"原因6.公式ドキュメントが読ませる目的で書かれていない"は結構多い / 「どうして○○なのか」系記事なのに理由が書いてある…だと…！？

[tespple]

いわゆるCookbookがみんな欲しいのではないだろうか

[tomoyat1]

“いつまでも二次情報に頼っていたら一人前のエンジニアにはなれません。” ですよね。

[sayamatcher]

思い当たるフシあり。特に、原因3と5

[yajamon]

公式ドキュメント"が""無い" / 嗚呼、更新されないフレームワークに載ったシステムよ…

[nacika_inscatolare]

note.muかな？

[diveintounlimit]

自分が経験してきた現場的にはStack Overflowが7.5割、Issueが2.4割、公式ドキュメントが0.1割くらいかな…公式ドキュメントが役に立つケースって少ない。

[daishi_n]

AWSとAzure比較したらドキュメントが真っ当なのはAWSだったな

[tech0403]

AWSは日本語版あるが、英国版ともに詳細過ぎて終ってるパターン。あれ見てサービスの内容が理解できる人どれだけいるんだろう。

[su_zu_ki_1010]

ガイドラインには「プログラミングに関する記事を投稿しましょう。」とあるので、公式ドキュメントを読もうぜ！というこの投稿は問題なしと思ってる。いくつか公式ドキュメントの紹介もあるし。

[sho]

OSS Gateで最初にやるのは「公式ドキュメントだけを参考にしてOSSを動かすこと」です。動かなかったら公式にフィードバックする(この記事でそこに触れてないのは残念)。なおQiitaは禁止w

[mrkn]

公式ドキュメントを読むことを勧めていてとても良いのだけど一点だけ間違いがある。公式ドキュメントは実は一次情報ではない。一次情報はソースコードです。

[kaipu1224]

検索すると同じようなサンプルが沢山出てくるんだよね。公式の最初のサンプルレベルのが。

[miho-satoh-satomi]

公式ドキュメント読もう

[vndn]

思想とかパターンとか、あるいは複数ある実装のうちよりモダンなのはどれ、みたいな話はリファレンスにないからなあ。とはいえ読むべきだとは思うよ。

[yuki_2021]

基本をきっちりとこなすことの重要性

[ykore52]

チュートリアルより一歩踏み込んだサンプルが欲しい

[newnakashima]

公式ドキュメントって中の人目線だから初心者が知りたいことが載ってない。手っ取り早く始めるなら個人が書いたハンズオン記事読んたほうが速い

[underdog_slumber]

余計分からなくなることも度々

[munyaX]

クソブログだなぁ…と思ってスクロールしてたら、最後にドワンゴのロゴ。今話題の会社ですね！

[vanbraam]

どんな理由があっても,公式ドキュメントを読まない技術者はダメ.読んでから文句を言え,と思う

[marmot1123]

自分は結構読んでいるつもりだけど、技術力はなかなか上がらない。

[rin51]

net-snmpにagentを追加する方法として公式ドキュメントに「agent/exampleがあるから見てね」と書いてあった

[mezamashi0540]

JavaとかAndroid SDKは期待する情報を得られやすいんだけど、swiftはどうにも欲しい情報が見つけられないんだよなー。パラメータとか1行だけで欲しい情報が見つからないことがザラ。なんでかなあ。

[deokisikun]

読んで幸せになれる公式ドキュメントとそうじゃないものがある

[micromillion]

なんと言うか、概念や全体像が分からないのと、逆に使われている単語のひとつひとつから想起されるイメージが初学者と既習者とでズレている、マクロとミクロの問題が存在してる印象はある。

[beerbeerkun]

原因6. 公式ドキュメントの情報が薄くて役に立たない。これは読めない原因にはならんか。