DOCUMENTS

Add inline comments

2min

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.

How does it work?

1

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 Add comment button on the far right.

Comment button
Comment button

2

Type your comment and then hit the ➡️ button on the right side.

Commenting
Commenting

3

Unresolved comment are highlighted in yellow. Click on the highlighted word to open the comment box. The comment box offers the following options:

  1. Continue thread - type your reply and hit the ➡️ button

    Continue thread
    Continue thread
    
  2. Resolve comments (click the button in the upper right of the comment box)
  3. Delete comments/thread (click the 🗑️ button in the upper right of the comment box)

    Resolve and delete comment
    Resolve and delete comment
    

If you delete the comment thread, you will delete all of the replies as well.

4

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!

Tag a colleague or @document_name
Tag a colleague or @document_name




🤔
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.