Collaborating in Smart Author

Whether you are developing courseware by adapting content from Acrobatiq’s library or by creating it from scratch, the effort will require teamwork. Smart Author helps organizations scale the development of rich, interactive adaptive courses by facilitating not only authoring but also reviewing. Smart Author supports full-team collaboration in three ways:

1. It allows administrators to define multiple roles so that all contributors have access to the content and functionality that each contributor needs.

2. It provides easy-to-use commenting tools.

3. It supports a staged and easy-to-manage review process.

Roles

By default, Smart Author administrators have the option of giving team members one or more of the system’s three pre-defined roles: Manager, Author, Reviewer. The administrator can also assign a custom-designed role. 

Administrators access the Roles page from the Roles link on an organization’s Teams page. Questions about a role assignment should be sent to the administrator who is managing your team’s work in Smart Author. 

This section explains how team members in the Author role find and resolve issues addressed in comments left in the platform by team members in the Reviewer role.

Role Descriptions

Role

Description

Author

Authors write initial drafts, compose instruction, design activities, and conceptualize visuals and interactive media. They are also able to add comments for others to review. 

Manager

Managers have the same permissions as authors. Managers also have the ability to respond to and “resolve” the comments their colleagues and project stakeholders insert. They also have additional permissions not related to collaboration (see Roles page). 

Reviewer

Reviewers have the ability to view course content and comments. As reviewers work through the content, they can leave comments for course authors.

 

Comments

Comments can be left for the team at the section level, and any comments made in the Page Builder (edit mode) can be viewed on the Preview page (preview mode). Likewise, comments may be added and reviewed on the Preview page. To add/review comments from a preview page:

1. Click the Toggle comments quote bubble at the bottom right of the screen to activate commenting. 

 

ReviewingA.png

2. Click the Toggle intext comments quote bubble, then click Comment here, to highlight text and add your in-text comment.

ReviewingB.png ReviewingC.png

 

ReviewingD.png

3. Click the Toggle comments on the blocks quote bubble to open the comment(s) on the top of a section. You can also comment on the block of comments at any time after you have activated the comments.

ReviewingE.png

For more more detail on commenting, see the Building Pages module. 

 

Review Process

Smart Author supports three stages of reviewing. Click the quote bubble at the bottom right of the page one time to toggle on the first stage of Comments Mode. Click it again to cycle through the other stages of Comments Mode. 

Stage One: Toggle Intext Comments. In Stage One of Comment Mode, the comment counts are revealed for each section. Click on the comment count icon to reveal the comments in that section.

ReviewingF.png

Stage Two: Stage Two of Comments Mode gives team members the ability to leave new comments on the preview page in Toggle Intext Comments mode.

ReviewingG.png

Stage Three: Toggle Comments on the Blocks. Stage Three of Comments Mode is the ability to expose all section-level comments.

Note: A best practice for reviewing courseware that is in development, as well as resolving comments, is to work with two documents close at hand: an organization's Project Style Guide for the course and its Project Review Checklist.