Upsource Web Help

Monitoring changes introduced by teammates

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

  1. Go to the review and locate the changes.

  2. Read comments and optionally participate in discussion.

Locate changes

When someone invites you to take part in a review, you’ll receive a notice in your e-mail containing a direct link to that review. You’ll be also updated of any consequent changes within this review. Follow the link to proceed to the review page. Its main pane displays the changes that took place in each file included in the revision:

Review main view

You can go to a side-by-side diff view or study the whole file - just click the corresponding button.

Read and post comments

You can post comments, addressing them to the author and other participants, and reply to the comments left by others. There are three types of comments:

  • Review comment is not tied up to any particular file or part of code - its subject matter may be anything within the scope of the review.

  • Code selection comment is intended to pinpoint a particular code fragment in one of the files being reviewed.

  • Line comment is associated with a specific line of code. Posted code selection comments and line comments are embedded in code and highlighted with yellow.

To post a review comment, type your message in the text field at the bottom and click Add Comment:

To post a code selection comment:

  1. Open the file and go Side-by-side diff or View file.

  2. Select the lines you want to discuss and choose Comment on selection from the pop-up menu.

  3. Type in your message and click Add comment (or press Ctrl+Enter):

To post a line comment:

  1. In the review home view, expand the file and select the line you want to comment on by clicking the edit icon to the left:

    Add line comment

  2. Enter your message in the text box and click Add comment:

    Add line comment

When a discussion thread comes to a logical end, it can be marked as resolved.

Unsubscribe from e-mail updates

To discontinue monitoring a review and stop getting updates in your e-mail, navigate to the review main page and remove yourself from the watchers list - in the right pane, click on your user pic and confirm the deletion:

Remove watcher