Issue は、バグ、拡張、その他リクエストの追跡に使用できます。 詳細については、「Issue について」を参照してく� さい。
リポジトリの管理者は、リポジトリのIssueを無効化できます。 詳細については、「Issues を無効化する」を参照してく� さい。
リポジトリからのIssueの作成
- で、リポジトリのメイン ページへ移動します。 2. リポジトリ名の下にある [issue] をクリックします。 1. [New issue](新しい Issue) をクリックします。
- リポジトリで issue テンプレートを使用している� �合は、開く issue の種類の横にある [作業の開始] をクリックします。 または、開きたい issue の種類が使用可能なオプションに含まれていない� �合は、 [空の issue を開く] をクリックします。 1. Issueのタイトルと説明を入力します。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクト ボードに追� したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい issue の送信] をクリックします。
GitHub CLIでのIssueの作成
GitHub CLI は、コンピューターのコマンド ラインから GitHub を使用するためのオープン ソース ツールです。 コマンドラインから作業しているときは、GitHub CLI を使用して時間を節約し、コンテキストの切り替えを回避できます。GitHub CLI の詳細については、「GitHub CLI について」を参照してく� さい。
issue を作成するには、gh issue create
サブコマンドを使用します。 対話型プロンプトをスキップするには、--body
フラグと --title
フラグを含めます。
gh issue create --title "My new issue" --body "Here are more details."
アサインされる人、ラベル、マイルストーン、プロジェクトを指定することもできます。
gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"
コメントからのIssueの作成
IssueもしくはPull Requestのコメントから、新しいIssueをオープンできます。 コメントから開いたIssueには、コメントの元の投稿� �所を示すスニペットが含まれています。
- Issueをオープンしたいコメントにアクセスしてく� さい。
- そのコメントで、 をクリックします。
- [新しい issue で参照] をクリックします。
- [Repository] ドロップダウンメニューで、開こうとするIssueがあるリポジトリを選択します。
- Issueのわかりやすいタイトルと本文を入力します。
- [issue の作成] をクリックします。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクト ボードに追� したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい issue の送信] をクリックします。
コードからのIssueの作成
コードの特定の行または複数の行から、ファイルまたはプルリクエストで Issue を開くことができます。 コードから Issue を開くと、Issue には選択した行またはコードの範囲を示すスニペットが含まれています。 Issue を開くことができるのは、コードを保存したのと同じリポジトリで� けです。
- で、リポジトリのメイン ページへ移動します。
- Issue で参照したいコードを探します。
- ファイルのコードに関する Issue を開くには、そのファイルに移動します。
- pull request でコードに関する issue を開くには、対象の pull request に移動して [変更されたファイル] をクリックします。 次に、コメントに取り込むコードが含まれているファイルを参照して、 [表示] をクリックします。
- 1行を選択するか、範囲を選択するかを選んでく� さい。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてく� さい。
- コードの範囲を選択するには、その範囲の先� �行の番号をクリックしてコードのその行をハイライトしてく� さい。 そしてコードの範囲の最終行までポインタを移動させ、Shift を押し、行番号をクリックして範囲をハイライトします。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてく� さい。
- コード範囲の左にある をクリックします。 ドロップダウン メニューで、 [新しい issue で参照] をクリックします。 1. Issueのタイトルと説明を入力します。 1. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクト ボードに追� したり、マイルストーンに関連付けたり、ラベルを適用したりできます。 1. 完了したら、 [新しい issue の送信] をクリックします。
プロジェクトボードのノートからのIssueの作成
プロジェクトボードを使用して作業の追跡や優先� �位付けをしている� �合、プロジェクトボードのノートを Issue に変換できます。 詳細については、「プロジェクト ボードについて」と「プロジェクト ボードへのノートの追� 」を参照してく� さい。
URLクエリからのIssueの作成
Issueをオープンするのにクエリパラメータを利用できます。 クエリパラメータはカスタマイズ可能なURLのオプション部分で、GitHub上の検索フィルタの結果やIssueテンプレートといった特定のWebページビューを共有できます。 独自のクエリパラメータを作成するには、キーと値のペアをマッチさせなければなりません。
ヒント: 既定のラベル、担当者、issue タイトルを使用して開く issue テンプレートを作成することもできます。 詳細については、「テンプレートを使用して便利な issue や pull request を促進する」を参照してく� さい。
クエリパラメータを使うには、同等のアクションを行うための適切な権限を持っていなければなりません。 たとえば、labels
クエリ パラメーターを使うには、issue にラベルを追� するアクセス許可を持っている必要があります。 詳細については、「Organization のリポジトリ ロール」を参照してく� さい。
クエリ パラメーターを使用して無効な URL を作成した� �合、または適切なアクセス許可を持っていない� �合は、URL から 404 Not Found
エラー ページが返されます。 サーバーの制限を超える URL を作成すると、URL から 414 URI Too Long
エラー ページが返されます。
Query parameter (クエリ パラメーター) | 例 |
---|---|
title | https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report では、ラベル "bug" とタイトル "New bug report" で issue が作成されます。 |
body | https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. では、タイトルが "New bug report" で、issue 本文に "Describe the problem" というコメントが含まれる、issue が作成されます。 |
labels | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug では、"help wanted" と "bug" というラベルを持つ issue が作成されます。 |
milestone | https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones では、"testing milestones" というマイルストーンで issue が作成されます。 |
assignees | https://github.com/octo-org/octo-repo/issues/new?assignees=octocat では、issue が作成されて、@octocat に割り当てられます。 |
projects | https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 では、"Bug fix" というタイトルの issue が作成されて、組織のプロジェクト ボード 1 に追� されます。 |
template | https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md では、issue 本文にテンプレートが含まれる issue が作成されます。 template クエリ パラメーターは、リポジトリのルート、docs/ 、または .github/ ディレクトリ内の ISSUE_TEMPLATE サブディレクトリに� �納されているテンプレートで動作します。 詳細については、「テンプレートを使用して便利な issue や pull request を促進する」を参照してく� さい。 |