プルリクエストについて
プルリクエストは、他者に対してあなたがGitHub Enterprise上のリポジトリ内のブランチにプッシュした変更について知らせます。 プルリクエストがオープンされると、変更がベースブランチにマージされる前に、可能性のある変更についてコラボレーターと議論し、レビューでき、フォローアップのコメントを追加できます。
メモ: プルリクエストを使う際には以下のことを念頭に置いてください:
- 共有リポジトリモデルで作業をしている場合、プルリクエストにはトピックブランチを使うことをおすすめします。 ブランチあるいはコミットからプルリクエストを送ることもできますが、トピックブランチを使えば提案した変更を更新する必要がある場合、フォローアップのコミットをプッシュできます。
- プルリクエストにコミットをプッシュする場合、フォースプッシュはしないでください。 フォースプッシュをすると、プルリクエストが壊れることがあります。
プルリクエストを初期化すると、あなたのブランチ(比較ブランチ)とリポジトリのベースブランチとの差異の高レベルの概要を示すレビューページが表示されます。 提案した変更の概要を追加したり、コミットによる変更をレビューしたり、ラベルやマイルストーン、アサインされた人を追加したり、個人のコントリビューターやTeamに@メンションできます。 詳しい情報についてはプルリクエストの作成を参照してください。
プルリクエストを作成したら、トピックブランチからコミットをプッシュして、それらを既存のプルリクエストに追加できます。 それらのコミットは、プルリクエスト内で時系列順に表示され、変更は"Files changed(変更されたファイル)"タブで見ることができます。
他のコントリビューターは、あなたが提案した変更をレビューしたり、レビューコメントを追加したり、プルリクエストのディスカッションにコントリビュートしたり、さらにはプルリクエストにコメントを追加したりできます。
提案された変更に満足したなら、プルリクエストをマージできます。 共有リポジトリモデルで作業しているなら、提案された変更はヘッドブランチからプルリクエストで指定されたベースブランチにマージされます。 詳しい情報についてはプルリクエストのマージを参照してください。
リポジトリでステータスチェックが要求されているなら、必須のステータスチェックをパスしてからでないと保護されたブランチにあなたのブランチはマージできません。 詳しい情報については必須のステータスチェックについてを参照してください。
プルリクエストあるいはコミットメッセージ中のキーワードを使って、対応するIssueをクローズできます。 詳細は「キーワードを使って Issue をクローズする」を参照してください。
参考:
- 期限切れのレビューコメントをすべて折りたたむか展開するかを切り替えるには、
alt
を押しながら、[Show outdated] または [Hide outdated] をクリックしてください。 その他のショートカットについては「キーボードのショートカット」を参照してください。 - プルリクエストをマージする際には、変更を効率的に見ることができるようにするためにコミットを squash できます。 詳しい情報についてはプルリクエストのマージについてを参照してください。
ダッシュボードにアクセスすれば、作業しているかサブスクライブしている最近更新されたプルリクエストへのリンクを素早く見つけることができます。 詳しい情報についてはパーソナルダッシュボードについてを参照してください。