Reviews: Representing the entire team

Reviews allows for all team roles to collaborate on story acceptance in parallel (versus sequentially), representing everyone’s progress and contributions towards a given story.

For instance, testers might be helping with a design review, and/or designers might be conducting a team review, to surface potential issues before a feature is finalized. Also, certain stories might need review from your security or compliance teams, before or after developers start implementing them.

For more in depth information on the development and background of Reviews, please see the following blog article; Using Reviews to Scale Whose Work is Represented

The Reviews section is located near the top of the story form, just above the story details section.

reviews on collapsed story view

On the collapsed story view, any Reviews will be displayed along with their current status.

reviews section

To add a review

  1. Expand a story and select the + add review button, then choose the type of review you’d like to add. The default review types are Test (QA), Design, Code and Security. You can create your own custom review types as described in the Managing custom review types section of this article.
    add review button

  2. You can assign a review to yourself, or any other project member by selecting Reviewer, starting to type a project members name, and choosing the appropriate person from the autosuggest menu.
    add a reviewer button

  3. Choose the status of your review from the Select status menu to the right. Update your status as needed based on the state of the review. Available statuses are Unstarted, In review, Pass and Revise.
    add a review status button

To remove a review

Choose the Select Status drop-down menu, then select Delete Review.

delete a review

Managing custom review types

By default, Reviews come with four core review types; Test (QA), Design, Code and Security. You can create and manage your own custom review types on the Manage Reviews Types page under MORE.

Manage review types page

  1. Select More from the top navigation menu.
  2. Select Manage Review Types from navigation sidebar. Alternatively, you can bypass steps 1 & 2 by expanding a story and selecting + add review, then select Manage Reviews from the drop-down.
  3. Create a new review type using the Add a Review Type field, then select Add Review.
  4. Edit existing review types by selecting Edit next to the type in question, in the Review Types section.
  5. To disable a review type, select Hide next to the type in question, in the Review Types section. This will cause the review to no longer be available for use in the project.
  6. To re-enable a hidden review, select Show next to type in question, under the Hidden Review Types section.

Notifications for Reviews

When someone has been assigned as a Reviewer, they will be notified. All Reviewers are notified when the story has been delivered. Additionally, story owners, requesters or followers will be notified when a review passes or fails. For more information regarding notifications please see Notifications.

Reviews & My Work

Stories containing Reviews where you are assigned as a Reviewer will show up in your My Work panel, excluding accepted stories.

Searching on reviews

You can search for Reviews by their ‘status’ (e.g., review_status:pass), ‘type’ (e.g. review:"Test (QA)") or the assigned ‘reviewer’ (e.g., reviewer:"Princess Leia").

You can also query stories containing reviews of a particular type that are of a specific status. To do so, use the Review search keyword to combine the review type and status values separated by an ampersand (review:[review_type]&[review_status]). For instance, the following query will return all of the unstarted stories that need a testing review; review:"Test (QA)"&unstarted.

For more on performing searches in Tracker please see Advanced search.

Accepting stories with open reviews

If attempting to accept a story containing incomplete Reviews (i.e., Reviews with any status other than Pass), the following modal will appear warning of unresolved items on the story. This modal will also appear when attempting to accept a story with other unresolved items such as Tasks or Blockers.

unresolved items warning modal

Help us evolve Reviews!

This is just the first step in our mission to represent the entire, modern software team in Tracker. Additionally, this is just the smallest first version of that first step and we plan to make changes and iterate based on YOUR feedback. With that in mind, we’d love if your team would try it out, and give us your very honest opinions on what you did and didn’t like about Reviews (email us at tracker@pivotal.io).

Previous
Tracker's workflow
Next
Managing invalid or obsolete stories