Comments

​

How Comments Work

• Threaded replies: Nest responses to create organized conversations
• Rich formatting: Support for text formatting, links, code, and mentions
• Voting: Upvote/downvote comments to surface the best input
• Mentions: Tag team members or users for notifications
• Moderation: Review, edit, delete, or hide inappropriate comments
• Notifications: Alert participants when discussions evolve

​

Commenting on Posts

​

User Experience

1. Comment form: Text area at the top or bottom of the post
2. Existing comments: Threaded list of all comments
3. Reply buttons: Nested reply functionality
4. Vote buttons: Upvote/downvote on comments (if enabled)
5. Action menu: Edit, delete, report options

​

Writing Comments

• Bold, italic, strikethrough
• Links
• Inline code
• Bulleted lists

​

Replying to Comments

1. Click “Reply” on any comment
2. Write your response
3. Submit to create a nested reply
4. Replies are indented and connected to parent comments

​

Anonymous Comments

• Users can comment without logging in
• Provide name and email (optional)
• Tracked via browser fingerprint
• Subject to same moderation rules

​

Comment Features

​

Voting on Comments

• Moves helpful comments to the top
• Rewards thoughtful contributions
• Surfaces best use cases or requirements

• Can be disabled if community prefers positive-only
• Helps bury spam or off-topic comments
• May discourage participation if overused

• Highest voted first
• Newest first
• Oldest first
• Threaded (grouped by conversation)

​

Mentions & Notifications

• Team members in your workspace
• Other users who have commented
• Post authors

• In-app notification
• Email notification (if enabled)
• Badge on notification icon

• Create a post
• Comment on a post
• Are mentioned in a comment
• Vote on a post

​

Editing Comments

• Click the edit icon on your comment
• Make changes
• Save to update
• “Edited” badge appears with timestamp

• View previous versions of edited comments
• Useful for moderation and abuse prevention
• Only visible to workspace moderators

​

Deleting Comments

• Delete your own comments anytime
• Replies are preserved but show “[deleted]” as parent
• Cannot delete if others have replied (soft delete instead)

• Permanently remove spam or inappropriate comments
• Option to delete entire thread (comment + all replies)
• Bulk delete for cleanup

​

Comment Moderation

​

Moderation Queue

• Auto-approved: Trusted users post immediately (default)
• Pending approval: New/anonymous users require review
• Flagged: User-reported comments await moderator action

​

Comment Status

​

Reporting Comments

• Spam
• Harassment
• Inappropriate content
• Off-topic
• Other (with description)

1. Receive report notification
2. Review reported comment and context
3. Take action:
   • Dismiss report (comment is fine)
   • Hide comment
   • Delete comment
   • Ban user (severe cases)
4. Notify reporter of outcome

​

Moderator Tools

• Team responses with answers
• Important clarifications
• Official statements

• Visible only to workspace members
• Useful for internal notes or discussions
• Helps coordinate team response

• After question is answered
• When discussion goes off-topic
• To close resolved issues

​

Comment Notifications

​

User Notifications

• Someone replies to their comment
• Someone mentions them
• Someone comments on a post they authored
• A comment they voted on gets a response
• Moderator takes action on their comment

​

Team Notifications

• They’re mentioned in a comment
• Comments are posted on their assigned posts
• Comments require moderation
• Reports are submitted

​

Notification Channels

• In-app: Badge and notification center
• Email: Immediate or digest
• Slack (integration): Channel notifications
• Webhook: Custom integrations

​

Comment Settings

​

Board-Level Settings

​

Workspace-Level Settings

​

Comment Use Cases

​

Gathering Requirements

• “What’s your specific use case for this?”
• “How would you expect this to work?”
• “What alternatives have you tried?”

​

Building Consensus

• Propose implementation approaches
• Gather feedback on mockups or prototypes
• Vote on different solution options
• Identify edge cases and concerns

​

Providing Updates

• “We’re starting work on this next week”
• “Here’s a preview of the design”
• “This shipped in v2.1 - try it out!”
• “We decided not to pursue this because…”

​

Customer Support

• Clarify feature requests
• Explain technical constraints
• Suggest workarounds
• Link to documentation

​

Internal Comments

• Discuss implementation strategy
• Estimate effort and complexity
• Assign ownership
• Leave notes for other team members

• Only visible to workspace members
• Hidden from public users
• Marked with “Internal” badge

• Engineering feasibility discussions
• Priority debates
• Customer context (“This is from a $50K/year customer”)
• Implementation notes

​

Comment Analytics

• Total comments per day/week/month
• Comments per post average
• Most-commented posts

• Percentage of users who comment
• Top commenters
• Team response rate

• Average time to first team response
• Median response time
• Posts without team responses

• Positive vs. negative language
• Feature enthusiasm indicators
• Frustration signals

​

Best Practices

​

Comment Formatting

​

Markdown Support

**Bold** and *italic* text

[Link text](https://example.com)

`inline code`

- Bullet points
- Another point

1. Numbered lists
2. Second item

​

Code Blocks

```javascript
const example = "code block";
console.log(example);

Syntax highlighting makes technical discussions clearer.

### Mentions Syntax

```markdown
@username - mention a user
@team - mention entire team (if enabled)

​

Integrations

​

Slack

• New comments on watched posts
• Mentions of team members
• Moderation alerts

​

Email

• Comment replies
• Mentions
• Daily/weekly digests

​

Webhooks

• CRM updates (log customer feedback)
• Analytics platforms (track engagement)
• Custom integrations

​

Next Steps

• Enable comments on Feedback Boards
• Use comments to gather requirements for Roadmap items
• Announce shipped features in Changelogs
• Encourage Voting on valuable comments