注釈: Pull Requestにおける特別なキーワードは、Pull Requestがリポジトリのデフォルト ブランチをターゲットするときに解釈されます。 た� し、PRのベースがそれ以外のブランチである� �合、それらのキーワードは無視され、リンクは作成されません。PRのマージはこのIssueに対して何の効果も持ちません。 キーワードの1つを使用してPull RequestをIssueにリンクしたい� �合は、PRがデフォルトブランチ上になければなりません。
リンクされたIssueとPull Requestについて
手動で、またはPull Requestの説明でサポートされているキーワードを使用して、IssueをPull Requestにリンクすることができます。
Pull Requestが対処するIssueにそのPull Requestをリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。
リンクされたPull Requestをリポジトリのデフォルトブランチにマージすると、それにリンクされているIssueは自動的にクローズされます。 デフォルトブランチの詳細については、「デフォルトブランチを変更する」を参照してく� さい。
キーワードを使用してPull RequestをIssueにリンクする
Pull Requestの説明またはコミットメッセージで、サポートされているキーワードを使用すれば、Pull RequestをIssueにリンクできます (Pull Requestはデフォルトブランチになければなりません)。
- close
- closes
- closed
- fix
- fixes
- fixed
- 解決
- resolves
- resolved
他のPull RequestでPull Requestのコメントを参照するためにキーワードを使用すると、Pull Requestはリンクされます。 参照元のPull Requestをマージすると、参照先のPull Requestもクローズされます。
クローズするキーワードの構文は、IssueがPull Requestと同じリポジトリにあるかどうかによって異なります。
リンクするIssue | 構文 | サンプル |
---|---|---|
Issueが同じリポジトリにある | KEYWORD #ISSUE-NUMBER | Closes #10 |
Issueが別のリポジトリにある | KEYWORD OWNER/REPOSITORY#ISSUE-NUMBER | Fixes octo-org/octo-repo#100 |
複数の Issue | Issueごとに完全な構文を使用 | Resolves #10, resolves #123, resolves octo-org/octo-repo#100 |
手動でリンクを解除できるのは、手動でリンクされたPull Request� けです。 キーワードを使用してリンクしたIssueのリンクを解除するには、Pull Requestの説明を編集してそのキーワードを削除する必要があります。
クローズするキーワードは、コミットメッセージでも使用できます。 デフォルトブランチにコミットをマージするとIssueはクローズされますが、そのコミットを含むPull Requestは、リンクされたPull Requestとしてリストされません。
手動でPull RequestをIssueにリンクする
リポジトリへの書き込み権限があるユーザなら誰でも、手動でPull RequestをIssueにリンクできます。
手動で1つのPull Requestごとに最大10個のIssueをリンクできます。 IssueとPull Requestは同じリポジトリになければなりません。
- your GitHub Enterprise Server instanceで、リポジトリのメインページにアクセスしてく� さい。
- リポジトリ名の下で、クリックします Pull requests
- Pull Requestのリストで、IssueにリンクしたいPull Requestをクリックします。
- 右のサイドバーで、[Linked issues] をクリックします。
- Pull RequestにリンクするIssueをクリックします。