プルリクエスト(略して PR)は、あるブランチの変更を別のブランチに取り込む提案です。Git はコミットやブランチを管理します。ホスティングサービスでは、変更をレビューするページで内容を確認したり、意見を交わしたり、チェック結果を見たりできます。
Git · レッスン 7
プルリクエスト
プルリクエストの読み方と、レビューや自動チェックがどの変更を対象にしているかを確認する方法を学びます。
変更元と取り込み先を確認する
チームメイトがサイトに状態を知らせるページを追加することを提案しました。レビュー画面には health-page → main と表示されています。変更元のブランチは head とも呼ばれ、提案の変更を含んでいます。取り込み先のブランチは base とも呼ばれ、その変更を受け取る側です。
Source: health-page at 3ab4501
Target: main
Changed file: health.txt
この時点でレビュー画面に表示されているのは提案です。PR がマージされると、取り込み先のブランチに変更が反映されます。
この PR がマージされると、どのブランチに状態を知らせるページが追加されますか?
差分を読む
変更されたファイルの一覧を開き、PR の取り込み先を基準にした差分を読みます。health.txt への一行の追加なら、簡単な状態ページを作るという提案に合っています。index.html にも差分があれば、その変更も同じ提案に含めてよいかを考えます。PR に実際に表示されるファイルを確認してください。
「状態を知らせるページを追加」という PR が、トップページも変更しています。実際の変更内容はどこで確認できますか?
自動チェックの結果を読む
ホスティングサービスによっては、PR が更新されるとテストが実行されます。結果がどのコミットやリビジョンに対応しているかを確認します。テストが通った後で別のコミットがプッシュされた場合は、更新されたリビジョンにも必要なチェックが実行されたかを確認します。成功の表示が示すのは、実際に走ったチェックの結果です。
3ab4501 ではテストが通りました。今の PR は 78ac900 を指しています。結果を判断材料にする前に、何を確認しますか?
レッスン完了
プルリクエスト を完了しました
プルリクエストの提案内容を読み取り、マージの判断に使える情報を確認できるようになりました。
変更元と取り込み先のブランチを見つけます。
変更されたファイルの一覧で提案の内容を確かめます。
自動チェックがどのリビジョンを対象にしているかを確認します。