Review a markdown file as context-only

After you import a markdown file, it's saved as a binary. You can edit markdown binaries in a lighter version of the Oxygen editor. You can also add a markdown binary to a review, but it is included as Read-only to give reviewers context. Reviewers can't add comments or make changes to files that are context-only. You can ask reviewers to add any comments about the markdown file in the Collaboration panel, which includes a Discussions pane for adding comments.

If you want to assign components to an individual user for review and allow them to comment and track their changes, you can create a review for one or more independent chunks of information, such as a concept, task, or map. The DITA topics must be stored in its own file in Inspire and unlocked. Follow the steps in Review DITA topics.

To create a review from the Components browser:

  1. Select Components.
  2. On the Components tab, to send one component to review, right-click the component's row and then select Review...
    You can also access this option by selecting the component, selecting the Options menu and then selecting Review...
  3. To send multiple components to review, select the checkbox for each component, and then in the Selected Components pane, select Review Components browser Review .
  4. On the Create Review dialog, in Title, enter a descriptive name in 50 characters or less.
  5. By default, you are the review coordinator. If you want to change this, select a user from the Coordinator list.
  6. In Components, the component you selected is shown. The Review Scope is Context-Only. To add more images or locked components:
    1. Select Add Components.
    2. On the Select Components screen, in Folders, navigate to the location of the component you want to add to the review.
    3. In Components, select the checkbox for each component you want to add to the review.
    4. You can also add any markdown binaries to the review (as Context-Only).
    5. Click Select.
  7. In the Reviewers section, click Add Reviewer.
  8. On the Select Users dialog, if the list is large or you only want to see a certain type of user, you can narrow the list in the following ways:

    1. To see only names that contain a word or specific letters, in Filter, enter text. For example you can find names that contain "admin", or "review". You can't search for text in any other column except Name.
    2. To see all users but sorted by Name, Security Type, or User Type, click the column heading and then click the grey arrow. To sort by Name or User Type you can also use the Sort By dropdown box.
    3. By default, names with a User Type of Support are not included in the list. To see these users, select the Include support users option.
  9. On the Select Users dialog, in the Available Users list, select the checkbox for each user you want to include in the review, and then click Select.
    The selected users appear in the Reviewers list.
  10. By default, the Notifications checkbox is selected and users will automatically receive email notifications once their review is ready. You can clear the Notifications option for any users you don't want to automatically send notifications to.
  11. Optionally, to choose a date when this review begins, use the Start By calendar.
  12. Optionally, to adjust the time when this review begins, after the Start By calendar, select the checkbox and then select a time.
  13. Optionally, to choose a date when this review is due, use the Due By calendar.
  14. Optionally, to adjust the time when this review is due, after the Due By calendar, select the checkbox and then select a time.
  15. Optionally, enter any additional information in the Description text box, using 3000 characters or less.
  16. To create the review, click Create.
    Inspire notifies each reviewer that they can participate in this review. If a reviewer clicks the review link in the notification, they can access:
    • The content in a read-only viewer.
    • The Collaboration panel, which includes a Discussions pane for adding comments.