Kodokon kodokon.com

効率よく調べる:ドキュメント、検索エンジン、AI

よい検索の言葉を組み立て、情報源の信頼度を見きわめ、罠にはまらずにAIを使いましょう。

8 分 · 3 問

このレッスンを Kodokon で開く

すべてを覚えている人はいませんし、覚えようとする人もいません。経験15年の開発者も、初心者と同じくらい調べます。ただ、もっとうまく、もっと速く調べるだけです。調べ方を知っていることはズルではなく、この仕事で一番大切な能力です。しかもうれしいことに、それはいくつかの簡単なルールに集約されます。

よい検索は3つの部分でできています。関係する言語やツールエラーメッセージの共通部分、そしてそれ以外は何も入れないこと。よくある落とし穴は、自分のファイルパスや変数名が入ったままのメッセージを、そのまま貼り付けてしまうことです。あなたと同じ名前のフォルダを持っている人は世界のどこにもいませんから、結果は1件も返ってきません。個人的なものを取り除き、誰にでも当てはまるものを残しましょう。

TEXT
悪い検索:
C:\Users\Marie\projects\site\app.js NameError quantity

よい検索:
javascript TypeError cannot read properties of undefined
パスや個人的な名前は取り除き、共通する言い回しだけを残します。

情報源はどれも同じ価値ではありません。順番に挙げると、まずはツールの公式ドキュメント。そっけなくても必ず最新です。次にWeb関連ならMDN。それからStack Overflowのような質問回答サイトは、具体的なエラーにとても役立ちます。最後にブログや動画は、読みやすい代わりに古くなっていることが少なくありません。ある回答に従う前に、2つのことを確かめましょう。その日付と、扱っているバージョンです。

対話型のAIは、調べ物の相棒として優秀です。エラーメッセージをやさしい言葉で説明し、分かりにくいドキュメントを言い換え、出発点を示してくれます。しかし同時に、存在しない関数やオプション、アドレスを平然と作り出すこともあります。これをハルシネーション(幻覚)と呼びます。黄金律は単純です。理解するために使い、正確な細部は公式ドキュメントで確かめること。そして、自分の状況、使っているバージョン、エラーメッセージの全文を必ず渡しましょう。

理解度チェック

このレッスンの要点をしっかり覚えているか確認しましょう。

  1. エラーメッセージから検索の言葉をどう作りますか?
    • パスや変数名も含めて、メッセージ全体を貼り付ける
    • メッセージの共通部分を残し、個人的なものを取り除く
    • メッセージを一切引用せず、自分の言葉で問題を説明する
  2. フォーラムで見つけた回答に従う前に、何を確かめるべきですか?
    • 回答に付いたコメントの数
    • 公開された日付と、対象にしているバージョン
    • 回答の長さ
    • 書いた人の出身国
  3. AIが返してきた答えには、どう向き合うべきですか?
    • そのまま写す。AIは間違えないから
    • 無視する。AIはコードの学習の役に立たないから
    • 理解するために使い、細部は公式ドキュメントで確かめる