JetBrains Space Help

Review Changes Made by Others

As a reviewer you typically perform the following sequence of tasks:

  1. Go to the review and examine the changes.

  2. Leave your feedback and participate in discussion.

  3. Optionally invite other participants.

  4. Complete review by accepting the changes.

When someone invites you to review their changes, you'll receive a notification in Chats (under the Reviews tab) containing a direct link to the review. Follow the link to proceed to the review page.

On the review page, you'll notice a status indicator under your user icon:

reviewPageStatusReviewing.png

When its orange and says Reviewing the changes, it means that the author is waiting for your feedback or approval.

Examine changes

The Timeline tab lists all events and comments related to the review:

reviewTimeline.png

To see the commits, files, and changes associated with this review, go to the Changes tab:

reviewInlineDiff.png

Click on the file name to display its unified (inline) diff. From here you can switch to a split (side-by-side) diff view:

reviewSwitches.png

If the review contains multiple commits, click Changes from commits to show them all. You can select any one of them to see the files it affected and inspect changes:

revisionSelector.png

The codeowner-crown-blue.png crown icon indicates that you are the owner of some of the files in the change list:

codeReviewCrownAll.png

Click the crown to toggle your view: display either all changed files or only the ones you own:

codeReviewCrownOwned.png

Code ownership is based on the CODEOWNERS file which can be configured for your repository.

Finished reviewing?

  • If you have questions, concerns or suggestions, or some other reasons not to approve the changes, discuss them with the author. Leave your comments and let the author know that you're done and waiting for their response. Click Wait for updates or Submit drafts (if you have not already posted your comments):

    reviewerFinishWait.png
    reviewerSubmitDrafts.png

    The author will be notified, and your status will change to Waits for a response:

    reviewerWaiting.png

    When the author is done replying or revising their changes, your status will turn to Reviewing the changes once again, indicating that you may need to review an additional commit or just respond to the comments.

  • If everything is okay, and you are ready to approve the changes, click Accept changes:

    reviewerFinishAccept.png

    If you are sure that any additional changes that the author might commit will not require your further review, you can click Accept and finalize approval. In this case your approval will be final and your status won't be reset when new commits are introduced:

    reviewerAcceptFinalize.png

    Your status indicator will turn green, and no further action will be required:

    reviewerAccepted.png

Post comments

You can post comments, addressing them to other participants, and reply to the comments left by others. See Comments and Suggested Changes for details.

Assign other reviewers

You can invite other members to help you review the changes by assigning them to the review. Click Add reviewer and select one or more reviewers from the drop-down list:

reviewerAddOtherReviewers.png

The assigned reviewers will be notified and displayed on the review page.

Subscribe others as watchers

You can invite others to watch updates and discuss changes by subscribing them to the review. Just mention them in a comment: type @ and pick a person from the list.

Keep track of reviews

The Code Reviews page lets you keep track of the reviews you participate in or are expected to. Use filters to check which reviews need your attentions either as author or reviewer.

gotoReviewsPage.png

On this page, you can also see and search all reviews in the project.

Last modified: 24 May 2023