Editorial Comments
4 min
editorial comments let you attach feedback to a specific passage of an article — similar to "track changes" comments in a word processor they are meant for the editorial review process authors, editors and reviewers can discuss a sentence or paragraph directly inside the article, without changing the text itself editorial comments are available on every article in the purple hub editor for how comments fit into a review/approval process, see usage of an editorial workflow docid 7liyl6ttq0zosqazgiyex the editorial comments sidebar all comments for an article live in the editorial comments sidebar open it from the comment icon (a speech bubble) in the top right toolbar of the editor the sidebar lists every comment on the article for each comment you see the marked text the comment refers to (the "contextual text"), the comment itself, who wrote it (name and role) and when adding a comment in the article content, select the word, phrase or paragraph you want to comment on in the formatting toolbar that appears, click the contextual comment button (the comment icon) a popup opens type your comment — you can use basic rich text formatting (bold, italic, lists, links, colours) — and save it the selected passage is now highlighted in yellow in the article, and your comment appears in the sidebar the highlight marks exactly which text the comment belongs to, so anyone reading the article knows what is being discussed you can comment on the article body as well as on the excerpt finding the marked passage while the sidebar is open, every commented passage is highlighted yellow in the content each comment in the sidebar has an eye icon click it to scroll straight to the marked passage in the article and briefly flash it, so you can quickly locate what a comment is about — useful in long articles if the marked text can no longer be found (for example because it was deleted from the article), you are notified instead of being scrolled to nothing replying to a comment every comment can be discussed as a thread use the reply action on a comment to add your response below it replies are shown indented under the original comment, together with their author and timestamp, so a whole discussion stays attached to the same passage editing a comment use the edit action to change the text of a comment you have written deleting comments use the delete action to remove a comment deleting a comment also removes its replies deleted comments are not gone for good instead of disappearing, they move into a collapsible deleted comments section at the bottom of the sidebar, which shows how many deleted comments exist expand it to read the history of what was discussed and removed deleted comments no longer have a yellow highlight in the content and can no longer be replied to or edited there are two ways a comment gets deleted you click delete on the comment in the sidebar you remove the highlight from the marked text in the article (for example by toggling the contextual comment button off on a highlighted passage, or by deleting that part of the text) the comment and its highlight always stay in sync, so removing one removes the other