GitHubイシューのクイックスタート入門ガイド

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

この記事で

はじめに

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

前提条件

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

空のIssueを開く

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

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

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

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

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

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

情報の記入

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

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

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

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

課題の依存関係の追加

課題の依存関係を使って、課題間のブロックする関係を定義できます。 Issue の依存関係を利用して、他の作業によってブロックされている Issue または他の作業をブロックしている Issue を特定できます。 「課題の依存関係の作成」を参照してください。

コミュニケーション

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

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

次の手順

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

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

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