Monitoring changes introduced by teammates
As a watcher you typically perform the following sequence of tasks:
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 shows the review timeline that lists all events and comments related to the review:
The files with changes are listed under the Overview tab. Click on the file name to display the inline diff:
From here you can go to a side-by-side diff or view the entire file by pushing the corresponding button.
To return to the timeline view, press Esc:
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.
To post a review comment
To post a line comment
To post a code selection comment:
Posted code selection comments and line comments are embedded in code and highlighted with yellow.
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 userpic and confirm the deletion: