ラベルについて
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 内のリポジトリのためのデフォルトラベルを管理する」を参照してください。
ラベルの作成
リポジトリへの書き込みアクセス権を持つユーザは、ラベルを作成できます。
- GitHub.comで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- 検索フィールドの右にある、[New label] をクリックします。
- "Label name(ラベル名)"の下で、ラベルの名前を入力してください。
- "Description(説明)"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- 新しいラベルを保存するには、[Create label] をクリックします。
ラベルの適用
リポジトリへのtriageアクセス権を持つユーザは、ラベルを適用及び解除できます。
- Issue、Pull Request、ディスカッションにアクセスしてください。
- 右のサイドバーで、"Labels(ラベル)"の右のをクリックし、続いてラベルをクリックしてください
ラベルの編集
リポジトリへの書き込みアクセス権を持つユーザは、既存のラベルを編集できます。
- GitHub.comで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- ラベルのリストで、編集したいラベルの右のEdit(編集)をクリックしてください。
- "Label name(ラベル名)"の下で、ラベルの名前を入力してください。
- "Description(説明)"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- [Save changes] をクリックします。
ラベルの削除
リポジトリへの書き込みアクセス権を持つユーザは、既存のラベルを削除できます。
ラベルを削除すると、Issue とプルリクエストからラベルが削除されます。
- GitHub.comで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- ラベルのリストで、削除したいラベルの右のDelete(削除)をクリックしてください。