ラベルを管理する

ラベルについて

GitHub上の作業を、Issue、Pull Request、ディスカッションを分類するためのラベルを作成することによって管理できます。 ラベルが作成されたリポジトリ内にラベルを適用できます。 ラベルがあれば、そのリポジトリ内の任意のIssue、Pull Request、ディスカッションにそのラベルを使用できます。

デフォルトラベルについて

GitHub は、すべての新しいリポジトリにデフォルトのラベルを提供します。 これらのデフォルトラベルを使用して、リポジトリに標準のワークフローを作成しやすくすることができます。

ラベル	説明
bug	予想外の問題あるいは意図しない振る舞いを示します
documentation	ドキュメンテーションに改善や追加が必要であることを示します
duplicate	同様のIssue、Pull Request、ディスカッションを示します。
enhancement	新しい機能のリクエストを示します
good first issue	初回のコントリビューターに適した Issue を示します
help wanted	メンテナーが Issue もしくはプルリクエストに助けを求めていることを示します
invalid	Issue、Pull Request、ディスカッションが関係なくなっていることを示します。
question	Issue、Pull Request、ディスカッションにさらに情報が必要であることを示します。
wontfix	Issue、Pull Request、ディスカッションに対する作業が継続されないことを示します。

リポジトリの作成時に、すべての新しいリポジトリにデフォルトのラベルが含められますが、後でそのラベルを編集または削除できます。

good first issueラベル付きのIssueは、リポジトリのcontributeページを展開するために使われます。 contributeページの例についてはgithub/docs/contributeを参照してください。

Organization のオーナーは、Organization 内のリポジトリのためのデフォルトラベルをカスタマイズできます。 詳しい情報については、「Organization 内のリポジトリのためのデフォルトラベルを管理する」を参照してください。

ラベルの作成

リポジトリへの書き込みアクセス権を持つユーザは、ラベルを作成できます。

1. GitHub.comで、リポジトリのメインページにアクセスしてください。
2. リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
3. Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
4. 検索フィールドの右にある、[New label] をクリックします。
5. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。
6. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
7. あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
8. 新しいラベルを保存するには、[Create label] をクリックします。

ラベルの適用

リポジトリへのtriageアクセス権を持つユーザは、ラベルを適用及び解除できます。

1. Issue、Pull Request、ディスカッションにアクセスしてください。
2. 右のサイドバーで、"Labels（ラベル）"の右のをクリックし、続いてラベルをクリックしてください

ラベルの編集

リポジトリへの書き込みアクセス権を持つユーザは、既存のラベルを編集できます。

1. GitHub.comで、リポジトリのメインページにアクセスしてください。
2. リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
3. Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
4. ラベルのリストで、編集したいラベルの右のEdit（編集）をクリックしてください。
5. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。
6. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
7. あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
8. [Save changes] をクリックします。

ラベルの削除

リポジトリへの書き込みアクセス権を持つユーザは、既存のラベルを削除できます。

ラベルを削除すると、Issue とプルリクエストからラベルが削除されます。

1. GitHub.comで、リポジトリのメインページにアクセスしてください。
2. リポジトリ名の下で IssuesあるいはPull requests（プルリクエスト）をクリックしてください。
3. Issueもしくはプルリクエストのリストの上部で、Labels（ラベル）をクリックしてください。
4. ラベルのリストで、削除したいラベルの右のDelete（削除）をクリックしてください。

参考リンク

• 「IssueやPull Requestのフィルタリングと検索」
• 「Organization 内のリポジトリのためのデフォルトラベルを管理する」
• 「ラベルを使用してプロジェクトに役立つコントリビューションを促す」
• 基本的な書き方とフォーマットの構文