優れたプロジェクトはすべて、ユーザーのフィードバックに基づいて構築されています。Blockly は GitHub の問題を使用してフィードバックを追跡します。このページでは、デベロッパーが簡単に読んで対応しやすい問題を作成する方法について説明します。これにより、バグレポートや機能リクエストが対処される可能性が高くなります。
事前作業
ご質問は
ご質問をお待ちしております。しかし GitHub の問題は、そのようなメディアには適していません。ご不明な点がございましたら、デベロッパー フォーラムをご利用ください。ここに質問すると、何年にもわたって Blockly を使用しているデベロッパーがたくさんいるため、より適時に徹底した回答を得られる可能性が高くなります。
重複のチェック
問題を作成する前に、一致する問題がすでに存在するかどうかを確認することをおすすめします。そうすれば自分で書く手間を省けますそのため、作成を開始する前に、重複や関連する問題を検索してください。
- blockly-samples で検索する
- 「Blockly core」で検索します。
- フォーラムを検索
一致する問題が見つかった場合は、高評価をつけるか、自分の考えを詳しくコメントします。これは、バグレポートや機能リクエストの場合に特に重要です。ある問題が注目を集めていることをデベロッパーが把握できれば、対応できる可能性が高くなります。
バグを報告
バグを見つけたと思いますか？では次に、Google は、できるだけ安定したものにしてほしいという思いから、バグレポートをお待ちしています。ここでは、バグを修正する手順をいくつかご紹介します。
証拠収集
一般的に、バグの情報が多いほど結果は良くなります。提供する必要があるものは次のとおりです。
- バグが原因で視覚的な問題が生じる場合は、スクリーンショットや GIF が大いに役立ちます。
- サンプルコードは、バグが特定の種類のブロックまたはワークスペースの構成にのみ影響する場合に便利です。
- ホストされているサイトは、特定の環境以外でバグを再現するのが難しい場合に最適です。
問題を特定する
コアライブラリ、プラグイン、サンプル、Codelab の間に、多くの Blockly コードがあります。お手数ですが、問題のある箇所を正確にお知らせいただけますと幸いです。
根本的な問題である場合、どのコンポーネントですか。たとえば、ツールボックス、ズーム コントロール、ライブラリ ブロックに問題がある可能性があります。できるだけ具体的にご記入ください。
問題がブロックサンプルにある場合は、どのプラグイン、Codelab、またはサンプルにあるかを特定します。同じバグが複数の場所で見つかった場合は、その旨もお知らせください。
生殖を確実なものにする
バグは再現可能な場合にのみ修正できます。そのため、問題を送信する前に、バグを発生させる確実な方法があることを確認してください。
バグを再現する方法をデベロッパーに示す手順のリストが番号付きで表示されます。例:
- X Codelab を開きます。
- [Y] ページに移動します。
- Z サンプルコードを実行します。
- 不正な動作（W など）を確認します。
問題が Blockly Core にある場合は、playgroundで再現してください。
理由を提案
バグが発生している理由がわかっている場合は、その情報も含めてください。繰り返しますが、できるだけ具体的にご記入ください。
問題を記述する
いよいよバグレポートを作成する準備が整いました。リポジトリを選択します。
ここで説明されていないものも含め、問題テンプレートのすべてのセクションに記入してください。
バグのご報告に関心をお寄せいただきありがとうございます。
次のステップ
- バグレポートには、自動的にトリアージ用のタグが付けられます。
- Blockly チームのオンコール メンバーが確認し、場合によっては明確な質問をします。また、バグを整理するために使用するラベルも追加されます。
- 問題に [Help Wanted] と表示される場合は、申請して対応を開始できます。
- この問題は、Blockly チームのメンバーが解決のために割り当てられることがあります。
- 問題には、いつ解決されるかを示す四半期ごとのマイルストーンが表示されることがあります。
- この問題は Icebox マイルストーンで設定される場合があります。つまり、当面は問題に取り組む予定がありません。
- これは、頻度の低い問題や既知の回避策があるバグが原因で発生する可能性があります。
- Iceboxed の問題には引き続き対応できます。
- 問題が Bug Bash Backlog マイルストーンに配置されることがあります。これは、緊急ではないものの、修正が必要な問題です。
- 各四半期の終わりに、チームは Bug Bash Backlog のマイルストーンから抽出されたバグに数週間を費やします。
- この問題は、必要に応じて Blockly コアから blockly-samples に移動する（またはその逆）できます。
- この問題はクローズしている可能性があります。
機能のリクエスト
Blockly を改善するため、何か変更したいことはありますか？プラグイン、サンプル、Codelab のアイデアがある場合は、すでに気に入っているものがあり 改善方法を見つけたらどうなるでしょう？もしそうならば、ここがぴったりです！レスポンスを受け取れる優れた機能リクエストを作成する手順は以下のとおりです。
要件を確認する
どのアイデアも、このリポジトリに保存してあります。残念ながら、私たちは人間にすぎないため、どのようなリクエストに対応するかについていくつかのガイドラインを設けています。
各カテゴリ プロジェクトのガイドラインは次のとおりです。
- Blockly Core
- プラグイン
- 例: Blockly の機能を 1 つまたは 2 つだけ使用する方法を紹介する。
- Codelab: 1 つのタスクを実行する方法や、1 つの動作を実装する方法を確認します。
しかし、これらは厳格で明確なルールではありません。機能リクエストの作成に時間をかける前に、Google が求めているものを把握できるようにすることが目的です。
役立つかどうかわからない場合は、デベロッパー フォーラムに投稿してください。アイデアが通用しなかった場合でも、サードパーティのプラグインやチュートリアルとして作成してください。
考えを収集する
提出する前に、見かけたアイデアや図表でアイデアを完全に完成させる必要はありませんが、何を求めているかはしっかりと把握できている必要があります。作成を始める前に、次のような点について考えてみてください。
- この機能が必要な理由
- この機能により問題が解決しますか？
- この機能の対象ユーザー
- この機能が役立つ理由
- 同じことを達成できる代わりの方法は何ですか。
これらを理解すれば、優れた機能リクエストの実現に近づくことができます。
機能リクエストを書く
これで、機能リクエストを作成する準備が整いました。リポジトリを選択します。
ここで説明されていないものも含め、問題テンプレートのすべてのセクションに記入してください。
機能リクエストの送信に関心をお寄せいただきありがとうございます。問題の作成にご協力ください。
次のステップ
- 機能リクエストにはトリアージ用のタグが自動的に付加されます。
- Blockly チームのオンコール メンバーが確認し、場合によっては明確な質問をします。また、バグを整理するために使用するラベルも追加されます。
- 対象物に「Help Wanted」とマークされる場合があります。その場合は、申請して作業を開始できます。
- この機能は、実装のために Blockly チームのメンバーに割り当てることができます。
- 機能リクエストは、必要に応じて Blockly コアから Blockly-samples に移動できます（またはその逆）。
- 機能リクエストを閉じることもできますが、その場合でもサードパーティ プラグインとして実装できます。