Review a partially updated topic - Cloud

Review

If you want your reviewers to focus on a specific piece of updated content rather than an entire topic, you may need to adjust your workflow.

The default Reviews workflow for updating a topic assumes that your author has already changed content in Author or quick-editing mode before the Review:

Authoring

Reviewing

Author

Create or Edit

Content

Reviews

quick-editing mode

quick-editing mode

Create or Edit

Content

Review

Topic

Edit and

Save Topic

To meet your requirement you need to tweak this workflow so that your author does not update in Author or quick-editing mode, but instead makes proposed or indicated updates.

In other words, start by placing the original content into a Review with yourself as the Reviewer. Then uses the normal Reviews utilities to propose how to change the original content.

Authoring

Reviewing

quick-editing mode

Original

Content

Reviews

Reviews

quick-editing mode

Author

Original

Content

Indicate the

updates

Review only

the indicated

updates

Edit and

Save Topic

To set up notifications for a partial review:

  1. Change the release state just for the topic you want reviewed. For example, a release state called Author Review.
  2. Initiate a review using the Review Form. As the intiatator you are automatically added as an editor, which is required in order to mark topics as Complete without necessarily Accepting/Rejecting comments.

    In the Review Form:

    • add the book that contains the updated topic
    • define the release state for the Review to match that assigned to the topic
    • make sure that the "Move topic to editorial when minimum mandatory reviewers have completed their reviews" check box is cleared, so you can mark the topic as complete without disengaging it from the review
    • assign yourself as a Mandatory Reviewer.
  3. In the review, propose the update to to the content using the normal Replace/Delete/Insert/Comment tools.
  4. Edit the Review Form to assign the reviewers as either optional or mandatory reviewers. If you want your reviewers to participate in the proposed update, add them at the beginning of the review.
  5. The system sends notifications to your reviewers to begin their review. If you want, contact your reviewers with instructions for the review, being sure to inform them:

    Dear Reviewer,

    • The notification period has been set low so that you receive email notifications and News feed notifications as close to real-time as possible - please monitor these during the review.
    • Please use the concurrent time period for the reviewing effort so that we all work on this simultaneously, and discuss it without time delays.
    • Please monitor and use the Reviews Discussion Pane to discuss any issues.
    • [For multiple topics] Only updated topics are accessible for reviewing. Please ignore the inaccessible topics.
    • Please focus your attention only on highlighted content and its associated Comments/Suggestions in the discussion pane. Ignore all other content.
  6. When the Review ends, follow the normal procedure to Accept and Reject changes, move the Review to Editorial, and Edit in quick-editing mode to create a final version.