問う前に読みましょう

• QQ/WeChatなどのコミュニケーションツールは、迅速で使いやすいコミュニケーション方法を提供していますが、問題に直面した場合、以下の手順を遵守することをお勧めします。
• 最終的に役立つ回答を得られるかどうかは、あなたが質問や追加質問の仕方によって大きく異なります。

問題解決のステップ：

1. 自分で解決を試みる：あなたが持っている知識を使ってまず自分自身で問題を解決してみてください。英語の出力情報に驚かされないで、できるだけそれを理解してください。ほとんどの情報出力には方向性があり、あなたがそれを見つけて自分で解決しようと試みればよいのです。
2. インターネットで検索する：インターネットで検索して、似たような問題に遭遇した人がいないか確認してください。いた場合は、まず他の人の解決策を参考にしてください。いなかったら、グループ内で質問してください。
3. グループ内で質問する：グループ内で質問する際は、まず問題を明確に説明し、スクリーンショットを添えてください。準備されている情報が豊富であればあるほど、他人が問題を解決する効率は高くなります。

質問する際には、以下をできるだけ満たすと、問題が迅速に解決される可能性が高まります：

回答者の立場で問題を考えるようにしましょう

各質問において、解答者の立場で考えるようにしてください：

• 解答者はすべての専門家であり、彼らの時間は貴重です。
• 一瞥で自分の質問が理解できるようにしてください。できれば、回答者が私に何をしたのか、目的は何なのかなど、基本的な質問をしなくて済むようにしてください。
• 回答者が私の質問に答えたいと思う理由、例えば技術的な議論の深さ、回答者に尊敬の気持ちを感じてもらうこと、または直接お金を支払えることなど。
• 回答者に私が怠惰で、ドキュメントもコードもログも見ていなかったり、検索や思考、試行錯誤を一切しなかったりして、ただ質問に来たように感じさせないでください。

問題を整理し、実際に何が起こったのか、そして自分が何をしたのかを明確にしましょう、以下の点を含みます：

• 私が達成したい効果や機能とは何か？
• この効果を実現するために、私はどうしましたか？詳細なプロセスは何か？
• 実施中に何のエラーが発生しましたか？現象は何か（例えエラーが発生した場合、どのようなエラーが発生したのか、完全なエラーメッセージは何か？最終的ないくつかの行だけを見ないで、できるだけログを前まで見てください）
• 私はエラーメッセージをしっかり見ましたか？エラーメッセージにはエラーの原因や解決方法に関するヒントがありますか？
• このエラーメッセージに基づいて、問題を解決できるでしょうか？
• ドキュメント、FAQ、issue、および検索エンジンを使って、問題の解決方法が見つかるか確認してください
• ドキュメントに不備がある場合、直接指摘してください！心配しないでください、私は大ベテランではないので考慮が不十分なところがあるかもしれません！！

効率的でない、あるいは無効な質問

• 質問：ご指導お願いします、この問題はどうやって解決すればいいですか？

問題点

• スクリーンショットを撮る スクリーンショットを撮るより、スクリーンショットを取ってください。特別な事情がない限り、スクリーンショットを鮮明に撮ってください
• 情報が不完全 CAN IDが見つからない問題には多くの種類があります。例えば、線が接続間違っている、上位機と下位機の速度などが挙げられます。あなたの問題を特定のシナリオに限定し、具体的な条件を示すことで、問題の焦点を絞ることができます。
• スクリーンショットを取れない場合、これはスクリーンショットのチュートリアルをご覧ください

質問テンプレート

質問を丁寧にし、余分な表現や不満の言葉を追加しないでください。各単語や句読点を吟味し、回答者の立場から問題を考え、どのようにして回答者がすぐに問題を解決してくれるかを考えるようにしてください。文字数が少なすぎると説明が不明瞭になり、多すぎると読む気が失せます。

自分で解決できない問題を誰かに尋ねる必要がある場合、考慮すべき点は以下の通りです：

• 誰に尋ねるのか、どこで尋ねるのか、誰が自分の質問に答えやすいか、そしてリアルタイム性はどうか？

• 何の情報を提供すれば、相手がすぐに問題を解決してくれるでしょうか？

  • 目的を提供してください（回答者が何をしているのかを知るため）
  • 完全な実施プロセスと、プロセス中に発生した現象を提供してください（回答者があなたのプロセスに従って同じことをして問題を再現できるようにするため）
  • エラーが発生した場所を指定してください。どこが予期した結果と異なっているのかを明確に教えてください！（回答者がどこが予期していないかを知ることができるようになります）
  • 発生したエラーメッセージを提供してください。できるだけ多くのスクリーンショットやログを提供してください。決して一枚の小さな画像やログの一部だけを提供しないでください（回答者が長い間この作業をしていないため、細かい部分を忘れている可能性があるため、スクリーンショットや完全なログで思い出せるようにする必要があります。また、詳細なログがあれば、問題の所在を迅速に特定できます）

• どのように質問すれば誠意が伝わるでしょうか。たとえ私が初心者でも、皆が答えてくれるでしょう

タイトル

どこで質問するかに関係なく、自分の質問に30文字程度のタイトルをつけてください。問題の中心思想を説明し、以下の内容を含めます：

• 問題のカテゴリ、質問、バグの提出、経験の共有など。画面いっぱいの文章の中で、すぐに何をしたいのかがわかります
• 一文で問題の中心思想を説明してください。例えば、CAN IDが見つからない、マザーボードが接続できないなど

これらを総合すると、タイトルは次のようになります：

• 【質問】 SHT36V3がCANIDを見つけることができず、確認した内容など

こうしたタイトルは絶対に以下のようなものになってはいけません：

• ああああああああなんで私のボードがIDが見つからないの（私がどう接続したり操作したりしているか知らないですよね）
• なぜ私の上位機が起動しないの（私がどの上位機を使っているか知らないですよね）
• なぜ私のところにデバイスがないの（私がどんな製品を使っているか知らないですよね）
• このエラーは何のエラーですか（ドキュメントを読まなかったので、最初から質問している）
• メインボードを受け取ったけど、ドライバをどう接続すればいいの（ドキュメントを読まなかったので、最初から質問している）
• この線はどう接続すればいいの（どんな問題なのか分からない）
• DFUに入れた後、焼込みができなかったのはなぜですか？DFUに入れないのはなぜですか（あなたがどう操作したか、どう接続したかを教えてくれないと、他人はあなたが適当に言っていると思って無視してしまうかもしれません）

こう質問するのは良いです：

• 【質問】私のボードに電源を逆接続した後、現在ボードが起動できません。ボードがどの部分が壊れたかをどうやって判断すればいいですか？もし可能であれば、どうやって復活させればいいですか
• 【バグ】このドキュメントのここは説明が不完全です。類似の内容を追加または修正していただければと思います

参考テンプレート

• 問題を整理する時間を少し使って、以下の情報を明確に記述してください：
• 最終的に役立つ回答を得られるかどうかは、あなたが質問や追加質問の仕方によって大きく異なります。

1. どんな問題か 例：新しい購入したマザーボードとツールボードがデバイスを見つけることができない
2. どんなハードウェア機器か 例：セットトップボックス + D5マザーボード + SHT36V3
3. どう接続したか 例：接続状況を高解像度の画像で専門家に送る
4. どんな問題現象か 例: 上位機でlsusbを入力してもデバイスが表示されないなど。完全な情報のスクリーンショットを添付してください。

【質問】D5マザーボードとSHT36を購入し、セットトップボックスの上位機でlsusbを使用してデバイスを見つけることができませんでした