Documentation Center

Reviewing and commenting

Reviewers use Content Delivery to check a publication, provide feedback to the authors, and verify if the changes suggested in their comments are accepted and implemented, or rejected. These activities are referred to as Collaborative Review.

The Content Delivery landing page in Content Delivery displays an overview of the available publications, and a feed with the most recent comments.

In the middle pane of the Content Delivery page, click the publication you want to open, navigate the hierarchy, and browse to the topics you want to review. Notice these features of the topic view:
  • The table of contents (or index) appears on the left.
  • The publication and topic hierarchy path for the current topic appears in the breadcrumb trail across the top.
  • Any comments on that topic appear to the right.
You can easily view, edit, add or delete comments, as well as reply to them.
Click the Add Comment button to add a new comment

To make it easier for authors and reviewers to understand the immediate context a comment refers to, you can associate a comment to a specific text selection.
Select some text and add a comment to associate it to the highlighted text

The contextual content is displayed in a tooltip when you click the Show referenced text button in the corresponding comment.
Click the Show referenced text icon to display a tooltip with the text the comment refers to