[[PageOutline(2-3, Categories, pullout)]]
= Review of Changesets
There is support for reviews of [TracChangeset changesets]. The user may create a review on the changeset page and all modified files are automatically gathered and attached to the new review.

The review may be done either on the changeset page or using the dedicated review pages provided by the plugin.

== Creating the review
A new section is inserted into the changeset page when the current user has sufficient permissions to create a review.

After selecting users it is possible to create the new review. 

{{{#!box width=500
==== Creating a new review
[[Image(codereview_changeset_create.png, width=480, border=2)]]
}}}

== Review details
Details about the review are shown in the **overview** section of the changeset page. There is a direkt link to open the review page.

{{{#!box width=500
==== Review information
[[Image(codereview_changeset_info.png, width=480, border=2)]]
}}}

The review page shows more information and allows to change the review status. In addition you may comment on files added with a changeset (see [ChangesetReview#Notes Notes]).

{{{#!box width=500
[[Image(codereview_changeset_reviewpage.png, width=480, border=2)]]
}}}
== Perform the Review
It's not necessary to leave the changeset page to perform a review. Every line number of the source file view is a link which opens a dialog to add a comment.
 
{{{#!box width=500
==== Commenting on a source line
[[Image(codereview_create_comment_inline.png, width=480, border=2)]]
}}}

It is possible to reply to existing comments. The user may chose the presentation of the file view, either {{{inline}}} or {{{side by side}}}.

{{{#!box width=500
==== Comment tree in {{{side by side}}} view
[[Image(codereview_comment_tree.png, width=480, border=2)]] 
}}}

== Notes

* You can't add user groups to a review. This means, you can't grant code review permissions to e.g. {{{anonymous}}}. This is a known limitation (see also #12782).
* To use more advanced features like [../Workflows review workflows] you have to open the review page.