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

Pull Request では、コミット、変更されたファイル、ベースブランチと比較ブランチでのファイル間の違い (つまり "diff") をレビューしたり議論したりできます。

ここには以下の内容があります:

プルリクエストのレビューについて
レビューを開始する
ファイルをレビュー済みとしてマークする
レビューを提出する
参考リンク

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

プルリクエストの変更は、1 ファイルごとにレビューできます。 While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. これによりファイルが折りたたまれるので、まだレビューを必要とするファイルを特定するのに役立ちます。 A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment.

Tip: あなた、もしくはあなたがメンバーになっているTeamがレビューを求められているプルリクエストは、review-requested:[USERNAME]あるいはteam-review-requested:[TEAMNAME]という検索条件で検索できます。詳しい情報については「Issueやプルリクエストの検索」を参照してください。

レビューを開始する

リポジトリ名の下にある Pull requests（プルリクエスト）をクリックしてください。
プルリクエストのリストで、レビューしたいプルリクエストをクリックします。
プルリクエストで Files changed（変更されたファイル）をクリックしてください。
Hover over the line of code where you'd like to add a comment, and click the blue comment icon.
コメントフィールドにコメントを入力してください。
Optionally, to suggest a specific change to the line, click , then edit the text within the suggestion block.
完了したら、[Start a review] をクリックします。レビューがすでに開始していた場合は、[Add review comment] (レビューコメントを追加) をクリックします。

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

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

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

プルリクエストで Files changed（変更されたファイル）をクリックしてください。
レビューを完了したファイルの、ヘッダの右側にある [Viewed] を選択します。

レビューを提出する

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

プルリクエストで Files changed（変更されたファイル）をクリックしてください。
変更されたコードの上で、Review changes（変更をレビュー）をクリックしてください。
提案された変更についてのフィードバックをまとめたコメントを入力してください。
残しておくレビューの種類を選択します。
- 変更を明確には承認せず、さらなる変更をリクエストすることもなく、おおまかなフィードバックだけを残したい場合は、[Comment] を選択します。
- フィードバックを提出して、Pull Request で提案された変更をマージすることを承認するには、[Approve] を選択します。
- Pull Request をマージする前に対処すべき問題をフィードバックするには、[Request changes] を選択します。
Submit review（レビューをサブミット）をクリックしてください。

Tips:

必須レビューが有効化されており、リポジトリへの書き込み、管理、オーナーのいずれかの権限を持つコラボレータがレビューを要求する変更をサブミットすると、そのプルリクエストは同じコラボレータがプルリクエスト中の変更を承認する他のレビューをサブミットするまではマージできません。
リポジトリのオーナーと管理者は、プルリクエストが承認レビューを受けていなかったり、あるいは変更をリクエストしたレビュー担当者がOrganizationを離れていたりアクセスできなくなっている場合でも、プルリクエストをマージできます。
必須レビューと古いレビューの棄却がどちらも有効化されており、承認済みのプルリクエストのブランチにコードを変更するコミットがプッシュされた場合、その承認は却下されます。そのプルリクエストは、再度レビューされ承認されるまではマージできません。
同じコミットを指す複数のオープンされたプルリクエストがあり、それぞれがheadブランチを持つ場合、いずれかがペンディングあるいは拒否されたレビューを持っているなら、それらはマージできません。