Communication
Comments, mentions, and best practices for keeping work aligned.
Overview
Communication features keep decisions and next steps inside the work item.
They reduce ambiguity during handoffs and governance reviews.
Key Concepts
Comment: discussion and decision trail attached to an item
@mention: notification signal to a specific Teammate
Link: reference to related items for context reuse
How It’s Used
Use comments for questions, clarifications, and approvals.
Use @mentions when a specific response or action is needed.
Benefits
Cleaner decision trail
Less context loss across teams
Faster review cycles
Setup Steps
Common places comments appear:
requirements
tasks
tests
artifacts (when supported)
Start here:
Best Practices
Ask one question per comment.
Quote the exact requirement or task under discussion.
Summarize decisions in one line using
Decision:.Link related work instead of copying long text.
Summary
Related:
Last updated