This page explains how to create a Crucible review.
There are a number of ways to create a review. Choose from the list below:
- Creating a Patch Review
- Creating a Review within Crucible
- Creating a review from FishEye
- Creating a review from JIRA
- Creating a Review from a URL
- Creating a Snippet Review
Whichever way you choose, the overall process looks like this:
|
Note that only people with the 'Create' permission can create a review.
Review creation considerations
Review effectiveness
Based on our own experience of over 13000 reviews, we have found that reviews with fewer files and reviewers are more effective. We have seen effects such as:
- Time spent reviewing decreases as the number of files increases.
- Reviewers spend less time reviewing as the number of reviewers increases.
- Reviewers find fewer defects as the number of reviewers increases.
This suggests that reviews should be created with care to get the best value from them:
- Avoid overloading the review. Reviews should be focussed on a few necessary files.
- Avoid overcrowding. Reviewers should be selected with care, and should be guided individually on what to look for.
Crucible performance
The performance of a Crucible instance can be seriously degraded if very large reviews are created.
To prevent a user from accidentally causing this, Crucible has a limit on the review content size when creating reviews. The limit is 800 file revisions.