Open topic with navigation
Review list page quick reference
The Reviews page lists code reviews that are in progress, and code reviews that are complete..
- Log in to Swarm.
- Click the Reviews link in the main toolbar.
Jump directly to a specific area of the Reviews page using the following links:
Opened and Closed tabs
The Opened and Closed tabs display:
- Opened tab: displays a list of all code reviews that have started, are being reviewed, are awaiting revisions, or need to be committed.
- Closed tab: displays a list of all code reviews that have been approved and committed, rejected, or archived.
Review filters
Tip
Swarm updates the URL in your browser to reflect filtering options. This makes it easy to bookmark or share review list URLs. Swarm maintains the current filtering if you click on a review link and then use your browser's back button to return to the review list.
The following filters are available (from left to right):
- Projects dropdown: filter by the project the review is part, options are:
- All Projects: displays all reviews for all projects.
- My Projects: displays all reviews for all of the projects you are participating in, as a member, owner, moderator, or follower.
- Project Search: an auto-complete search field that allows you to choose one of the projects defined in Helix Server. Once specified, only reviews for the selected project are displayed. Click the X button to remove a projectid after it has been specified.
- Select Project: selecting a project name only displays reviews for that project.
- Users dropdown: filter by the author of the review, options are:
- All: displays all reviews.
- Reviews I've Authored: displays reviews that you have authored.
- Reviews I'm Participating In: displays reviews that you are a reviewer of, but not an author of.
- Review I've Authored Or Am Participating In: displays reviews that you have authored, or are a reviewer of.
- Author Search: an auto-complete search field that allows you to choose one of the user accounts defined in the Helix Server. Once specified, only reviews authored by the user are displayed. Click the X button to remove a userid after it has been specified.
- Reviewer presence buttons, (Opened tab only):
- Has Reviewers: displays reviews that have one or more reviewers.
- No Reviewers: displays reviews that have no reviewers.
- Review state buttons, (Opened tab):
- Needs review: displays reviews that need to be reviewed.
- Needs revision: displays reviews that have been reviewed, but need further revisions before the review can be accepted.
- Approved: displays reviews that have been approved, and should be committed.
- Review state buttons, (Closed tab):
- Approved: displays reviews that have been approved and committed.
- Rejected: displays reviews that have been rejected.
- Archived: displays reviews that have been archived.
- Test status buttons (when automated tests are enabled for the associated project):
- Tests pass displays reviews that have passed tests.
- Tests fail: displays reviews that have failed tests.
- Vote status buttons:
- Comment status buttons:
- Bookmark: review filters can be remembered by bookmarking the page, this icon acts as a reminder of that.
- Search: searches the review description and displays reviews that match your search string.
Reviews list content
The review list displays a summary for each review.