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