Creating reviews

The first part of the Create Review form lets you specify a review title, dates, and a description.

• Title. A descriptive name for the review using 50 characters or less.
• Coordinator. A user who can create and manage a review. The user must belong to the Review Coordinators role.
• Approver. This role is assigned to the review Coordinator by default. You can change the default to assign the approver role to any Inspire user that has permissions to work on reviews. The review Approver must fill out the information on the Review Approval screen before a review can be completed.

  This field is required. If you want to change the default assignment, you cannot leave it blank.

• Start By. Optional field to specify in the review notifications when the reviewers should start on their assignments.
• Due By. Optional field to specify in the review notifications when the reviewers should complete their assignments. The reviewers will see the review deadline in orange text on the due date is the current date, and red text when the review assignment is overdue.
• Description. Optional field to provide additional details or instructions to the reviewers. You can use 3000 characters or less.

The second part of the Create Review form lets you list the components that need to be reviewed, and shows you the Review Scope.

Filters. When you create a review, you can also specify what content should be shown to the reviewer by applying a filter of profiling attributes. For more details on using filters, read Filter Reviews.

Components. A topic in DITA is an independent chunk of information covering a single idea or task, authored as a unit, and stored in its own file. Topics are categorized by information type, such as a concept, task, map, or glossary entry.

You can add binary components (images, PDFs, WORD docs) to a review.

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

• Maps can be reviewed like any other DITA component.
• The map opens in the Oxygen editor.
• Reviewers can comment or edit it.

Component tips and tricks

Adding components that have attachments.

If a component has an attachment, you see a paper clip icon before Review Scope.

= Has an attachment (black paper clip icon)

= Is an attachment (green paper clip icon)

• If you add an unlocked component to a review, and the component has one or more attachments, Inspire automatically adds the attached components to the review

In a review, attachments are opened in one of the following ways:

• If the component is a binary file (image, PDF, WORD doc) it can only be opened in a read-only viewer regardless of whether it is unlocked or locked.
• If the component is NOT a binary file (a DITA topic) and it is locked, it can only be opened in a read-only viewer.
• If the component is NOT a binary file (a DITA topic) and it is unlocked, it can be opened in the Oxygen editor.

  A review coordinator or administrator can change a component that is In Review to Context Only by clearing the checkbox in the Review column.

Attached components are also locked with a system lock in the Components browser until the review is resolved

Component details.

• Review. Select this checkbox for the topics you want reviewed. You cannot select it if the component is open, locked, a binary, or is Context Only.
• Review Scope. Identifies if a component is:
  • Unlocked and not binary = In Review
  • Locked or binary = Context Only
• Name. The File Name of the component without the GUID.
• Type. Identifies the structure or schema of the topic.

The third part of the Create Review form lets you assign a user to review the components and grant or deny them the ability to edit the text in review.

• Full Name. The user name as it appears in the user's profile. For example, Jane Doe.

  You can add multiple reviewers. The first use listed must complete their review assignment before the next user in the list can start their review.

• Track Changes. Identifies if the user can only add comments to the text in review (Track Changes is not selected) or if the user can edit the text in review (Track Changes is selected).

  An administrator can remove the ability for all reviewers to edit content and track changes.

  • If an administrator sets the ReviewCommentOnly feature to false, you can select or clear the Track Changes option.
  • If an administrator sets the ReviewCommentOnly feature to true, you can only create a review with comments in the Create Review and Update Review screens. The Track Changes option does not display.
  • By default, the ReviewCommentOnly feature to false, and you can select or clear the Track Changes option.
  • Administrators can read about how to manage this feature in Limit reviews to comments only.
• Notifications. Identifies if the reviewer is notified when they have a review assignment to complete.

  When you complete a task that triggers a notification, such as creating or completing a review, the Slack and email message bodies contain:

  • The notification with ten or less Issues, Errors, and Warnings.
  • A link at the bottom of the message [See Full Version].
  • You can click the [See Full Version] link to expand a section under the link with the full details.