Kodokon kodokon.com

答えがもらえる質問のしかた

助けを求めるときの組み立て方を整えて、速い返事をもらいましょう。最小限の再現例も知っておきましょう。

7 分 · 3 問

このレッスンを Kodokon で開く

助けを求めるのは弱さの告白ではありません。誰もが毎日していることで、いちばん経験のある人たちも同じです。ただし、うまく組み立てられていない質問は、返事がないまま終わることがよくあります。意地悪だからではありません。「動きません、助けてください」には、使える情報が何ひとつ入っていないからです。あなたのコードも、あなたの環境も、すでに試したことも、誰にも推し量れません。

よい質問には5つの材料があります。何をしようとしているのかを一文で。何をしたのかを、関係するコードとともに。どんな結果を期待していたのか実際には何が起きるのかを、そのままコピーしたエラーメッセージとともに。そしてすでに何を試したのか。同じ案を三度も出されずに済みます。さらに、自分の環境も添えましょう。OS、言語、そしてバージョンです。

TEXT
目的:ページに記事の一覧を表示したい。
環境:Windows 11 の Python 3.12。
コード:(問題が起きている短い抜粋)
期待:3つのタイトルが表示される。
実際:TypeError: 'NoneType' object is not iterable
試したこと:ファイル名を確認、printを追加。
そのまま写して使える質問のひな形。6行あれば十分です。

助けてもらうための最良の道具は、最小限の再現例と呼ばれます。考え方はこうです。問題がまだ再現する、いちばん小さな断片までコードを削っていく。関係のないものを一行ずつ取り除き、本質だけが残るまで続けます。この作業には意外な副産物があります。とてもよくあることですが、質問を投げる前に、その途中で自分自身が原因を見つけてしまうのです。

最後にもう一つ、忘れられがちなこと。助けてもらったら、お礼を言い、うまくいった方法を書き残しましょう。うまく組み立てられ、きちんと締めくくられた質問は、あなたのあとで同じ問題にぶつかる百人のための答えになります。あなたが今入ったコミュニティ全体は、そうやって回っています。そしてあなたは、もうその一員です。

理解度チェック

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

  1. 「動きません、助けてください」のような質問に、返事が付かないのはなぜですか?
    • なれなれしすぎると受け取られるから
    • 使える情報が何ひとつ入っていないから
    • 答えをもらうには必ずお金を払う必要があるから
  2. コードをスクリーンショットではなく文字で貼るのはなぜですか?
    • コピーでき、試すことができ、中を検索できるから
    • フォーラムでは画像が禁止されているから
    • 文字のほうが速く表示されるから
  3. 最小限の再現例とは何ですか?
    • プロジェクト全体を圧縮した書庫ファイル
    • 問題がまだ再現する、いちばん小さなコードの断片
    • コードをまったく含まない、問題の説明
    • エラー全体のスクリーンショット