Using the 'Reviews' section on the project dashboard

by freddy mallet|

    You might have already paid attention to this little and empty section named "Reviews" at the bottom right of any project dashboard, but what is this section about ?

    Originally, this functionality was developped for one of our customer : this company has a quality assurance team in charge of regularly interviewing members of development teams on different areas like "Configuration Management", "Project Planning", "Technical Design", etc. They already used Sonar to check and follow code quality on their projects portfolio and wanted to feed Sonar with the results of those reviews.

    In Sonar 1.5 we've extended this to any kind of metrics which could be fed manually like "Team size", "Business Value", ... But let's go back to Sonar 1.4.X and the way this functionality can currently be used.

    The first thing is to log into Sonar with the administrator account. If you go back to a project dashboard, you should now have the possibility to click on an "Add a review" link.

    Sonar will ask you first to create a review type and help you to switch on "Review types" tab under "Preferences" category :

    You can define your new review type by specifying the name (ex : Configuration Management, Technical Design), an optional description and the kind of metrics you want to use (ex : Number, Percentage, Yes/No). Once your review type is created, just go back to the project dashboard and feed Sonar with the results of your different kind of reviews :

    Those reviews are now displayed on your project dashboard as the other classical metrics :

    Of course, the history of reviews is also accessible :

    So far, we have not communicated too much on this functionality as we thought its scope was not generic enough. Things are gonna change in version 1.5 as

    • We stop talking about "reviews" but rather about "manual measures".
    • You'll be able to automatically define and calculate new metrics taht use those manual measures as well as classical measures like total complexity or code coverage.

    You'll therefore have the necessary tool set to calculate your own company quality indicator.