Managing reviews
On this page:
You can view and manage reviews which are included in your project and associated with you as a participant or expected participant.
Displaying reviews
From the main menu, select Reviews icon on the bottom:
, or click the![ide_review_icon ide_review_icon](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_review_icon.png)
The Reviews tool window will open in a separate tab below the editor
You can search reviews or filter them out by selecting a corresponding option from the drop-down menu:
![ide_review_list_options ide_review_list_options](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_review_list_options.png)
Reviews that have been closed are greyed out.
Double-click a review to activate various options for it and display it in a separate tab:
The revisions included in the review will be listed. Using the toolbar at the top of the list, you can:
-
Display review comments (general comments that are not attached to a line or code selection).
-
Edit the review — you can add or remove participants.
-
Close or reopen the review if you are its author.
-
Accept or
raise concern about the changes if you are the reviewer and have completed your inspection.
-
Open the review in Upsource (in your browser).
You can also detach a specified revision from the review by right-clicking the revision and choosing the corresponding option:
![ide_detach_from_review ide_detach_from_review](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_detach_from_review.png)
Viewing and comparing revisions
Files that are part of the selected revision are listed in the right pane of the Reviews tool window:
![ide_file_list ide_file_list](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_file_list.png)
Using the checkboxes on the left you can choose for which revisions you want to see files and the diff:
![ide select revisions ide select revisions](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_select_revisions.png)
After selecting a file from the tree you can use the toolbar to:
-
Compare file versions in a side-by-side diff
-
Compare this file version with your local version in a side-by-side diff
-
See the most recent repository version in your editor
-
Open this version in Upsource (in your browser)
A side-by-side diff opens in a separate window:
![ide_diff.png ide_diff.png](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_diff.png)
Using the toolbar at the top of the displayed window, you can:
-
Jump to source — show your current local version of the file in the editor.
-
Compare versions of other files included in the revision.
-
Leave a review comment.
You can also comment on a code fragment. Select the fragment you want to discuss, choose Leave a comment, then type in your message and click OK:
![ide_selection_comment ide_selection_comment](https://resources.jetbrains.com/help/img/upsource/2017.3/ide_selection_comment.png)
If the file contains discussions, they are displayed to the right of the diff. Each discussion may contain one or more comments (replies).
Select a comment by clicking on it. Now you can:
-
Reply to the comment
-
Resolve the comment
If you're the author of the comment, you can also:
-
Edit the comment
-
Delete the comment