ラベルを管理する

この記事の内容

ラベルの作成、編集、適用、削除によって、issue、pull request、ディスカッションを分類できます。

ラベルについて

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

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

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

Label説明
bug予期しない問題または意図しない動作を示します
documentationドキュメンテーションに改善や追加が必要であることを示します
duplicate似た issue、pull request、ディスカッションを示します
enhancement新しい機能のリクエストを示します
good first issue初回のコントリビューターに適した Issue を示します
help wantedメンテナーが Issue もしくはプルリクエストに助けを求めていることを示します
invalidissue、pull request、ディスカッションが関係なくなっていることを示します
questionissue、pull request、ディスカッションにさらに情報が必要であることを示します
wontfixissue、pull request、ディスカッションに対する作業が続けられないことを示します

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

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

Organization の所有者は、自分の Organization 内のリポジトリ用の既定のラベルをカスタマイズできます。 詳しくは、「Organization 内のリポジトリのためのデフォルトラベルを管理する」を参照してください。

ラベルの作成

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

  1. GitHub.com で、リポジトリのメイン ページへ移動します。

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

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[イシュー] と [pull request] というラベルが付いた 2 つのタブが、それぞれ濃いオレンジ色の枠線で囲まれています。

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

    リポジトリの issue の一覧のスクリーンショット。 一覧の上には、ラベル アイコンと [ラベル] というラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

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

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

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

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

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

ラベルの適用

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

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

ラベルの編集

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

  1. GitHub.com で、リポジトリのメイン ページへ移動します。

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

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[イシュー] と [pull request] というラベルが付いた 2 つのタブが、それぞれ濃いオレンジ色の枠線で囲まれています。

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

    リポジトリの issue の一覧のスクリーンショット。 一覧の上には、ラベル アイコンと [ラベル] というラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

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

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

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

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

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

ラベルの削除

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

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

  1. GitHub.com で、リポジトリのメイン ページへ移動します。

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

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[イシュー] と [pull request] というラベルが付いた 2 つのタブが、それぞれ濃いオレンジ色の枠線で囲まれています。

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

    リポジトリの issue の一覧のスクリーンショット。 一覧の上には、ラベル アイコンと [ラベル] というラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

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

参考資料