About the Collaborative Reviewer

The Collaborative Reviewer contains a variety of markup tools and is associated with the Votes and Annotations view.

The review files open in a special PDF editor in the same area of the DITA Perspective where XML editors appear.

A variety of annotation and markup tools are supplied: virtual sticky notes, highlights, and underlines, even a set of proofreader's marks.

Several users can review a file at the same time. The annotations and markup are pushed onto the server whenever the reviewer saves the file and become visible to other reviewers when they re-open the file.

While a user is reviewing a file, the Collaborative Reviewer creates a temporary file for it on the local disk. If the connection to the DITA CMS is lost before the review file is saved back to the server, the temporary file preserves the changes until the connection is reestablished. When the connection is reestablished and a temporary file is found for a user's assignment, the assignment is marked as modified, the changes are restored to the review file, and then the user can save the changes to DITA CMS.

Annotations view

Many of the annotations allow for additional comments to be attached. These reviewer comments also appear in the Annotations view. Authors or Graphic Designers (or whoever is responsible for the file) can revise these comments after the file is returned to them and respond to the suggestions.

DITA CMS maintains successive copies of PDF review files, which may also be accessed from the Annotations view.

Votes view

Reviewers who have been officially assigned to the file can vote on whether to accept or reject it using the Votes view. This view also shows the approval system in effect for the current document and how each of the reviewers has voted.

review tool