公式ドキュメントを読もう — みんなのウェディングエンジニアリングブログ

みんなのウェディングの高井です。 最近、若手のエンジニアと話をする機会が多くあります。そういった場で、ここが重要ですよと伝えたい話のうちのひとつがこの話になります。別のところに書いていたものですが、すこし手を入れた上で再掲します。 ハッカーの世界には昔から「RTFM」という言葉があります（参照）。ようするに「マニュアルを読め」という言葉なのですが、これはとても重要な言葉です。 色々な人によってブログにメモやノウハウが記載され、簡単に検索でみつかる世の中ではあります。また、そのためのサービスや技術的な質疑的な質問をすることのできるサービスも沢山あります。 しかし、検索サービスは、その内容が正しいことまで保証してくれません。見つかった記事の著者が誤解している場合もあれば、理解していない場合もあります。そして、ほとんどの場合は最新の情報ではありません。 マニュアルや公式ドキュメントであれば、それ

[anoworl]

これ系でもう一つ「エラーを読め」

[YaSuYuKi]

マニュアルを読んでわからなくてソースコードを読むのもよくある

[oooooo4150]

公式ドキュメントを自力で読めるだけの英語力がないでござる

[tbsmcd]

ウェディング……公式ドキュメント……民法？みたいな話を想像してしまった。

[mrkn]

「公式ドキュメントを読みましょう」に対して「英語が〜」とか言ってる時代ではない。読めない人はただ置いていかれるだけ。

[shioki]

“ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません”

[yokochie]

『ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません。』

[a2ikm]

Dash超便利

[aomori-ringo2]

1次情報にあたろう

[nn1021]

確かに公式ドキュメントを読んだことは全然ないな。

[takashiski]

Fだけわからん。Fってなんだろう？→いつものあれだった“RTFM”

[Tomato-360]

その通りだと思った。ちゃんと読まねば。

[tuto0621]

Railsガイド(日本語版) http://railsguides.jp/

[hirata_yasuyuki]

言ってることは概ね同意。(公式ドキュメントにあたる前に、ググって大まかに把握する程度は許して欲しい。) Browsing: “公式ドキュメントを読もう — みんなのウェディングエンジニアブログ”

[nullpop8857]

“ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません。これは、まったくの間違いで

[ya--mada]

OSS界隈か。製品でもマニュアル腐ってんだよな！

[usgitan]

railsは特に公式ドキュメント読もう

[thleap]

大切なことだと思う。公式ドキュメントが英語でも、がんばろう。

[torounit]

あ、でもPHPの公式の下の方は読まなくて良いと思う

[fjwr38]

はい。。。。 / “ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません。これは、ま

[taketyan]

英語読めなくてもエラーメッセージググればなんとかなるんでググってくれ頼む

[vanbraam]

タイトルには大賛成;でもRailsのマニュアルがよくできているとは到底思えない.努力はしていると思うが,大抵の場合,欲しい情報は得られず最後はソースを読む事になる.そしてそのソースも黒魔術で検索しづらい

[wyukawa]

“ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません。”

[n-sega]

rtfm

[kkeisuke]

公式ドキュメントに書いてないことをしようとすると大抵失敗します。

[valinst]

ぐぐって出てきたページを見て多角的に見ることも理解を早めるには大事な気がしてるけど。

[koyancya]

ksk

[suginoy]

ごめんなさい。 “ノウハウサイトからコードや設定の断片をコピーアンドペーストをして、「うまくいった」「うまくいかなかった」とトライアンドエラーを繰り返すのは、エンジニアリングではありません。”

[laiso]

Google検索の site: オプションで公式ドキュメント内から検索する、とかよくやる

[koogawa]

読みます

[unagi_tabetai]

もっともだ

[Windymelt]

ただ検索しかしていない自分に気付かされる。公式大事

[iori_o]

read the fxxking manual

[gin0606]

api.rubyonrails.org は見まくってる

[nkskname]

社長だかが自腹で結婚式やって大問題になった奴って結局どうなったの？

[Cald]

“ハッカーの世界には昔から「RTFM」という言葉があります（参照）。ようするに「マニュアルを読め」という言葉なのですが、これはとても重要な言葉です。”

[wkubota]

シンプルだけど大事な話。しかもコンテキストによらずほぼ普遍的な内容。