How To Use the Commenting Feature
As an editor or QA member, it's critical to leave comments that help writers learn and show our project managers the changes you made to the assignment. If you're a writer, you should review all comments from the editor, QA, and project manager so you can continue to improve your work.
Getting Started With Dante Comments
We expect editors and QA members to leave comments about the changes they make and the revisions they need the writer to make. All communication about the article should be in the comments section.
There are five comment options:
- General Comment: Use this type of comment to highlight good work or show you made a subjective edit. This comment will appear pink until resolved.
- Spelling Error: This type of comment is for spelling and grammatical errors. This comment will appear yellow until resolved.
- Style Error: This comment type is for errors related to the style guide or instructions, such as missing images or broken links. This comment will appear yellow until resolved.
- Writing Error: Use this comment type for quality issues or factual errors. This comment will appear yellow until resolved.
- Message: If you need to make a comment about the article overall or want to message anyone else on the assignment, you can leave a message. This comment will always be gray.
The first four comment types are in-line comments. The last option makes a general comment. In-line comments will appear as Unresolved until the writer or editor resolves them. You do not need to resolve a message.
Subject matter experts only have general comments and messages available since they don't need to edit content for style, spelling, or grammar.
How To Make Comments
It's critical to make comments on the changes you make. This shows QA and the project manager what you did and helps the writer learn. If you find multiple similar errors, you can make one comment for all the errors instead of commenting on each one. For example, if the writer used the wrong-sized subheadings, you can comment, "Adjusted all the subheadings to H2."
1. Select the text you want to make a comment on.
2. Click on the message bubble in the toolbar.
3. Choose the type of comment you want to make from the dropdown.
4. Add your comment.
5. Click Add Comment.
Your comment will appear in the sidebar.
To send a general message, type your comment in the box at the bottom of the comment sidebar, then click Post Comment.
Your message will appear in the sidebar.
To edit your comment, click on the three white dots at the top right side of the box.
Click on Edit.
Make your edit, then click Update.
Your edited comment will appear in the sidebar.
To delete a comment, click on the three white dots at the top right side of the box.
A pop-up will ask you to confirm or cancel your request.
If you choose Delete, your comment will be removed.
Replying to Comments
You can reply to a comment to keep conversations organized. To reply to a comment, click on the three white dots at the top right side of the box.
Add your reply in the message box at the bottom of the sidebar.
Click on Post comment to add your reply.
Your reply will appear below the original comment.
Click the back arrow by Thread Details at the top of the page to go back to all comments.
This is how the reply will appear in the comment sidebar.
How To Direct Mention in a Comment
Everyone on the assignment will receive a summary of comments for each assignment in their Dante and email inboxes. If you want to direct your comment to just one person on the assignment, you can direct mention them. Everyone else on the assignment will still be able to see the comment in the sidebar, but only the person who was direct mentioned will receive a notification.
When you make your comment, add the @ symbol. The available people you can direct mention will appear.
Click on Post comment when you're finished. You can notify the person immediately by checking the box next to the Notify immediately text.
The comment will appear in the sidebar.
How To Resolve Comments
You can't submit the assignment until you resolve all comments. As an editor, you can submit an edit request with unresolved comments. It's the writer's responsibility to make the necessary changes, resolve the comment, and resubmit the content. It's the editor's responsibility to review the changes, then resolve the comment before submitting it to the next stage in the process.
As a Writer
Review the editor's comments and make the requested changes. Once you make the revision, you can resolve the comment. The comment will appear as Revised in the sidebar.
Once you revise all comments, you can resubmit the assignment.
As an Editor
If the changes you need to make are simple, you can complete the revisions and revise the comments yourself. If you think the changes will take you longer than 15 minutes, send an edit request. You can also make the simple changes and ask the writer to to make the heavier revisions.
Once you get an edit request back, review the changes the writer made. If they satisfied the request, you can resolve the comment. Click on the highlighted portion of the text or the three dots in the comment box, then click resolve. The highlighting or box should appear green if it was yellow and gray if it was pink.
You can approve the article once you resolve all the comments.
Bulk Resolving Comments
If you want to resolve many comments at once, you can bulk resolve them. Too bulk resolve, click on the three dots on the top right of your comment box, then click "Bulk Resolve Comments."
If you feel the writer did not complete the changes you requested, you can reopen the comment. Reopening it means either you need to send another edit request or adjust the content and resolve the comment yourself. If it's possible, try to resolve the error yourself, but if it will take you longer than 10 minutes to fix, send another edit request.
To reopen a comment, click on the three white dots at the top right side of the box, or click on the highlighted text for that comment.
If you click on the highlighted text, you'll have the option to reopen from the pop-up.
From the three dots, you can select Reopen from the dropdown.
Once you reopen the comment, it will appear as Unresolved again.