Review a map

You can review a DITA map to give feedback on the topics that are included and the topic sequence.

Tips and Tricks

  • After you add comments or make changes you can manage them in the Review panel on the right side of the editor.
  • If you start on a review but need to stop before it's done and finish it later, you can:

    1. Save your changes .
    2. Do one of the following:
      • Close the tab
      • Click Save for Later

    Saving your changes and closing the review doesn't update the progress shown for the review on the Dashboard or the Review Management tab. This percent only changes when an entire task in the review is completed, such as when you click Complete Review.

Regardless of your permissions, when you're reviewing a map, if you click on a topic reference link:

  • If the target component is not also included in the review, you can only open it in a read-only viewer from a review.
  • If the target component is also included in the review, you can open it to comment or edit it from a review.

Now you can add topics to a review if they are in a map but not in the review.

In the example image above:

  • A topic in the map called Chpt3_Install_battery_card is in the map that's being reviewed
  • The Chpt3_Install_battery_card topic is not in the list of Review Components, which means it isn't included in the review.

If you're reviewing a map component, and you identify changes that need to be made in referenced component:

  • You can add that component to the review and make changes, even if you aren't a review coordinator or administrator.
  • If review locks are configured, after you add the component to the review it is locked and included in the review.

For more help, read Add map topics to a review.