問題のラベル

ラベルは GitHub の便利な機能で、問題をフィルタしてリクエストを pull できます。自分の経験レベルに合った楽しい内容を見つけることができます。

Google のリポジトリでは、問題への新しいラベルの追加は、間違った場所に配置されないようにするため、中核となる Blockly チームのみが行います。

サイズ

小さくて見栄えの良い問題もあれば、何週間もかけて解決できる問題もあります。これらのラベルは、ある問題にどのくらいの労力がかかるかを確認するのに役立ちます。

  • 良い最初の問題: リポジトリを初めて使用する人に適しています。作業は半日もかかりません。また、コードベースにもあまり馴染みがなくても大丈夫です。チームの承認を得ずに、これらの問題への取り組みをすぐに開始できます。

法域

広く使用されているリポジトリでの作業は機密性の高いプロセスであり、一部の問題は他の問題よりも機密性の高い場合があります。これらのラベルは、どの問題が未解決で、どの問題を回避すべきかを見分けるのに役立ちます。

  • サポートが必要な問題: これらの問題は投稿者を対象としています。多くの場合、コアチームが便利だと思う機能であるものの、実装する時間がありません。ディスカッションや実装が必要になる可能性があるため、ステータス ラベルをチェックして、必要な作業を確認してください。ここで、楽しいクリエイティブ プロジェクトを見つけることができます。
  • 社内向け: 以下の問題は、コアチームのメンバー向けです。多くの場合、特別な議論が必要なデリケートなバグや複雑なバグです。このような状況は急速に変化する可能性があるため、このようなケースは明確にしておくことをおすすめします。
  • どちらでもない:どちらのラベルも付けられていない問題は、コントリビューターとコアチームのメンバーが修正できます。ラベルのない問題で興味深いことに気づいたら、すぐに対応してください。

ステータス

特定の問題(特に機能リクエスト)は、いくつかの段階を経て「クローズ」されたと見なされます。これらのラベルは問題が現在のステージを示すため、次に何をすべきかを判断できます。

  • ディスカッション: これらの問題はディスカッション フェーズにあるため、実装前に回答すべき質問がまだ残っています。この問題についてご意見がございましたら、お気軽にコメントしてください。Google では、常に皆様からのご意見をお待ちしております。
  • 実装: これらの問題については十分な議論があり、明確に定義され、実装フェーズに移りました。実装を待っている状態、またはすでに実装されている状態のいずれかです。ご関心をお持ちでしたら、問題全体を読んで、作業したい部分をコメントとして残してください。その作業にとどめてください。
  • どちらでもない: どちらのラベルも付けられていない問題は、どちらの状態にもなりません。問題の実装方法についてご意見がある場合は、コメントをお寄せください。また、この問題への取り組みに関心をお持ちの場合は、実装の準備ができているかどうかを尋ねるコメントを残すことをおすすめします。

種類

問題によって対応は異なります。数行のコードを編集するだけの場合もあれば、多くの設計と検討が必要な場合もあります。これらのラベルは、問題に必要な対応を示します。

  • バグ: これらの問題には、コードベースに関する問題が記載されます。多くの場合、問題の原因を診断するためになんらかのデバッグを行いますが、中にはすぐに修正できるものもあります。コードがどう機能するかを詳しく調べる場合、これは非常に重要な問題です。バグを修正するか、問題を深く理解して根本原因の明確な説明を記述してください。
  • 機能リクエスト: こうした問題には、ユーザーが追加してほしい機能が記載されています。これは、リポジトリ全体または個々のプロジェクトに適用できます。設計のアイデアを具体化して新機能を追加することが目的の場合、これらは最適な問題になる可能性があります。
  • 質問: これらの問題には、コードベースに関するお客様からの質問が記載されています。通常、これらの質問はデベロッパー フォーラムにリダイレクトされますが、サポートできそうな質問を見つけた場合は、お気軽に参加して回答してください。

カテゴリ

このリポジトリには、異なる種類の対象グループを持ついくつかの異なる種類のプロジェクトが含まれています。チュートリアルやプラグインの作成が好きな場合は、興味のある問題を見つける際にこれらのラベルが役立ちます。

  • Codelab: これらの問題は、インタラクティブなチュートリアルのスイートである Blockly Codelab に関連しています。
  • : これらの問題は、Blockly のサンプル(Blockly をインクルードして拡張する方法を示す自己完結型のデモ)に関連しています。
  • プラグイン: この問題は、Blockly プラグイン(Blockly の機能を追加する拡張機能のコレクション)に関連しています。

プロジェクト

より詳細な情報が必要な場合は、個々のプロジェクトのタグも使用できます。これらは通常、関連する問題が多い傾向があるプラグイン用に作成されますが、Codelab やサンプル用に作成することもできます。関心のある特定のプロジェクトがある場合は、これらのラベルがプロジェクトに関連する問題を見つけるのに役立ちます。

また、新しいプロジェクトが頻繁に追加されるため、このリストは最新のものではなくなる可能性があります。目的のプロジェクトのエントリが表示されない場合は、ラベルの一覧をご覧ください。

Other

他のコレクションと同様に、知っておくべき奇妙なボールがいくつかあります。これらのラベルは、対処すべき問題を検索するときにはあまり役に立たないかもしれませんが、情報として役立ちます。

  • トリアージ: これらの問題は、コアチームによってまだ適切にラベル付けされていません。このラベルが付いた問題には、バグ機能リクエストなどのシンプルなラベルがすでに追加されている場合がありますが、近いうちにさらにラベルが追加される可能性があります。
  • 重複: 別の問題ですでにカバーされている問題、リクエスト、質問を文書化する問題です。このラベルは、この問題には返信するのではなく、元の問題に返信する必要があることを示しています。