{"meta":{"title":"GitHubイシューのクイックスタート入門ガイド","intro":"この簡単な対話型ガイドに従って、 GitHub Issuesについて学習します。","product":"GitHub Issues","breadcrumbs":[{"href":"/ja/issues","title":"GitHub Issues"},{"href":"/ja/issues/tracking-your-work-with-issues","title":"問題"},{"href":"/ja/issues/tracking-your-work-with-issues/learning-about-issues","title":"問題について学ぶ"},{"href":"/ja/issues/tracking-your-work-with-issues/learning-about-issues/quickstart","title":"GitHubイシューのクイックスタート入門ガイド"}],"documentType":"article"},"body":"# GitHubイシューのクイックスタート入門ガイド\n\nこの簡単な対話型ガイドに従って、 GitHub Issuesについて学習します。\n\n## はじめに\n\nこのガイドでは、 GitHub Issues を使用して作業の計画と追跡を行う方法について説明します。 このガイドでは、新しい問題を作成し サブ問題に分類します。 また、ラベル、問題の種類、マイルストーン、担当者、プロジェクトを追加して、問題に関するメタデータを伝える方法についても説明します。\n\n## 前提条件\n\nIssueを作成するにはリポジトリが必要です。 書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。\nリポジトリで Issue を有効にしておく必要があります。 リポジトリの作成について詳しくは、「[新しいリポジトリの作成](/ja/repositories/creating-and-managing-repositories/creating-a-new-repository)」をご覧ください。 リポジトリで無効になっている issue の有効化の詳細については、「[問題を無効化する](/ja/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues)」を参照してください。\n\n## 空のIssueを開く\n\nまず、イシューを作成してください。 Issueの作成方法は複数あります。自分のワークフローで最も便利な方法を選択できます。 この例では、 GitHub UI を使用します。 Issue を作成するその他の方法の詳細については、「[課題の作成](/ja/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)」を参照してください。\n\n1. GitHub で、リポジトリのメイン ページに移動します。\n2. リポジトリ名の下にある **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-issue-opened\" aria-label=\"issue-opened\" role=\"img\"><path d=\"M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z\"></path></svg> \\[Issues]** をクリックします。\n\n   ![リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、\\[イシュー\\] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)\n3. **\\[New issue]\\(新しい Issue)** をクリックします。\n4. この例では、空の課題から始めます。 リポジトリでは、問題テンプレート 発行フォームを使用して 共同作成者に特定の情報を提供するよう促す場合があります。 リポジトリで Issue テンプレートを使っている場合、 **\\[空の Issue を開く]** をクリックします。\n\n## 情報の記入\n\nIssueに分かりやすいタイトルを付けてください。 このタイトルは、Issueが何に関するものなのかが一目でわかるものにすべきです。\n\nIssueを解決するのに役立つかもしれない詳細情報も含めて、Issueの目的を記述する説明を追加してください。 たとえば、もしそれがバグレポートなら、バグを再現するステップ、期待される結果、実際の結果を記述してください。\n\nフォーマット、リンク、絵文字などを追加するためにMarkdownを使うことができます。 詳しくは、「[GitHub での執筆](/ja/get-started/writing-on-github)」をご覧ください。\n\n![タイトルと本文が入力された新しい Issue フォームのスクリーンショット。](/assets/images/help/issues/issue-title-body.png)\n\n## タスクリストの追加\n\nプレーンテキストを使って、対応する issue がないタスクを追跡し、後で issue に変換することもできます。 詳しくは、「[タスクリストについて](/ja/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists)」をご覧ください。\n\n![タイトルと本文が入力された新しい Issue フォームのスクリーンショット。 本文には、タスク一覧用のMarkdownが含まれています。](/assets/images/help/issues/issue-task-list-raw.png)\n\n## 問題の割り当て\n\n責任を伝達するために、課題を組織のメンバーに割り当てることができます。 「[他のGitHub ユーザーに問題とプル要求を割り当てる](/ja/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)」を参照してください。\n\n![新しい issue フォームのスクリーンショット。 右側のサイドバーで、\\[担当者\\] セクションが濃いオレンジの枠線で囲まれています。](/assets/images/help/issues/issue-assignees.png)\n\n## ラベルの追加\n\n問題を分類するためにラベルを追加する。 たとえば、`question` ラベルと `good first issue` ラベルを使って、その課題が初めての共同作成者でも取り組みやすい質問であることを示します。 ユーザは、ラベルを使ってIssueをフィルタリングし、特定のラベルを持つすべてのIssueを見つけることができます。\n\nデフォルトのラベルを使うことも、新しいラベルを作成することもできます。 詳しくは、「[ラベルを管理する](/ja/issues/using-labels-and-milestones-to-track-work/managing-labels)」をご覧ください。\n\n![新しい issue フォームのスクリーンショット。 右側のサイドバーで、\\[ラベル\\] セクションが濃いオレンジの枠線で囲まれています。](/assets/images/help/issues/issue-with-label.png)\n\n## 課題種類の追加\n\nIssue の種類を追加して、organization 全体で作業を分類できます。 「[組織での課題の種類の管理](/ja/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization)」を参照してください。\n\n![新しい issue フォームのスクリーンショット。 右側のサイドバーでは、\\[Type\\] セクションが濃いオレンジ色で囲まれています。](/assets/images/help/issues/issue-type.png)\n\n## プロジェクトへの課題の追加\n\nIssue を既存のプロジェクトに追加して、そのプロジェクトのメタデータを設定できます。 プロジェクトの詳細については、「[Projects の概要](/ja/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)」を参照してください。\n\n![新しい issue フォームのスクリーンショット。 右側のサイドバーで、\\[プロジェクト\\] セクションが濃いオレンジの枠線で囲まれています。](/assets/images/help/issues/issue-project.png)\n\n## マイルストーンの追加\n\n日付ベースのターゲットの一部として課題を追跡するために、マイルストーンを追加できます。 マイルストーンは、目標日が近づくにつれて issue の進行状況を示します。 「[マイルストーンについて](/ja/issues/using-labels-and-milestones-to-track-work/about-milestones)」を参照してください。\n\n![新しい issue フォームのスクリーンショット。 右側のサイドバーで、\\[マイルストーン\\] セクションが濃いオレンジの枠線で囲まれています。](/assets/images/help/issues/issue-milestone.png)\n\n## 問題を提出する\n\n**\\[新しい Issue をサブミット]** をクリックして、Issue を作成します。 上記のフィールドは、いずれもIssueを作成した後に編集できます。 Issueは一意のURLを持ち、それをTeamのメンバーと共有したり、あるいは他のIssueやPull Request内で参照したりできます。\n\n## サブイシューの追加\n\nIssue に sub-issue を追加することで、大きな作業を小さな issue にすばやく分割することができます。 sub-issue により、issue 間の関係が作成されて、GitHub での issue の階層のサポートが追加されます。 ユーザーやチームが必要とする詳細さにタスクを分割することでプロジェクトを正確に表す sub-issue の複数のレベルを作成することができます。\n[「AUTOTITLE](/ja/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)」と[「AUTOTITLE」を](/ja/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues)参照してください。\n\n![問題の説明の下にあるサブ問題セクションのスクリーンショット。 追加のサブ問題を表示するオプションのボタンがオレンジ色の四角形で強調されています。](/assets/images/help/issues/sub-issue-drop-down.png)\n\n## 課題の依存関係の追加\n\n課題の依存関係を使って、課題間のブロックする関係を定義できます。 Issue の依存関係を利用して、他の作業によってブロックされている Issue または他の作業をブロックしている Issue を特定できます。 「[課題の依存関係の作成](/ja/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies)」を参照してください。\n\n## コミュニケーション\n\nIssueを作成した後は、そのIssueにコメントを追加して会話を続けてください。 コラボレーターやチームを@mentionして、コメントに注目してもらうことができます。 関連する課題を同じリポジトリ内でリンクするためには、`#` を入力した後、課題タイトルの一部を続けて入力し、リンクしたい課題をクリックします。 詳しくは、「[GitHub での執筆](/ja/get-started/writing-on-github)」をご覧ください。\n\n![問題コメントのスクリーンショット。 ヘッダーには \"octocat が今コメントしました\" と表示され、本文には \"@hubot ロケット ロジックも更新する必要がありますか?\" と表示されています。](/assets/images/help/issues/issue-comment.png)\n\n## 次の手順\n\nIssueは、幅広い目的で使用できます。 たとえば次のような点です。\n\n* アイデアの追跡\n* フィードバックの収集\n* タスクの計画\n* バグの報告\n\nissue をより管理しやすいタスクに分割するには、複数のレベルの sub-issue を追加できます。 「[サブイシューの追加](/ja/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)」を参照してください。\n\nGitHub Issuesで次の手順を実行するために役立つリソースを次に示します。\n\n* 課題の詳細を知るには、「[問題について](/ja/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)」を参照してください。\n* GitHubの計画および追跡ツールを使用するための基本事項については、[チームまたはプロジェクトの作業の計画と管理](/ja/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project) を参照してください。\n* プロジェクトが計画と追跡にどのように役立つかの詳細については、「[Projects について学習する](/ja/issues/planning-and-tracking-with-projects/learning-about-projects)」を参照してください。\n* 問題テンプレート および問題フォームの使用の詳細については 共同作成者に特定の情報の提供を促す方法については、 [テンプレートを使用して便利な Issue やプルリクエストを促進する](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests) を参照してください。"}