ラベルについて
GitHub Enterprise Server上の作業を、IssueとPull Requestを分類するためのラベルを作成することによって管理できます。 ラベルが作成されたリポジトリ内にラベルを適用できます。 ラベルがあれば、そのリポジトリ内の任意のIssueやPull Requestにそのラベルを使用できます。
リポジトリへの読み取りアクセスを持つ人は、誰でもリポジトリのラベルを表示・検索できます。 リポジトリへのトリアージアクセスを持つすべてのユーザは、既存のラベルを適用/却下できます。 ラベルの作成、編集、適用、削除をするためには、リポジトリに書き込みアクセスができなければなりません。
デフォルトラベルについて
GitHub Enterprise Server は、すべての新しいリポジトリにデフォルトのラベルを提供します。 これらのデフォルトラベルを使用して、リポジトリに標準のワークフローを作成しやすくすることができます。
ラベル | 説明 |
---|---|
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 Enterprise Serverで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- 検索フィールドの右にある、[New label] をクリックします。
- "Label name(ラベル名)"の下で、ラベルの名前を入力してください。
- "Description(説明)"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- 新しいラベルを保存するには、[Create label] をクリックします。
ラベルの適用
- IssueあるいはPull Requestにアクセスしてください。
- 右のサイドバーで、"Labels(ラベル)"の右のをクリックし、続いてラベルをクリックしてください
ラベルの編集
- GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- ラベルのリストで、編集したいラベルの右のEdit(編集)をクリックしてください。
- "Label name(ラベル名)"の下で、ラベルの名前を入力してください。
- "Description(説明)"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。
- あるいは、ラベルの色をカスタマイズするには、16進数を編集するか、リフレッシュボタンをクリックしてランダムに他の色を選択してください。
- [Save changes] をクリックします。
ラベルの削除
ラベルを削除すると、Issue とプルリクエストからラベルが削除されます。
- GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で IssuesあるいはPull requests(プルリクエスト)をクリックしてください。
- Issueもしくはプルリクエストのリストの上部で、Labels(ラベル)をクリックしてください。
- ラベルのリストで、削除したいラベルの右のDelete(削除)をクリックしてください。