Issue は、バグ、拡張、その他リクエストの追跡に使用できます。 詳細は「Issue について」を参照してく� さい。
リポジトリの管理者は、リポジトリのIssueを無効化できます。 詳細は「Issue を無効化する」を参照してく� さい。
リポジトリからのIssueの作成
- your GitHub Enterprise Server instanceで、リポジトリのメインページにアクセスしてく� さい。
- リポジトリ名の下で、クリックします Issues
- [New Issue] をクリックします。
- リポジトリでIssueテンプレートが使われているなら、オープンしたいIssueの種類の隣にあるGet started(始める)をクリックしてく� さい。 あるいは、利用できる選択肢にオープンしたいIssueの種類が含まれていない� �合は、Open a blank issue(空のIssueをオープン)をクリックしてく� さい。
- Issueのタイトルと説明を入力します。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追� したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しい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をオープンしたいコメントにアクセスしてく� さい。
- そのコメントで、 をクリックします。
- [Reference in new issue] をクリックします。
- [Repository] ドロップダウンメニューで、開こうとするIssueがあるリポジトリを選択します。
- Issueのわかりやすいタイトルと本文を入力します。
- [Create issue] をクリックします。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追� したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しいIssueをサブミット)をクリックしてく� さい。
コードからのIssueの作成
コードの特定の行または複数の行から、ファイルまたはプルリクエストで Issue を開くことができます。 コードから Issue を開くと、Issue には選択した行またはコードの範囲を示すスニペットが含まれています。 Issue を開くことができるのは、コードを保存したのと同じリポジトリで� けです。
- your GitHub Enterprise Server instanceで、リポジトリのメインページにアクセスしてく� さい。
- Issue で参照したいコードを探します。
- ファイルのコードに関する Issue を開くには、そのファイルに移動します。
- プルリクエストのコードに関する Issue を開くには、そのプルリクエストに移動し、[Files changed] をクリックします。 そして、コメントに含めたいコードを持つファイルを探し、 View(ビュー)をクリックしてく� さい。
- 1行を選択するか、範囲を選択するかを選んでく� さい。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてく� さい。
- コードの範囲を選択するには、その範囲の先� �行の番号をクリックしてコードのその行をハイライトしてく� さい。 そしてコードの範囲の最終行までポインタを移動させ、 Shiftを押し、行番号をクリックして範囲をハイライトしてく� さい。
- コードを1行選択するには、行番号をクリックしてその行をハイライトしてく� さい。
- コード範囲の左で、 をクリックします。 ドロップダウンメニューで、[Reference in new issue] をクリックします。
- Issueのタイトルと説明を入力します。
-
- プロジェクトのメンテナーは、Issueを誰かに割り当てたり、Issueをプロジェクトボードに追� したり、Issueをマイルストーンに関連づけたり、[ラベルを適用]](/articles/applying-labels-to-issues-and-pull-requests)したりできます。
- 完了したら、Submit new issue(新しい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
エラーページを返します。
クエリパラメータ | サンプル |
---|---|
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"というタイトルで、ボディに"Describe the problem"というコメントを持つIssueを作成します。 |
labels | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug は、"help wanted"及び"bug"というラベルを持つIssueを作成します。 |
マイルストーン | 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 を作成し、それを Organization のプロジェクトボード 1 に追� します。 |
template | https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md は、ボディにテンプレートを付けて Issue を作成します。 template クエリパラメータは、ルート内のISSUE_TEMPLATE サブディレクトリ、リポジトリ内のdocs/ あるいは.github/ ディレクトリに保存されたテンプレートで動作します。 詳しい情� �については「有益なIssueとPull Requestを促進するためのテンプレートの利用」を参照してく� さい。 |