問題のラベル

ラベルは、問題と pull リクエストをフィルタリングできる GitHub の便利な機能です。経験レベルに合った楽しい課題を見つけるのに役立ちます。

リポジトリでは、問題への新しいラベルの追加は、コア Blockly チームのみが行います。これにより、ラベルが間違った場所に配置されるのを防ぎます。

サイズ

すぐに解決できる問題もあれば、解決に数週間かかる問題もあります。これらのラベルは、問題の解決にどの程度の作業が必要になるかを判断するのに役立ちます。

  • Good first issue: これらの問題は、リポジトリを初めて利用するユーザーに最適です。半日以内の作業で、コードベースに関する知識もあまり必要としないはずです。チームの承認なしで、これらの問題にすぐ取り組むことができます。

法域

広く使用されているリポジトリでの作業はデリケートなプロセスであり、問題によっては他の問題よりもデリケートな場合があります。これらのラベルは、どの問題がコントリビューションの対象であるか、どの問題は避けるべきかを判断するのに役立ちます。

  • Help wanted: これらの問題は投稿者向けです。多くの場合、コアチームが有用だと考えているものの、実装する時間がない機能です。ディスカッションまたは実装が必要な場合があるため、ステータス ラベルを確認して、必要な作業を確認します。ここでは、楽しいクリエイティブ プロジェクトを見つけることができます。
  • 内部: これらの問題は、コアチームのメンバー専用です。多くの場合、特別な議論が必要なデリケートなバグや複雑なバグです。このような状況は急速に変化する可能性があるため、避けることをおすすめします。
  • どちらでもない: どちらのラベルも付いていない問題は、投稿者とコアチームのメンバーが修正できます。興味のあるラベルなしの問題を見つけたら、ぜひ取り組んでみてください。

ステータス

特定の問題(特に機能リクエスト)は、「クローズ」と見なされるまでにいくつかの異なる段階を経ます。これらのラベルは、問題が現在どの段階にあるかを示しているため、次に何を行う必要があるかを確認できます。

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

タイプ

問題によって対応が異なります。数行のコードを編集するだけで済むものもあれば、多くの設計と議論が必要なものもあります。これらのラベルは、問題に必要なアクションの種類を示します。

  • バグ: これらの問題は、コードベースの問題を文書化したものです。問題の原因を診断するにはデバッグが必要になることが多いですが、すぐに解決できるものもあります。コードの仕組みを深く掘り下げて学びたい方には、これらの問題が最適です。バグを修正するか、問題を理解して根本原因を明確に説明することで、貢献できます。
  • 機能リクエスト: これらの問題は、追加してほしい機能について記述したものです。これは、リポジトリ全体または個々のプロジェクトに適用できます。設計のアイデアを具体化したり、新しい機能を追加したりするのが好きなら、これらの問題はあなたにぴったりかもしれません。
  • 質問: これらの問題は、コードベースに関する質問を記録したものです。通常、これらの質問はデベロッパー フォーラムに転送されますが、回答できる質問を見つけた場合は、お気軽にご参加ください。

カテゴリ

このリポジトリには、いくつかの異なる種類のプロジェクトと、いくつかの異なる種類のターゲット ユーザーが含まれています。チュートリアルに情熱を注いでいる方や、プラグインの作成に熱心に取り組んでいる方は、これらのラベルを使用して、関心のある問題を見つけることができます。

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

プロジェクト

さらにきめ細かい制御が必要な場合は、個々のプロジェクトのタグも使用できます。これらは通常、プラグイン用に作成されます。プラグインには関連する問題が多く発生する傾向がありますが、コードラボやサンプル用に作成することもできます。特定のプロジェクトに関心がある場合は、これらのラベルを使用して、そのプロジェクトに関連する問題を見つけることができます。

目的のプロジェクトにラベルがあるかどうかを確認するには、ラベルの完全なリストをご覧ください。

その他

他のコレクションと同様に、知っておくべき例外がいくつかあります。これらのラベルは、取り組むべき問題を探す際にはあまり役に立たないかもしれませんが、それでも有益な情報を提供できます。

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