ラベルを管理する

ラベルについて

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

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

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

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.com で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

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

   

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

3. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。 1. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。 1. 必要に応じて、ラベルの色をカスタマイズするには、16 進数を編集するか、 をクリックしてランダムに他の色を選びます。 1. 新しいラベルを保存するには、 [Create label](ラベルの作成) をクリックします。

ラベルの適用

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

1. issue、 pull request、またはディスカッションに移動します。
2. 右のサイドバーで、"Labels（ラベル）"の右のをクリックし、続いてラベルをクリックしてください

ラベルの編集

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

1. GitHub.com で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

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

   1. ラベルの一覧で、編集しようとするラベルの右側にある [編集] をクリックします。 1. "Label name（ラベル名）"の下で、ラベルの名前を入力してください。 1. "Description（説明）"の下で、他者があなたのラベルを理解して使いやすくするための説明を入力してください。 1. 必要に応じて、ラベルの色をカスタマイズするには、16 進数を編集するか、 をクリックしてランダムに他の色を選びます。 1. [変更を保存] をクリックします。

ラベルの削除

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

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

1. GitHub.com で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

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

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

参考資料

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