Roles and Statuses in Review Process

Roles

There are four roles that review participants can take up:

Moderator — a person who oversees the review process, resolves disputable situations, and performs double check. The Moderator is also responsible for closing the review.

Author — a person who writes the code that is to be reviewed. The Author is responsible for bugs fixing, in case they were found. The Author acts as the Moderator of the review process in case the Simple Review Workflow is enabled.

Reviewer — a person who studies code and makes comments on it. A Reviewer takes decision whether to accept or reject changes in the source code that were made by Author.

Watcher — a person who monitors a review process. Watchers can receive all review notifications and can join a review any time if they want to add comments to a code.

Review Statuses

There are four statuses available for a review:

Under review — the gray icon indicates that a review is in progress.

Closed review — indicates that a review has been closed by Moderator.

Reworking — Author’s work has been rejected due to comments regarding the code.

Completed — indicates that a review has been completed.

Depending on the role, there is additional information that is displayed beneath each review. For instance, if you are the Moderator, you will see the “Moderated by me” statement beneath of a review. In case you act as the Author, the “Authored by me” statement will be displayed. If you are the Reviewer, you will see the “Pending” statement.

Comment Types

There are two comments types:

  1. A regular comment that may contain a question or a suggestion.

  2. A comment marked as a defect. Such a comment contains information about a bug in the code. A defect comment is marked with the Defect label.

Comments Statuses

There are several statuses available for comments:

Open - Indicates a new comment.

Fixed - Indicates that a comment is fixed.

Closed - Indicates that a comment is closed.