ラベルを管理する

ラベルについて

ラベルを作成して issue と pull request を分類することで、GitHub Enterprise Server での作業を管理できます。 ラベルが作成されたリポジトリ内にラベルを適用できます。 ラベルがあれば、そのリポジトリ内の任意の issue または pull request にラベルを使用できます。

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

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

Label	説明
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 Enterprise Server インスタンス で、リポジトリのメイン ページへ移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. issue または pull request の一覧の上にある Labels をクリックします。

   

4. 検索フィールドの右側にある [新しいラベル] をクリックします。

5. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。

6. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。

7. 必要に応じて、ラベルの色をカスタマイズするには、16 進数を編集するか、 をクリックしてランダムに他の色を選びます。

8. 新しいラベルを保存するには、 [Create label](ラベルの作成) をクリックします。

ラベルの適用

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

1. issue または pull request に移動します。
2. 右側のサイドバーで、 [ラベル] をクリックして、ラベルをクリックします。

ラベルの編集

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

1. お使いの GitHub Enterprise Server インスタンス で、リポジトリのメイン ページへ移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. issue または pull request の一覧の上にある Labels をクリックします。

   

4. ラベルの一覧で、編集しようとするラベルの右側にある [編集] をクリックします。

5. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。

6. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。

7. 必要に応じて、ラベルの色をカスタマイズするには、16 進数を編集するか、 をクリックしてランダムに他の色を選びます。

8. [変更を保存] をクリックします。

ラベルの削除

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

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

1. お使いの GitHub Enterprise Server インスタンス で、リポジトリのメイン ページへ移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. issue または pull request の一覧の上にある Labels をクリックします。

   

4. ラベルの一覧で、削除しようとするラベルの右側にある [削除] をクリックします。

参考資料

• 「Issue及びPull Requestのフィルタリングと検索」
• Organization 内のリポジトリのためのデフォルトラベルを管理する
• 基本的な書き方とフォーマットの構文