記事のバージョン: Enterprise Server 2.17
プルリクエストについて
プルリクエストは、他者に対してあなたがGitHub Enterprise上のリポジトリ内のブランチにプッシュした変更について知らせます。 プルリクエストがオープンされると、変更がベースブランチにマージされる前に、可能性のある変更についてコラボレーターと議論し、レビューでき、フォローアップのコメントを追加できます。
プルリクエストについて
メモ: プルリクエストを使う際には以下のことを念頭に置いてください:
- 共有リポジトリモデルで作業をしている場合、プルリクエストにはトピックブランチを使うことをおすすめします。 ブランチあるいはコミットからプルリクエストを送ることもできますが、トピックブランチを使えば提案した変更を更新する必要がある場合、フォローアップのコミットをプッシュできます。
- プルリクエストにコミットをプッシュする場合、フォースプッシュはしないでください。 フォースプッシュをすると、プルリクエストが壊れることがあります。
プルリクエストを初期化すると、あなたのブランチ(比較ブランチ)とリポジトリのベースブランチとの差異の高レベルの概要を示すレビューページが表示されます。 提案した変更の概要を追加したり、コミットによる変更をレビューしたり、ラベルやマイルストーン、アサインされた人を追加したり、個人のコントリビューターやTeamに@メンションできます。 詳しい情報についてはプルリクエストの作成を参照してください。
プルリクエストを作成したら、トピックブランチからコミットをプッシュして、それらを既存のプルリクエストに追加できます。 それらのコミットは、プルリクエスト内で時系列順に表示され、変更は"Files changed(変更されたファイル)"タブで見ることができます。
他のコントリビューターは、あなたが提案した変更をレビューしたり、レビューコメントを追加したり、プルリクエストのディスカッションにコントリビュートしたり、さらにはプルリクエストにコメントを追加したりできます。
提案された変更に満足したなら、プルリクエストをマージできます。 共有リポジトリモデルで作業しているなら、提案された変更はヘッドブランチからプルリクエストで指定されたベースブランチにマージされます。 詳しい情報についてはプルリクエストのマージを参照してください。
リポジトリでステータスチェックが要求されているなら、必須のステータスチェックをパスしてからでないと保護されたブランチにあなたのブランチはマージできません。 詳しい情報については必須のステータスチェックについてを参照してください。
プルリクエストをIssueにリンクして、誰かがプルリクエストをマージしたときにIssueを自動的にクローズすることができます。 詳しい情報については「プルリクエストのIssueへのリンク」を参照してください。
参考:
- To toggle between collapsing and expanding all outdated review comments in a pull request, hold down optionAltAlt and click Show outdated or Hide outdated. その他のショートカットについては「キーボードのショートカット」を参照してください。
- プルリクエストをマージする際には、変更を効率的に見ることができるようにするためにコミットを squash できます。 詳しい情報についてはプルリクエストのマージについてを参照してください。
ダッシュボードにアクセスすれば、作業しているかサブスクライブしている最近更新されたプルリクエストへのリンクを素早く見つけることができます。 詳しい情報についてはパーソナルダッシュボードについてを参照してください。
ドラフトプルリクエスト
ドラフトのプルリクエストは、GitHub Free及びGitHub FreeのOrganizationのパブリックリポジトリ、GitHub Pro、レガシーのリポジトリごとの支払いプラン、GitHub Team のパブリックおよびプライベートリポジトリ、GitHub Enterprise Server2.17+、GitHub Enterprise Cloud で利用できます。
プルリクエストを作成する際には、レビュー可能なプルリクエストを作成するか、ドラフトのプルリクエストを作成するかを選択できます。 ドラフトのプルリクエストはマージできません。また、コードオーナーにはドラフトのプルリクエストのレビューは自動的にはリクエストされません。 ドラフトのプルリクエストの作成に関する詳しい情報については、「プルリクエストを作成する」および「フォークからプルリクエストを作成する」を参照してください。
プルリクエストに対するフィードバックをもらう準備ができているなら、ドラフトのプルリクエストにレビューの準備ができているとマークできます。 プルリクエストにレビューの準備ができているとマークすると、コードオーナーたちからのレビューをリクエストすることになります。 You can convert a pull request to a draft at any time. For more information, see "Changing the stage of a pull request."