The objective of the Manual Review feature is to be able to assign a violation to a user and start a discussion thread which should eventually lead to the correction of the violation. A review has only two status : Open or Closed. Sonar automatically takes care of closing a review as soon as its underlying violation gets resolved.
Create a review
To create a review, the user must be first logged in and has the Users role on the project containing the violation to review. Then, directly in the resource viewer, a new "Review" link appears to start creating a new review when placing the mouse over the violation title :
A comment must be filled before being able to really create the review by clicking on the "Add comment" button :
By default, a review is assigned to the creator of the review. If the check box is unselected, the review will be open but not assigned to any user.
Once a review has been created on a violation, every Sonar user can see the review below the violation :
Only the last comment on a review can be edited by the creator of this last comment.
Search for a review
The Reviews page allows to search for any review with optional filter parameters like the project, the author of the review, the severity of the violations, ... :
Be default, all reviews assigned to the current user are displayed.
Clicking on the title of a review allows to display the detail of this review :
Flag a violation as false-positive
If a violation is a false-positive, this is pretty straightforward to switch off this violation by clicking on the "Flag as false-positive" link :
Once a violation is switched off, this violation is no more displayed by default in the resource viewer. The option "False-Positives only" must be selected to display those false-positive violations :
Moreover, all measures on the project like the number of violations will be updated the next time a Sonar analysis will run.
This is not currently possible to search for false-positive violations but this feature should be quickly available in next versions of Sonar.