Add inline comments
Comments are an excellent way to engage your colleagues in a discussion about a certain topic that you may need clarification for. They enable you to provide feedback on the content, share valuable insights, ask questions, and foster collaboration and teamwork.
Additionally, you can use comments to create notes for yourself as you're going through your documentation.
In the editor, highlight any piece of text (a word, a whole phrase, or an entire paragraph). The menu bar will pop up - click the Comment button on the far right.
On the right side of the page, a conversation will open where you can leave a comment or engage your colleagues in a discussion
Unresolved comments are marked in light yellow. Click the highlighted text to open the comment box in the right sidebar. The comment box provides the following options:
- Continue thread - type your answer and hit the "Reply" button
- Resolve comments (click the ✔️ button in the upper right of the comment box)
- Delete comments/thread (click the 🗑️ button in the upper right of the comment box)
❗If you delete the comment thread, you will delete all the conversation as well
Reopen a closed comment/thread by clicking the UNDO icon on the upper right of the comment box
A closed/resolved comment thread is highlighted in grey. When a comment thread is resolved, it will still keep history in that thread, until deleted. The text will stay highlighted in grey until the thread is deleted.
💡You can tag a specific team member or mention @document_name as well in the comment thread.
Check out @ Mentions and dynamic links for more info!
