> ## Documentation Index
> Fetch the complete documentation index at: https://pulze.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments & Collaboration

> Collaborate with team members using comments

## Overview

Comments in Pulze enable team collaboration on AI conversations. Add comments to specific messages, discuss responses, and collaborate with team members directly within conversation threads.

## Adding Comments

### Comment on Messages

To add a comment to a message:

1. Click the comment icon on any message
2. A comment panel opens on the right
3. Type your comment in the text area
4. Click **"Save"** or press Enter to post
5. The comment appears in the thread

### Comment Interface

The comment panel displays:

* **Comment Input** - Text area for new comments
* **Existing Comments** - Thread of all comments on the message
* **User Avatars** - Profile pictures of commenters
* **Timestamps** - When each comment was posted
* **Comment Actions** - Edit, delete, or reply options

## Viewing Comments

### Comment Indicators

Messages with comments show:

* Comment icon with count badge
* Number of comments on the message
* Visual indicator that discussion exists

### Opening Comment Threads

Click the comment icon to:

* View all comments on a message
* See comment history
* Add new comments
* Respond to existing comments

### Comment Panel

The comment panel features:

* **Scrollable Thread** - All comments in chronological order
* **New Comment Input** - Always available at top
* **Close Button** - Hide the panel when done
* **Context Retention** - Stays open while you work

## Comment Features

### Rich Text Comments

Comments support:

* Plain text
* Basic formatting
* Multiple lines
* Markdown (depending on configuration)

### Comment Actions

For each comment, you can:

* **Edit** - Modify your own comments
* **Delete** - Remove your comments
* **Reply** - Respond to specific comments (creates threaded discussion)
* **React** - Add reactions or acknowledgments (if enabled)

### Comment Threads

Create threaded discussions:

* Reply to specific comments
* Build conversation threads
* Track discussion flow
* Maintain context

## Collaboration Workflow

### Team Discussion

Use comments to:

* **Ask Questions** - Clarify assistant responses
* **Provide Feedback** - Share thoughts on outputs
* **Suggest Improvements** - Recommend changes
* **Document Decisions** - Record why certain approaches were chosen
* **Share Insights** - Highlight interesting findings

### Review Process

Implement review workflows:

1. AI assistant generates response
2. Team member adds comment with feedback
3. Another member reviews and comments
4. Iterate based on feedback
5. Mark as approved when satisfied

## Notifications

### Comment Alerts

Stay informed about comments:

* Notification when someone comments on your messages
* Alerts for replies to your comments
* Mentions in comments (if supported)
* Updates to tracked conversations

### Managing Notifications

Control comment notifications:

* Enable/disable notifications
* Set notification preferences
* Choose notification channels
* Manage alert frequency

## Comment Management

### Editing Comments

Modify your comments:

1. Click edit icon on your comment
2. Update the text
3. Save changes
4. Edit timestamp displayed
5. Original preserved in history (depending on settings)

### Deleting Comments

Remove comments:

1. Click delete icon
2. Confirm deletion
3. Comment removed from thread
4. Action may be logged

<Warning>
  Deleted comments cannot be recovered. Consider editing instead if you want to preserve the discussion history.
</Warning>

### Comment History

Track comment changes:

* View edit history (if enabled)
* See who made changes
* Track discussion evolution
* Maintain transparency

## Privacy and Permissions

### Who Can Comment

Comment access based on:

* Space membership
* Permission level
* Conversation access
* Organization policies

### Visibility

Comments are visible to:

* All space members with conversation access
* Users with appropriate permissions
* Respects space privacy settings
* Subject to data governance rules

### Comment Permissions

Different permission levels may:

* View comments
* Add new comments
* Edit own comments
* Delete own comments
* Moderate comments (admins)

## Use Cases

### Code Review

Use comments for:

* Reviewing generated code
* Suggesting improvements
* Discussing implementation
* Documenting decisions

### Content Creation

Collaborate on:

* Marketing copy
* Documentation
* Blog posts
* Reports

### Problem Solving

Discuss:

* Solution approaches
* Alternative strategies
* Trade-offs
* Best practices

### Knowledge Sharing

Use comments to:

* Explain context
* Share related information
* Link to resources
* Document learnings

## Best Practices

<Tip>
  **Be Specific**: Reference exact parts of the message when commenting for clarity.
</Tip>

<Tip>
  **Stay Constructive**: Focus comments on improving outcomes and collaboration.
</Tip>

<Tip>
  **Timely Responses**: Respond to comments promptly to maintain momentum.
</Tip>

<Tip>
  **Clear Communication**: Write clear, concise comments that others can easily understand.
</Tip>

<Tip>
  **Tag Context**: Mention relevant team members or reference related conversations.
</Tip>

## Comment Organization

### Chronological Order

Comments display:

* Most recent at bottom (or top, depending on configuration)
* Timestamps for all comments
* Clear indication of comment age
* Easy to follow conversation flow

### Threading

Organize discussions:

* Main comments on message
* Replies create sub-threads
* Nested conversations
* Clear parent-child relationships

### Filtering Comments

Find specific comments:

* Search comment content
* Filter by author
* Sort by date
* Show/hide resolved

## Integration Features

### Message Context

Comments maintain context:

* Linked to specific messages
* Preserve message content reference
* Show associated conversation
* Track related discussions

### Cross-References

Comments can reference:

* Other messages in conversation
* Related documents
* External resources
* Team members (mentions)

## Collaboration Patterns

### Async Collaboration

Enable asynchronous work:

* Team members comment at different times
* Build consensus gradually
* Document thought process
* Maintain discussion history

### Real-Time Discussion

Support synchronous collaboration:

* Multiple users commenting simultaneously
* Live updates
* Immediate feedback
* Dynamic conversations

### Decision Documentation

Record decisions in comments:

* Why certain approaches chosen
* Trade-offs considered
* Alternatives discussed
* Final conclusions

## Mobile and Accessibility

### Mobile Comments

Comment features on mobile:

* Full comment functionality
* Touch-optimized interface
* Easy scrolling and navigation
* Notification support

### Accessibility

Ensure comments are accessible:

* Keyboard navigation support
* Screen reader compatible
* Clear focus indicators
* Accessible color contrast

## Troubleshooting

### Comments Not Appearing

If comments don't show:

1. Verify space permissions
2. Check conversation access
3. Refresh the page
4. Clear browser cache
5. Check notification settings

### Can't Add Comments

If unable to comment:

1. Verify you have comment permissions
2. Check space membership
3. Confirm conversation isn't locked
4. Review permission level
5. Contact space admin if needed

### Lost Comments

If comments disappear:

1. Check if message was deleted
2. Verify you're viewing correct conversation
3. Check filter settings
4. Confirm comment wasn't deleted
5. Contact support if issue persists

## Export and Reporting

### Export Conversations with Comments

When exporting conversations:

* Include all comments
* Preserve comment threads
* Show timestamps and authors
* Maintain formatting

### Comment Analytics

Track collaboration metrics:

* Number of comments per conversation
* Most discussed messages
* Active collaborators
* Comment frequency trends

## Security and Compliance

### Comment Audit

Comments provide audit trail:

* Who commented when
* What was discussed
* Decision documentation
* Change history

### Data Retention

Comment storage follows:

* Organization policies
* Data retention requirements
* Compliance regulations
* Privacy laws

### Export for Compliance

Export comments for:

* Audit requirements
* Legal discovery
* Compliance reporting
* Record keeping

<CardGroup cols={2}>
  <Card title="Chat Interface" icon="messages" href="/pulze/conversations/chat-interface">
    Back to Chat Interface
  </Card>

  <Card title="Message History" icon="clock-rotate-left" href="/pulze/conversations/message-history">
    View Message History
  </Card>

  <Card title="References & Sources" icon="book" href="/pulze/conversations/references-sources">
    View Sources
  </Card>
</CardGroup>
