Workflows

PeerreviewPlugin supports workflows for reviews. There is one for the author of a review and another one for reviewers. An administrator may change the workflow in trac.ini similar to ticket workflows.

Reviewers may mark their individual progess just to inform the review author. The workflow states are not used for any other purpose or to impose any restrictions. For example it is possible for a review author to close a review even when none of the reviewers ever changed his personal workflow state.

The overall review workflow controlled by the owner of the review (or a manager) is more involved. When setting a review to a finishing state all associated files are set to the same state. This means if the owner sets the review to approved all files are also set to approved.

Review Workflow

This workflow is set in section [peerreview-resource_workflow] of trac.ini. The default workflow after installation is the following.

[peerreview-resource_workflow]
...

Workflow operation set_review_owner

You may configure a custom workflow operation set_review_owner for reviews.

[peerreview-resource_workflow]
change_owner = * -> *
change_owner.name = Change Owner to
change_owner.operations = set_review_owner
change_owner.permissions = CODE_REVIEW_MGR

This operation allows you to change the owner of a review. Possible users are taken from the same list as the one used when creating a review. In the given example you need the permission CODE_REVIEW_MGR to perform the operation.

Reviewer Workflow

To be written...