Task Comments

Comments are the primary way to communicate about tasks with your team. Use them to ask questions, share updates, document decisions, and collaborate effectively.

Why Use Comments

Comments help you:

• Communicate with team members about the task
• Document decisions and discussions
• Ask questions and get answers
• Update stakeholders on progress
• Create an audit trail of communication

Adding Comments

From Task Details

Quick Comment

Some views allow quick commenting:

1. Click the comment icon on a task
2. Type your comment
3. Post without opening full details

Mentioning Team Members

How to Mention

Use @ to mention team members:

• Type @ followed by their name
• Select from the dropdown
• They receive a notification

Example

@sarah Can you review this before I mark it complete?

Who Gets Notified

When you @mention:

• The mentioned person receives a notification
• Email and/or in-app notification (based on settings)
• They can click to go directly to the comment

Formatting Comments

Basic Formatting

Comments support basic markdown:

Lists

Create bulleted lists:

- Item one
- Item two
- Item three

Code Blocks

For longer code:

code here

Comment Types

Status Updates

Share progress:

Update: Completed the first draft. Moving to internal review next.

Questions

Ask for clarification:

@john I'm not sure about the encryption requirements for this control. Can you clarify?

Answers

Respond to questions:

@sarah The encryption requirement is AES-256 for data at rest. Let me know if you need more details.

Decisions

Document decisions made:

Decision: After discussion with legal team, we're proceeding with Option B for the privacy policy update.

Blockers

Communicate issues:

Blocked: Waiting on vendor to provide security questionnaire responses. Following up tomorrow.

Viewing Comments

Comment Thread

Comments appear in chronological order:

• Oldest at top (or newest, depending on settings)
• Each shows author, timestamp, and content
• Threaded replies (if available)

Comment Count

Task cards show comment count:

• 💬 3 indicates 3 comments
• Helps identify active discussions

Editing Comments

Edit Your Own

To edit a comment you wrote:

1. Find your comment
2. Click the edit icon (✏️)
3. Modify the text
4. Save changes

Edit Window

Editing may be time-limited:

• Often editable for 15-30 minutes
• After that, you may need to add a new comment
• Edit history may be preserved

Deleting Comments

Delete Your Own

To delete a comment:

1. Find your comment
2. Click the delete icon (🗑️)
3. Confirm deletion

Comment Notifications

When You're Notified

You receive notifications when:

• Someone comments on your task
• Someone @mentions you
• Someone replies to your comment
• (Based on your notification settings)

Managing Notifications

Configure in Settings > Notifications:

• Enable/disable comment notifications
• Choose email vs. in-app
• Set digest frequency

Best Practices

Be Clear and Specific

Good:

The access review procedure needs to include quarterly reviews per SOC 2 CC6.1. I've drafted this in sections 3.2-3.4.

Not as helpful:

Updated the doc.

Use @mentions Purposefully

• Mention when you need someone's attention
• Don't mention everyone unnecessarily
• Use for specific questions or handoffs

Document Decisions

Record important decisions in comments:

• What was decided
• Who was involved
• Why the decision was made
• Any follow-up actions

Keep It Professional

Comments are part of the audit trail:

• Stay professional and constructive
• Focus on the work
• Avoid sensitive personal information

Searching Comments

Finding Comments

Search across all comments:

1. Use the search bar
2. Include keywords from comments
3. Results include matching comments

Filter by Commenter

Some views allow filtering by who commented:

• See all comments from a specific person
• Track your own comment history

Comments vs. Notes

Use comments for collaboration, notes for personal tracking.

Common Patterns

Handoff Comments

When passing work to someone:

@lisa I've completed the initial assessment. Ready for your review. Key findings in the attached document.

Completion Comments

When finishing a task:

Completed. Updated the access control policy to include:
- Quarterly access reviews
- Approval workflow for privileged access
- Attestation requirements

Document uploaded as evidence.

Question and Answer

@mike What's the deadline for this policy update?

Reply from Mike:
@alex We need this done by end of month for the SOC 2 audit. Let me know if you need more time.

Common Questions

Can I comment on completed tasks?

Yes, you can add comments to completed tasks. This is useful for:

• Follow-up notes
• Questions after the fact
• Audit documentation

Are comments visible to auditors?

Yes. Comments are part of the compliance record and can be reviewed during audits.

Can I disable comments on a task?

Generally no. Comments are integral to collaboration. You can:

• Not use them (but can't prevent others)
• Archive tasks to reduce activity

How do I reply to a specific comment?

If threaded replies are available:

1. Click "Reply" on the specific comment
2. Your reply is nested under it

Otherwise, @mention the person and quote or reference their comment.

Next Steps

• Task Actions - Different task types
• Updating Tasks - Change task properties
• Task Views - Organize your tasks