> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.brainframe.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Document Comments & Activity

# 💬 **Document Comments & Activity**  
> **"Keep discussions and history in one place."**  
> *Track activity, add comments, and collaborate directly on any document.*  

---

## 1️⃣ Activities Tab Overview  
Every document in Brainframe has an **Activities tab** where you can:  
1. Discuss the document independent of approval stages.  
2. View all activity logs related to the document.  
3. Rely on automatic updates whenever a change is made.  

📌 *This creates a permanent **audit trail** of comments and actions.*  

||| Comments are not yet supported in documents that are in the markdown format.
---

## 2️⃣ Adding a Comment  

Navigate to a document and click the **Activities** button in the top-right corner.  
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-17151_chyd3n.png)

Click the **Add Comment** field in the comments section to open the editor.  

![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-17161_1e3395m.png =504xauto)You can:  
1. Write remarks or feedback about the document.  
2. Tag users with **@username** to notify them by email.  
3. Reply to tagged comments—notifications are sent automatically.  

| 📌 All comments remain tied to the document for context.  

---

## 3️⃣ Additional Actions  
From the Activities tab, you can also:  
* Create new **tasks**.  
* Add **risk readings**.  
* Add **KPI readings**.  

💡 *The options available depend on the document type.*  

---

## 4️⃣ Updating Document Age Tracking  
By checking the box **“Mark this document version as reviewed”**, you can see the review status reflected in folder content (if enabled for that type).  
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-17164_2fftyc.png =494xauto)📌 *This helps demonstrate ongoing review compliance without unnecessary version clutter.*  

---

## 5️⃣ Adding a comment to a specific text

If you want your comment to be linked to a specific section of the text, you can use the built-in comment features similar to Word's. Select the text you want to add the comment to, and click on the comment menu. This will open a dedicated comment window, where you can add multiple comments and notify the relevant users. You can also remove the comment or mark it as resolved


![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-17175_hvneym.png =840xauto)

Texts with comments appear in yellow, and hovering over them shows the comment history.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/comment-history_1uk2jv8.webp)� *Resolving a comment hides the yellow text, but keeps the comment message for audit purposes.* 
---

## 6️⃣ View and reply to comments on a document

Just like when you are adding a new comment, by going to the activities section of a document, you can find all the previous comments on that document.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-17185_1vzzrwu.png =723xauto)By clicking on the reply button, you can address another user's comments and they will be notified of your contribution.


| 📌 If your documents are in Word format, you can see the comments in our integrated editor, just as you would if you were using word.
---

## 7️⃣ Best Practices  
* 📌 Always tag relevant users to speed up responses.  
* 💡 Use comments for **collaboration**, not just version notes.  
* 🗂️ Check activity logs during audits to prove control effectiveness.  
* 🔍 Use **age tracking** to ensure policies and procedures are reviewed regularly.  

| Did you know that when you use [Document distributions](https://docs.brainframe.com/en/article/document-distribution-1k2gqwz/) or [Notify external contacts](https://docs.brainframe.com/en/article/send-to-external-contacts-kyxang/), your external contacts can also leave comments on the documents, which you will see in the comments section

---

### **🎯 Visual Checklist**  
* [x] Activities tab opened  
* [x] First comment added  
* [ ] Tasks or risk readings created from activity view  
* [ ] Document review marked as complete  
* [ ] External contact comments reviewed