Review code

1. In the View | Tool Windows | Git tool window, select the Log tab.

2. Right-click a commit and select Space | Create Code Review. To narrow down the list of commits, you can use the search field and filters.

3. In the Code Reviews tool window that opens, enter a meaningful title for your code review and assign reviewers.

4. Click Create Code Review.

   

tip

Alternatively, you can create a code review by clicking in the Create Code Review tool window. Here, you can also filter commits by author, branch, commit message, and commit hash.

1. From the main menu, select Tools | Space | Code Reviews.

2. In the Code Reviews tool window that opens, click and select Create Merge Request.

3. Select the source and target branches. By default, the currently checked out branch is selected as the source branch, and the configured main branch as the target.

4. Enter a meaningful title and assign reviewers.

5. Click Create Merge Request.

   

Find a code review

1. In the Code Reviews tool window, select a filter from the Quick filters list:

   • Open: all open reviews in your project.

   • Needs my review: open code reviews where you are a reviewer, and it's your turn.

   • Needs my attention: open code reviews where you are the author, and it's your turn.

   • Includes my changes: all open code reviews where you are the author.

   • Assigned to me: open and closed reviews in which you participate as a reviewer.

   • Closed: all closed reviews in your project.

2. Click a code review to open its details, view commits, and post comments.

Post a general comment

1. In the Code Reviews tool window, select a review.

2. In the Timeline pane that opens, enter your comment and press Enter.

3. If it's your turn in the review, you can also select how to post the comment:

   • Select Post now if you want to notify the review participants immediately.

   • Select Save as Draft if you do not want to post this comment right now. Draft comments will be automatically posted when you complete your turn in the review.

Post a line comment

1. In the Code Reviews tool window, select a review.

2. In the Files tab, double-click a file that you want to open for comments. You can then use the Code Reviews | Commits tab to narrow down the list of changes.

3. Hover over a line of code and click . To select multiple lines, click a line of code and drag your cursor up or down.

4. Enter your comment and press Enter.

5. If it's your turn in the review, you can also select how to post the comment:

   • Select Post now if you want to notify the review participants immediately.

   • Select Save as Draft if you do not want to post this comment right now. Draft comments will be automatically posted when you complete your turn in the review.

Mark files as viewed or not viewed

Files that have not been reviewed yet are marked with a blue dot on the Files tab. If you open the file diff, it is considered as viewed. You can mark files as viewed and not viewed to keep track of what remains to review.

1. In the Code Reviews tool window, select a review.

2. Open the Files tab.

3. Right-click a file and in the context menu click Mark as Viewed or Mark as Not Viewed.

Mention people

In general and line comments, you can mention users of your Space organization to invite them to discussions. They will then receive a message in Space Chats.

1. While writing a comment, enter @.

2. Select a user from the list.

Complete your turn in a review

If you are a reviewer in a turn-based review, you are usually supposed to complete your turn by either accepting the changes or requesting additional information from the author. When you complete your turn, draft comments become visible to other participants of the review. For a detailed description of turn-based reviews, refer to Space documentation.

1. In the Code Reviews tool window, select a review.

2. On the Details tab, select how you want to complete the review:

   • Click Wait for Response if you want to come back to this review later; for example, you expect the author to make changes and want to review them.

   • Click Accept if you accept the changes.

   These two buttons also display the count of your line comments that are saved as drafts and are not yet visible to other participants of the review.

If you have selected the Wait for Response option, it will now be the author's turn to review your comments and send the review back to you. You can repeat this process until both of you accept the changes.

Quit a review

You can quit a review if, for example, you no longer participate in it and don't want to receive notifications on new comments.

1. In the Code Reviews tool window, select a review.

2. Click Leave review.