プルリクエストで提案された変更をレビューする

プルリクエストのレビューについて

プルリクエストの変更は、1 ファイルごとにレビューできます。プルリクエストでファイルを確認しているときに、特定の変更について個別のコメントを残すことができます。各ファイルの確認が終了したら、ファイルを閲覧済みとしてマークできます。これによりファイルが折りたたまれるので、ま� レビューを必要とするファイルを特定するのに役立ちます。プルリクエストヘッダのプログレスバーには、閲覧したファイル数が表示されます。必要な数のファイルを確認した後、要約コメントを付けて確認を送信することにより、プルリクエストを承認するか、追� の変更をリクエストできます。

ヒント: 検索修飾子 review-requested:[USERNAME] または team-review-requested:[TEAMNAME] が使用された、自分または自分がメンバーであるチー� が確認を求められているプルリクエストを探すことができます。詳細については、「Searching issues and pull requests」 (問題とプルリクエストの検索) を参照してく� さい。

レビューを開始する

リポジトリ名の下にある [pull request] をクリックします。 1. プルリクエストのリストで、レビューしたいプルリクエストをクリックします。 1. pull request で、 [Files changed] (変更されたファイル) をクリックします。
必要に応じて、ファイルをフィルター処理して、レビューするファイルのみを表示します。詳しくは、「pull request 内のファイルをフィルタリングする」を参照してく� さい。
コメントを追� するコード行にカーソルを合わせ、青いコメントアイコンをクリックします。複数行にコメントを追� するには、クリックしてドラッグして行の範囲を選択し、青いコメントアイコンをクリックします。 1. コメントフィールドにコメントを入力してく� さい。 1. 必要に応じて、その行 (1 つまたは複数) に特定の変更を提案するには、をクリックした後、提案ブロック内のテキストを編集します。
終了したら [レビューの開始] をクリックします。レビューを既に開始していた� �合は、 [レビューコメントを追� ] をクリックします。

レビューを提出する前は、行のコメントは 保留中 であり、ご自分にしか見えません。レビューを提出する前ならばいつでも、保留中のコメントを編集できます。その保留中のコメントのすべてを含めて、保留中のレビューをキャンセルするには、[会話] タブでタイ� ラインの最後まで下にスクロールし、 [レビューをキャンセルする] をクリックします。

依存関係の変更をレビューする

プルリクエストに依存関係への変更が含まれている� �合は、マニフェストまたはロックファイルの依存関係のレビューを使用して、何が変更されたかを確認し、変更によるセキュリティの脆弱性の発生の有無を確認できます。詳細については、「プルリクエスト内の依存関係の変更をレビューする」を参照してく� さい。

pull request で、 [Files changed] (変更されたファイル) をクリックします。
マニフェストまたはロックファイルのヘッダーの右側で、 [] リッチ diff ボタンをクリックして、依存関係レビューを表示します。
依存関係を変化させないような変更がマニフェストあるいはロックファイルに行われているかもしれず、あるいはGitHubがパースできず、その結果として依存関係レビューに現れてこない依存関係があるかもしれないので、ソースdiffをレビューしたいこともあるでしょう。

ソース diff のビューに戻るには、ボタンをクリックしてく� さい。

ファイルをレビュー済みとしてマークする

ファイルのレビュー後は、そのファイルをレビュー済みとしてマークできます。マークしたファイルは折りたたまれます。ファイルを表示後に変更すると、レビュー済みマークが解除されます。

pull request で、 [Files changed] (変更されたファイル) をクリックします。
レビューを完了したファイルの、ヘッダーの右側にある [表示済み] を選びます。

レビューを提出する

プルリクエスト内でレビューしたいファイルをすべてレビューし終えたら、レビューをサブミットします。

pull request で、 [Files changed] (変更されたファイル) をクリックします。 1. 変更されたコードの上にある [変更の確認] をクリックします。 1. 提案された変更についてのフィードバックをまとめたコメントを入力してく� さい。
残しておくレビューの種類を選択します。
- 変更を明示的に承認したり、追� の変更を要求したりせずに、一般的なフィードバックを残すには、 [コメント] を選びます。
- フィードバックを提出して、pull request で提案された変更をマージすることを承認するには、 [承認] を選びます。
- pull request をマージする前に対処する必要があるフィードバックを送信するには、 [変更の要求] を選びます。
[レビューをサブミット] をクリックします。

ヒント:

必要なレビューが有効になっており、リポジトリへの 書き込み、 管理者、または 所有者 アクセス権を持つコラボレーターが変更を要求するレビューを送信した� �合、同じコラボレーターが pull request の変更を承認する別のレビューを送信するまで、pull request をマージすることはできません。
リポジトリのオーナーと管理者は、プルリクエストが承認レビューを受けていなかったり、あるいは変更をリクエストしたレビュー担当者がOrganizationを離れていたりアクセスできなくなっている� �合でも、プルリクエストをマージできます。
必� �レビューと古いレビューの棄却がどちらも有効化されており、承認済みのプルリクエストのブランチにコードを変更するコミットがプッシュされた� �合、その承認は却下されます。そのプルリクエストは、再度レビューされ承認されるまではマージできません。
同じコミットを指す複数のオープンされたプルリクエストがあり、それぞれがheadブランチを持つ� �合、いずれかがペンディングあるいは拒否されたレビューを持っているなら、それらはマージできません。
書き込みまたは管理者のアクセス許可を持つ個人からのレビューの承認を必� �としているリポジトリの� �合、これらのアクセス許可を持つ個人からの承認には緑色のチェックマークが表示され、これらのアクセス許可を持たない個人からの承認には灰色のチェックマークが表示されます。灰色のチェックマークが付いた承認は、pull request をマージできるかどうかに影響しません。
Pull Requestの作者は、自分自身のPull Requestを承認することはできません。

参考資料

「About protected branches」 (保護されたブランチについて)
"pull request をレビューステータスでフィルター処理する"