Activity and Comments

Track document history and collaborate with your team through inline comments and issue marking.

Activity Tracking

The Documents app automatically tracks changes to your documents:

Activity Types

Event	Description
Created	Document was initially created
Updated	Content was modified
Renamed	Document name changed
Moved	Document relocated to different folder
Version Saved	New version was published
Access Updated	Permissions were modified
Duplicated	Document was duplicated
Variant Created	Variant was created from this document

Where Activity Surfaces

There is no document-level activity feed inside the right panel. Tracked changes surface through the workspace's notification center and your personal activity feed. To review a document's version history, use the History tab in the right panel; per-issue discussion history appears inside each issue card's comment thread (see below).

Inline Issue Marking

The Documents app integrates deeply with Issues, allowing you to mark text directly in your documents as comments, tasks, or risks.

Creating Issue Marks

1. Select text in the document
2. Use the formatting toolbar buttons that appear:
   • Comment button (speech bubble) - Create a comment
   • Task button (checkbox) - Create a task
   • Risk button (warning) - Create a risk
3. Fill in the issue details in the panel
4. Click Create

Alternatively, select text and right-click to access the context menu with issue marking options.

The selected text is highlighted with a color indicating the issue type:

Type	Color	Purpose
Comment	Yellow	Annotations, notes, questions
Task	Blue	Action items that need to be completed
Risk	Red	Potential issues or concerns

Working with Issue Marks

• Click a mark to view the linked issue in the right panel
• Hover over a mark to see a preview of the issue
• Issues tab shows all issues linked to the current document
• Filter by type to see only comments, tasks, or risks

Issue Lifecycle

1. Create an issue mark by selecting text
2. The issue appears in the Comments & Issues tab
3. Team members can comment on and update the issue
4. Mark the issue as resolved when complete
5. The text highlight updates to show resolved status

Comments & Issues Tab

The Comments & Issues tab in the right panel provides a unified view of all document feedback:

Tab Features

Feature	Description
Issue List	All issues linked to the document
Type Filter	Filter by comment, task, or risk
Status Filter	Show open, resolved, or all issues
Click to Navigate	Click an issue to scroll to its location in the document
Quick Actions	Resolve or edit issues directly from the list
Create Issue	Add new issues directly from the panel

Adding Comments to Issues

Each issue can have its own comment thread:

1. Click on an issue card to expand it
2. View existing comments in the activity feed
3. Add a new comment using the text field
4. Comments support @mentions for team members

Collaboration Features

Mentions

Mention team members in comments to notify them:

1. Type @ followed by their name
2. Select from the dropdown
3. They receive a notification

Subscriptions

Stay informed about document changes:

• Document owners are automatically subscribed
• Users who comment become subscribers
• Subscribers receive notifications for new comments and changes

Notification Behavior

When you're mentioned or subscribed to a document:

• In-app notifications appear in the notification center
• Email notifications (based on your settings)
• Activity appears in your personal activity feed

Best Practices

• Use issue marks for actionable feedback that needs tracking
• Use comments for general discussions and notes
• Mention team members who need to take action
• Resolve issues promptly to keep the document clean
• Reference version numbers when discussing specific content
• Keep comments focused and actionable

Next Steps

• Document Details - Learn about the editor
• Tips for Success - Collaboration best practices