Using Collaborative Reviews

Reviewers can use the Collaborative Review (CR) feature on the content assigned to them as a means to both provide feedback to writers and view any annotations added by other assigned reviewers.

A CR differs from editing a topic or map. On the Collaborative Review page, you add annotations to the content that is there instead of editing the content directly. You can also see any annotations made by other users who are assigned to the same CR.

A writer creates a CR from a map, so all the topics in the map appear as part of the CR.

Figure: Collaborative Review page with callouts
Collaborative Review page

Item

Name

Function

1

Table of Contents side panel

Provides a responsive outline of all objects within a map

2

Color marks

Indicates objects that contain at least one annotation from a reviewer

3

Colored, highlighted text

Flags content with annotation within the content

4

Pop-up of annotation for the flagged text

Provides one point of access to annotation

5

Return button

Jumps from current location back to the top of the content

6

Colored, highlighted text

Indicates not only the selected content, but also the reviewer color highlight within the annotations side panel

7

Response dropdown menu

Provides reviewers access to the following status types:

  • Unresolved: Default state of annotation, which indicates the author has not made any change or update to content, based on the reviewer's comment

  • Accepted: Indicates the author has agreed to the reviewer's comment

  • Rejected: Indicates the author has chosen to ignore the reviewer's comment

  • Resolved: Indicates the author has resolved the comment by making an update to the content

8

Permitted action icons

Typical actions are to delete or to edit the annotation

9

Reply icon

Adds a response to the comment