Reviewing a PR

• 2 minutes to read
 • 2 minutes to read

Anyone with access can comment on a PR. The ability to request changes or submit reviews that approve a PR is limited to admins.

Open the PR for viewing

  1. Go to the repository and click Pull requests.
  2. Select a PR from the list.

Leave a general comment

  1. Select the Conversations tab.

  2. Scroll to the bottom of the page, write your feedback, and click Comment.

    GitHub PR comment field -screenshot

Comment on a specific line

  1. Select the Files changed tab.

  2. Locate the file and specific line you want to comment on.

  3. Put you mouse on the line and click the blue plus icon.

    GitHub PR line comment -screenshot

  4. Type your comment.

  5. Click Add single comment.

Start and submit review

  1. Add one or more line comments as described above.

  2. Optionally, suggest a specific change that the author can accept and commit directly.

    Click icon and edit the text between the ```.

    GitHub PR suggest change write -screenshot

    GitHub PR suggest change preview -screenshot

  3. When you're done, click Start a review. Alternatively, click Add review comment if you already started the review.

  4. Finished reviewing all the files.

  5. Click Review changes above the changes.

    GitHub PR Review changes button -screenshot

  6. Enter a description of your feedback and select the type.

    GitHub PR Submit review -screenshot

  7. Click Submit review.

What happens now?

  • Follow the discussion in the Conversation tab.
  • If you requested changes, follow up on those.
  • If you approved and all checks are green, you can merge the PR and delete the branch.