GitHub Issueのクイックスタート

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

この記事の内容

はじめに

このガイドは、GitHub Issuesを使って作業の断片を計画及び追跡する方法を示します。 このガイドでは、新しい issue を作成します。 また、ラベル、マイルストーン、担当者、プロジェクトを追加して、issue に関するメタデータを伝える方法についても説明します。

前提条件

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

空のIssueのオープン

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

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

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

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

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

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

情報の記入

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

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

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

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

Issue の依存関係の追加

Issue の依存関係を使って、issue 間のブロック リレーションシップを定義できます。 Issue の依存関係により、他の作業にブロックされている、またはブロックしている issue を特定できます。 「Issue の依存関係の作成」を参照してください。

コミュニケーション

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

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

次の手順

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

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

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