Comments & Discussions
Collaborate effectively with your team using comments, threaded discussions, @mentions, and reactions. Keep all feedback in context with the work.
Overview#
Comments are the foundation of collaboration in PromptReports. They allow team members to provide feedback, ask questions, document decisions, and discuss changes—all directly in context with the prompts, versions, and reports they're working on.
Contextual Feedback
Comments appear exactly where they're relevant—on specific lines, versions, or prompts.
Threaded Discussions
Keep conversations organized with threaded replies that don't clutter the main view.
@Mentions
Notify specific team members when you need their attention or expertise.
Real-Time Notifications
Stay informed about activity on comments you've created or been mentioned in.
Comment Types#
PromptReports supports several types of comments to fit different collaboration needs:
| Comment Type | Location | Best Use Case |
|---|---|---|
| Version Comments | On a specific prompt version | Discuss changes in a particular version, request changes before approval |
| Inline Comments | On specific lines within a prompt | Provide precise feedback on wording, variables, or specific sections |
| Prompt Comments | General prompt-level discussion | High-level discussion about the prompt's purpose, strategy, or direction |
| Folder Comments | On prompt folders | Discuss organizational decisions, folder-wide policies, or team announcements |
| Report Comments | On generated reports | Feedback on report outputs, quality issues, or suggested improvements |
Choosing the Right Comment Type
Adding Comments#
Adding comments is quick and intuitive:
Select the location
For version/prompt comments: Click the "Comments" tab or button in the interface.
Write your comment
- Use Markdown for formatting (bold, italic, code blocks, lists)
- @mention teammates by typing @ followed by their name
- Reference other prompts or versions with # shortcuts
Submit your comment
**Important:** This variable should use snake_case.
Consider changing:
```
{{customerName}}
```
to:
```
{{customer_name}}
```
@sarah can you review this change? See related discussion in #customer-prompts/greeting-v2@Mentions#
@mentions notify specific people and draw their attention to important discussions:
Individual Mentions
Type @name to mention a specific person. They'll receive a notification.
Team Mentions
Use @team-name to notify everyone in a team (e.g., @engineering, @reviewers).
| Mention Type | Syntax | Who Gets Notified |
|---|---|---|
| Individual | @username | The specific user mentioned |
| Team | @team-name | All members of the specified team |
| Approvers | @approvers | All users with approval permissions for the folder |
| Watchers | @watchers | All users watching this prompt or folder |
Autocomplete
Thread Discussions#
Keep conversations organized with threaded discussions:
Reply to a comment
View thread details
Resolve threads
Re-open if needed
Unresolved Filter
Filter to show only unresolved threads to see what still needs attention.
Search Threads
Search through all comments and threads to find past discussions.
Reactions#
Quick reactions let you acknowledge comments without adding clutter:
| Reaction | Meaning | Common Use |
|---|---|---|
| 👍 | Agree / Approve | Quick acknowledgment that you've seen and agree |
| ❤️ | Love it | Strong positive feedback |
| 🎉 | Celebrate | Congratulate on good work or a milestone |
| 👀 | Looking into it | Acknowledge you've seen it and will investigate |
| 🤔 | Thinking / Unsure | Indicates uncertainty or need for more consideration |
| 👎 | Disagree | Respectful disagreement (consider adding a comment to explain) |
Click the emoji button on any comment to add a reaction, or hover to see all reactions that have been added. Click on an existing reaction to add yours to that count.
Managing Comments#
You have several options for managing your comments and organizing discussions:
Edit Comments
Edit your own comments at any time. An 'edited' indicator shows the comment was modified.
Delete Comments
Delete your comments. Admins can delete any comment if necessary.
Pin Important Comments
Pin comments to the top of the discussion so they're always visible.
Lock Discussions
Admins can lock discussions to prevent further comments when needed.
Deleted Comments
Notifications#
Stay informed about comment activity without being overwhelmed:
| Notification Type | When You Receive It | How to Manage |
|---|---|---|
| @Mentioned | Someone mentions you in a comment | Always on, cannot disable |
| Reply to Your Comment | Someone replies to your comment | Toggle in notification settings |
| Thread Activity | Activity on threads you've participated in | Toggle per-thread or globally |
| Watched Prompt | Any comment on a prompt you're watching | Add/remove watch per prompt |
| Approval Requests | Comment accompanies an approval request | Always on for approvers |
Configure notification preferences
Watch specific prompts
Mute noisy threads
Best Practices#
Be Specific
Reference specific lines or sections. Vague comments are harder to address.
Be Constructive
Explain why something should change and suggest alternatives when possible.
Use Threads
Keep related discussion in threads to avoid cluttering the main comment stream.
Mention Thoughtfully
Only @mention people who need to see the comment. Avoid excessive notifications.
Document Decisions
Comment Etiquette:
- Acknowledge good work—positive feedback is valuable too
- Ask clarifying questions before assuming something is wrong
- Resolve threads promptly once the issue is addressed
- Keep discussions professional and focused on the work
- Use reactions for simple acknowledgments to reduce noise