Using comments to collaborate

Overview

Use comments to collaborate with your team members. Start a discussion on questions, sections, and documents to track information about content and keep team members informed.

You want to track a discussion around a specific question, notify your team members of questions, send attachments or add remarks for improving a section, or instruct team members when documents need to be updated.

For additional tips on collaboration within projects, see the Academy course Collaboration and Review.

Adding comments to questions

1. Select Answering Page from the left-hand menu, then click the Comments tab or the Comments icon for the question.
   
2. Enter your comment, then do the following as needed:
   • Click the Paperclip icon to attach a file, which will appear under the comment.
     
   • Tag a team member in the comment by @mentioning their name. Each user mentioned in a comment receives an email notification with a link to the discussion. If a user is not @mentioned in the discussion but would like receive email notifications about it, they must select the Follow discussion toggle.
     Note: You can also @mention teams, and each member of the team will receive an email notification with a link to the discussion. To mention guests, use their email address.
     
   • Edit or delete a comment by clicking the More Options icon and selecting the appropriate menu item.
     
3. Click Send.

Adding comments to sections

1. Select Sections from the left-hand menu, then click the More Options icon next to the section and select View Comments. The Section Comments pane opens and you can see any existing section-level comments.
   
2. Enter your comment, then do the following as needed:
   • Click the Paperclip icon to attach a file, which will appear under the comment.
     
   • Tag a team member in the comment by @mentioning their name. Each user mentioned in a comment receives an email notification with a link to the discussion. If a user is not @mentioned in the discussion but would like receive email notifications about it, they must select the Follow discussion toggle.
     
     Note: You can also @mention teams, and each member of the team will receive an email notification with a link to the discussion. To mention guests, use their email address.
     
   • Edit or delete a comment by clicking the More Options icon and selecting the appropriate menu item.
     
3. Click Send.

Viewing discussions

Comments for projects appear on the Discussions tab.

1. Select Discussions from the left-hand menu. Your discussions are listed on the page, and you can toggle between all discussions and your discussions.
   
2. Do the following as needed:
   • Click the Information icon to see the discussion properties.
   • Click the + New Thread button to to start a new thread for the discussion.
   • Click New Discussion to create a new discussion for the project.
   • Edit or delete a comment by clicking the More Options icon and then selecting the appropriate menu item.
     
     You will see any existing comments and be able to add one.
     
     If you are @mentioned on the discussion, you will automatically receive notifications about it. Otherwise, you must select the Follow discussion checkbox to receive the notifications.

Resolving comments

The Unresolved Comments indicator shows that there are unresolved comments for a section or question.

As a best practice, we recommend resolving any comments before completing a section in a project.

Do one of the following to resolve comments:

• Click the Check icon in the Comments pane.
  
• Click the Resolve button on the Discussions page.
  Note: You can click the button again to reopen the comment.
  

When all the comments are resolved, the indicator disappears.