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

はじめに

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

前提条件

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

空のIssueを開く

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

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

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

   

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

4. この例では、空の課題から始めます。 リポジトリでは、問題テンプレート 共同作成者に特定の情報を提供するよう促す場合があります。 リポジトリで Issue テンプレートを使っている場合、 [空の Issue を開く] をクリックします。

情報の記入

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

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

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

課題の依存関係の追加

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

コミュニケーション

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

次の手順

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

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

GitHub Issuesで次の手順を実行するために役立つリソースを次に示します。

• 課題の詳細を知るには、「問題について」を参照してください。
• GitHubの計画および追跡ツールを使用するための基本事項については、チームまたはプロジェクトの作業の計画と管理 を参照してください。
• プロジェクトが計画と追跡にどのように役立つかの詳細については、「Projects について学習する」を参照してください。
• 問題テンプレート 共同作成者に特定の情報の提供を促す方法については、 テンプレートを使用して便利な Issue やプルリクエストを促進する を参照してください。