GitHub Issueのクイックスタート

この簡単なインタラクティブガイドに従って、GitHub Issuesについて学んでください。

この記事の内容

はじめに

このガイドは、GitHub Issuesを使って作業の断片を計画及び追跡する方法を示します。 このガイドでは、新しいIssueを作成し、タスクリストを追加してサブタスクを追跡します。 ラベル、マイルストーン、アサインされた人、プロジェクトを追加して、Issueに関するメタデータをやりとりする方法についても学びます。

前提条件

Issueを作成するにはリポジトリが必要です。 書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。 リポジトリはIssueを有効化していなければなりません。 リポジトリの作成について詳しくは、「新しいリポジトリの作成」をご覧ください。 リポジトリで無効になっている Issue の有効化について詳しくは、「Issues を無効化する」をご覧ください。

空のIssueのオープン

まず、Issueを作成してください。 Issueの作成方法は複数あります。自分のワークフローで最も便利な方法を選択できます。 この例では、GitHub UIを使用します。 Issue を作成するその他の方法について詳しくは、「Issue の作成」をご覧ください。

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

  2. リポジトリ名の下にある [イシュー] をクリックします。

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

  3. [New issue](新しい Issue) をクリックします。

  4. この例では、空のIssueから始めます。 リポジトリでは、コントリビューターが特定の情報を提供することを促進するために Issue テンプレートおよび Issue フォームが使用される場合があります。 リポジトリで Issue テンプレートを使っている場合、 [空の Issue を開く] をクリックします。

情報の記入

Issueに分かりやすいタイトルを付けてください。 このタイトルは、Issueが何に関するものなのかが一目でわかるものにすべきです。

Issueを解決するのに役立つかもしれない詳細情報も含めて、Issueの目的を記述する説明を追加してください。 たとえば、もしそれがバグレポートなら、バグを再現するステップ、期待される結果、実際の結果を記述してください。

フォーマット、リンク、絵文字などを追加するためにMarkdownを使うことができます。 詳しくは、「GitHub での執筆」を参照してください。

タイトルと本文が入力された新しい Issue フォームのスクリーンショット。

タスクリストの追加

大きなIssueを小さなタスクに分割したり、複数の関連するIssueを1つの大きなIssueで追跡すると役立つことがあります。 リスト項目の前に [ ] を置いて、Issue にタスク リストを追加します。 既存のIssueは、Issue番号あるいはURLで参照してください。 対応するIssueを持たないタスクを追跡するのにプレーンテキストを使い、それらを後でIssueに変換することができます。 詳しくは、「タスクリストについて」を参照してください。

タイトルと本文が入力された新しい Issue フォームのスクリーンショット。 本文のタスク リスト用に Markdown が含まれています。

ラベルの追加

Issueを分類するために、ラベルを追加してください。 たとえば、bug ラベルと good first issue ラベルを使って、Issue が初めてのコントリビューターが取り上げることができるバグであることを示す場合があります。 ユーザは、ラベルを使ってIssueをフィルタリングし、特定のラベルを持つすべてのIssueを見つけることができます。

デフォルトのラベルを使うことも、新しいラベルを作成することもできます。 詳しくは、「ラベルを管理する」を参照してください。

新しい issue フォームのスクリーンショット。 右側のサイドバーで、[ラベル] セクションが濃いオレンジの枠線で囲まれています。

マイルストーンの追加

マイルストーンを追加して、Issueを日付ベースのターゲットの一部として追跡できます。 マイルストーンは、ターゲットの日に近づくにつれて、Issueの進捗を示します。 詳しくは、「マイルストーンについて」を参照してください。

新しい issue フォームのスクリーンショット。 右側のサイドバーで、[マイルストーン] セクションが濃いオレンジの枠線で囲まれています。

Issueのアサイン

責任をやりとりするために、IssueをOrganizatoinのメンバーにアサインできます。 詳しくは、「GitHub の他のユーザに Issue およびプルリクエストをアサインする」を参照してください。

新しい issue フォームのスクリーンショット。 右側のサイドバーで、[担当者] セクションが濃いオレンジの枠線で囲まれています。

プロジェクトへのIssueの追加

issue を既存のプロジェクトに追加して、そのプロジェクトのメタデータを設定できます。 プロジェクトについて詳しくは、「Projects について」をご覧ください。

新しい issue フォームのスクリーンショット。 右側のサイドバーで、[プロジェクト] セクションが濃いオレンジの枠線で囲まれています。

Issueのサブミット

[新しい Issue をサブミット] をクリックして、Issue を作成します。 上記のフィールドは、いずれもIssueを作成した後に編集できます。 Issueは一意のURLを持ち、それをTeamのメンバーと共有したり、あるいは他のIssueやPull Request内で参照したりできます。

コミュニケーション

Issueを作成した後は、そのIssueにコメントを追加して会話を続けてください。 コラボレーターまたはチームを @mention して、コメントに注意を惹きつけることができます。 同じリポジトリ内の関連する Issue をリンクするために、# の後に Issue のタイトルの一部を続け、リンクする Issue をクリックできます。 詳しくは、「GitHub での執筆」を参照してください。

issue コメントのスクリーンショット。 ヘッダーには "octocat が今コメントしました" と表示され、本文には "@hubot ロケット ロジックも更新する必要がありますか?" と表示されています。

次の手順

Issueは、幅広い目的で使用できます。 たとえば次のような点です。

  • アイデアの追跡
  • フィードバックの収集
  • タスクの計画
  • バグの報告

issue をより管理しやすいタスクに分割するには、複数のレベルの sub-issue を追加できます。 「sub-issue の追加」を参照してください。

GitHub Issues で次のステップを実行するための役立つリソースを、いくつか次に示します。