ラベルについて
作業を管理するとき、GitHub ラベルを作成して Issue とプルリクエストを分類することができます。 ラベルが作成されたリポジトリ内にラベルを適用できます。 ラベルが作成されると、そのリポジトリ内の任意の Issue またはプルリクエストでラベルを使用できます。
リポジトリへの読み取りアクセスを持つ人は、誰でもリポジトリのラベルを表示・検索できます。 リポジトリへのトリアージアクセスを持つすべてのユーザは、既存のラベルを適用/却下できます。 ラベルの作成、編集、適用、削除をするためには、リポジトリに書き込みアクセスができなければなりません。
デフォルトラベルについて
GitHub は、すべての新しいリポジトリにデフォルトのラベルを提供します。 これらのデフォルトラベルを使用して、リポジトリに標準のワークフローを作成しやすくすることができます。
| ラベル | 説明 |
|---|---|
bug | 予期しない問題または意図しない動作を示します |
documentation | ドキュメンテーションに改善や追加が必要であることを示します |
duplicate | 同様の Issue あるいはプルリクエストを示します |
enhancement | 新しい機能のリクエストを示します |
good first issue | 初回のコントリビューターに適した Issue を示します |
help wanted | メンテナーが Issue もしくはプルリクエストに助けを求めていることを示します |
invalid | Issue あるいはプルリクエストに関連性がなくなったことを示します |
question | Issue あるいはプルリクエストにさらなる情報が必要なことを示します |
wontfix | Issue あるいはプルリクエストの作業が継続されないことを示します |
リポジトリの作成時に、すべての新しいリポジトリにデフォルトのラベルが含められますが、後でそのラベルを編集または削除できます。
Organization のオーナーは、Organization 内のリポジトリのためのデフォルトラベルをカスタマイズできます。 詳しい情報については、「Organization 内のリポジトリのためのデフォルトラベルを管理する」を参照してください。
ラベルの作成
- GitHubで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
- 検索フィールドの右にある、[New label] をクリックします。
- "Label name（ラベル名）"の下で、ラベルの名前を入力してください。
- "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- 新しいラベルを保存するには、[Create label] をクリックします。
Issue およびプルリクエストへのラベルの適用
- GitHubで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
- ラベルを適用したいアイテムの隣のチェックボックスを選択してください。
- 右上で [Label] をクリックし、続けて既存のラベル名を入力してください。 ラベルの名前をクリックして、選択されたアイテムに関連付けてください。
ラベルの編集
- GitHubで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
- ラベルのリストで、編集したいラベルの右のEdit（編集）をクリックしてください。
- "Label name（ラベル名）"の下で、ラベルの名前を入力してください。
- "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- [Save changes] をクリックします。
ラベルの削除
ラベルを削除すると、Issue とプルリクエストからラベルが削除されます。
- GitHubで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
- ラベルのリストで、削除したいラベルの右のDelete（削除）をクリックしてください。