Comments & Activities
Collaborate on tasks with comments, track changes with activity feeds, and stay informed with notifications
Comments and activity feeds keep your team aligned on task progress. Leave feedback, ask questions, and track every change with comprehensive activity logs.
Prerequisites
To use comments and activities, you need:
- Active Verk account
- Access to at least one task or project
- Notification preferences configured (optional)
Add comments
Leave comments on tasks to communicate with your team:
Quick comment
Add a simple comment:
- Open any task
- Scroll to the Comments section
- Type your comment in the text box
- Press
Cmd/Ctrl + Enterto post - Or click Comment button
Use @mentions in comments to notify specific team members and ensure they see your message.
Rich text comments
Format comments with rich text:
Formatting options:
- Bold -
**text**orCmd/Ctrl + B - Italic -
*text*orCmd/Ctrl + I Code-`code`orCmd/Ctrl + E- Links -
[text](url) - Lists - Start line with
-or1. - Headings - Start line with
#,##, or### - Quotes - Start line with
>
Example formatted comment:
**Update on design review:**
Completed initial review with these findings:
1. Homepage layout looks great
2. Need to adjust mobile spacing
3. Color contrast needs improvement
> "The new design direction is exactly what we needed!" - Client feedback
Next steps:
- [ ] Update mobile responsive styles
- [ ] Adjust color palette for accessibility
- [ ] Schedule follow-up review
@designer @developer - please review
Attach files
Add files to comments for context:
Upload methods:
- Drag and drop files into comment box
- Click paperclip icon to browse files
- Paste images directly from clipboard
- Reference existing task attachments
Supported file types:
- Images (JPG, PNG, GIF, SVG)
- Documents (PDF, DOC, DOCX, XLS, XLSX)
- Code files with syntax highlighting
- Videos (MP4, MOV, WEBM)
- Archives (ZIP, RAR)
Mention team members
Notify specific people with @mentions:
- Type
@in comment box - Start typing team member's name
- Select from autocomplete dropdown
- Mentioned person receives notification
Mention types:
@username- Notify individual team member@team-name- Notify entire team@assignee- Notify current task assignee@watchers- Notify all task watchers
Code snippets
Share code with proper syntax highlighting:
```javascript
function calculateTotal(items) {
return items.reduce((sum, item) => sum + item.price, 0);
}
```
Verk automatically detects language and applies syntax highlighting for better readability.
Comment threads
Keep discussions organized with threaded replies:
Create thread
Reply to specific comments:
- Hover over any comment
- Click Reply button
- Type your response
- Press
Cmd/Ctrl + Enterto post
Thread benefits:
- Keep related discussions together
- Reduce clutter in main comment stream
- Easier to follow specific conversations
- Resolve threads when complete
Resolve threads
Mark discussion threads as resolved:
- Complete the discussion
- Click Resolve thread button
- Thread collapses and shows "Resolved" badge
- Click badge to expand and view history
When to resolve:
- Question has been answered
- Issue has been addressed
- Decision has been made
- Discussion is no longer relevant
View resolved threads
Access previously resolved discussions:
- Click Show resolved toggle
- View all resolved thread history
- Click thread to expand
- Unresolve if needed to continue discussion
Reactions
React to comments quickly with emoji:
Add reaction
Express agreement or sentiment:
- Hover over comment
- Click emoji icon
- Select reaction from picker
- Or use emoji shortcode (
:thumbsup:,:heart:)
Common reactions:
- Agreement, acknowledgment
- Appreciation, thanks
- Humor, joy
- Celebration, milestone
- Ready to launch
- Reviewing, looking
- Completed, confirmed
- Question, clarification needed
Reaction counts
See who reacted:
- Hover over reaction to see names
- Click reaction to add yours
- Click your reaction to remove it
- Multiple people can use same reaction
Activity feed
Track all changes to tasks and projects:
View activity
Access the activity feed:
Task-level activity:
- Open any task
- Click Activity tab
- See chronological list of all changes
Project-level activity:
- Open project
- Click Activity in sidebar
- View all project and task updates
Organization activity:
- Navigate to Dashboard
- Click Activity Feed
- See workspace-wide updates
Activity types
The feed tracks these event types:
Activity details
Each activity entry shows:
- Who - User who made the change
- What - Type of change and details
- When - Timestamp of the change
- Where - Task/project affected
- Previous value - What changed from
- New value - What changed to
Example activity entry:
Sarah Johnson changed status from "In Progress" to "Done"
2 hours ago in Marketing Campaign
Filter activity
Narrow down activity feed:
Filter options:
- By user (show only specific person's actions)
- By action type (only status changes, comments, etc.)
- By date range (today, this week, custom range)
- By project or task
- By field type
Example filters:
- "Show only @john's changes this week"
- "Show only status changes in Marketing project"
- "Show all comments on this task"
Export activity
Download activity logs for reporting:
- Open activity feed
- Apply desired filters
- Click Export button
- Choose format (CSV, PDF, JSON)
- Download file
Use cases for exports:
- Audit trails for compliance
- Team productivity reports
- Project retrospectives
- Time tracking analysis
Notifications
Stay informed about task and project updates:
Notification triggers
Receive notifications when:
Task-related:
- You're mentioned in a comment
- Task assigned to you
- Task you're watching is updated
- Someone replies to your comment
- Due date approaching on your tasks
- Task status changes on watched tasks
Project-related:
- Added to new project
- Project deadline approaching
- Major project milestones reached
Team-related:
- Added to organization
- Role or permissions changed
- Team member requests feedback
Notification channels
Choose how you receive notifications:
In-app notifications:
- Red badge on notification bell
- Dropdown shows recent notifications
- Click to jump directly to task
Email notifications:
- Immediate emails for @mentions
- Daily digest of activity
- Weekly summary of updates
- Customize frequency in Settings
Browser push:
- Desktop notifications
- Appears even when Verk isn't open
- Enable in browser permissions
Mobile push:
- iOS and Android notifications
- Custom sounds and badges
- Quick actions from notification
Slack integration:
- Forward notifications to Slack DMs
- Post to channels based on project
- Customize message format
Configure notifications
Customize notification preferences:
- Navigate to Settings → Notifications
- Choose notification types:
- All activity
- Mentions only
- Assignments and due dates
- Custom selection
- Set channels (email, push, etc.)
- Configure frequency and timing
- Save preferences
Per-task notification settings:
- Watch task - Get all updates
- Mute task - No notifications
- Default - Follow global settings
Watch tasks you're actively involved in but not assigned to. This keeps you informed without cluttering your main task list.
Notification batching
Reduce notification fatigue:
Smart batching:
- Groups multiple updates together
- "5 new updates on Marketing Campaign"
- Click to see all changes at once
- Configurable delay (immediate, 15min, 1hr)
Digest mode:
- Single daily email with all updates
- Choose preferred time (e.g., 8am)
- Organized by project and priority
- Includes action items requiring response
Comment features
Edit comments
Modify comments after posting:
- Hover over your comment
- Click three-dot menu
- Select Edit
- Make changes
- Press
Cmd/Ctrl + Enterto save - Comment shows "edited" indicator
Edit restrictions:
- Can only edit your own comments
- Admins can edit any comment
- Edit history preserved (view in menu)
- Original timestamp maintained
Delete comments
Remove comments if needed:
- Hover over your comment
- Click three-dot menu
- Select Delete
- Confirm deletion
Deletion notes:
- Can only delete your own comments
- Admins can delete any comment
- Deletion is permanent
- Shows "Comment deleted" placeholder
- Replies to deleted comments remain
Pin comments
Highlight important comments:
- Hover over comment
- Click pin icon
- Comment moves to top of list
- Shows pinned indicator
Good uses for pinning:
- Key decisions
- Final requirements
- Important updates
- Action item summaries
Copy comment link
Share specific comments:
- Hover over comment
- Click three-dot menu
- Select Copy link
- Paste link to jump directly to comment
Watch tasks
Follow tasks without being assigned:
Add watchers
Track task progress:
Become a watcher:
- Open task
- Click Watch button
- Receive notifications on updates
Add others as watchers:
- Open task
- Click Add watchers
- Select team members
- They receive notification of watch
Remove watchers:
- Click Unwatch for yourself
- Admin can remove any watcher
Watcher notifications
Control what watchers see:
Automatic notifications for:
- Status changes
- New comments
- Assignment changes
- Due date updates
- Major field changes
Watcher preferences:
- Customize per task
- Follow global notification settings
- Mute specific update types
Activity insights
Analyze team activity patterns:
Activity metrics
View activity statistics:
Task-level metrics:
- Total comments
- Number of watchers
- Edit count
- Time in each status
- Resolution time
User-level metrics:
- Comments per day/week
- Tasks updated
- Response time
- Most active hours
- Collaboration score
Project-level metrics:
- Total activity volume
- Most active tasks
- Busiest team members
- Activity trends over time
Activity timeline
Visualize project progress:
- See activity density over time
- Identify busy periods
- Spot inactive periods
- Compare team member contributions
Troubleshooting
Missing notifications
If not receiving notifications:
- Check notification settings in profile
- Verify email address is correct
- Check spam/junk folder for emails
- Enable browser notifications
- Check task watch status
- Review notification filters
Can't see activity
If activity feed is empty:
- Check filter settings
- Verify date range
- Confirm project access
- Try refreshing page
- Check if activities were deleted
- Contact admin if persistent
Comments not saving
If comments won't post:
- Check internet connection
- Verify comment isn't empty
- Check for valid formatting
- Try removing special characters
- Refresh and try again
- Contact support if continues
Notification overload
Too many notifications:
- Switch to digest mode
- Reduce watched tasks
- Unwatch less important projects
- Use custom notification rules
- Mute specific types
- Set quiet hours in preferences
Best practices
Effective commenting
Write clear comments:
- Provide context and background
- Be specific about issues or questions
- Use formatting for clarity
- Attach relevant files or screenshots
- Reference other tasks when needed
Example good comment:
**Issue with mobile navigation**
On iPhone 12 (iOS 16), the hamburger menu doesn't open when tapped.
Steps to reproduce:
1. Open site on mobile Safari
2. Tap menu icon in header
3. Nothing happens
Expected: Menu should slide in from left
Screenshot attached showing the issue.
@developer Can you investigate?
Mention etiquette
Use mentions thoughtfully:
- Only @mention when input is needed
- Don't overuse @channel or @everyone
- Provide context for why you're mentioning
- Give people time to respond
- Use @team for group questions
Activity hygiene
Keep activity feed useful:
- Resolve completed threads
- Archive old completed tasks
- Remove unnecessary watchers
- Clean up duplicate comments
- Pin important updates
Notification management
Avoid notification fatigue:
- Watch only relevant tasks
- Use smart batching
- Set up digest emails
- Configure quiet hours
- Customize per project
Common use cases
Design feedback
Gather design review comments:
Process:
- Attach design mockups to task
- @mention design reviewers
- Use threaded comments for each section
- React with for approved elements
- Resolve threads when changes made
- Final approval comment when complete
Code review
Review code changes in tasks:
Workflow:
- Link GitHub PR in task comment
- @mention code reviewers
- Discuss changes in threaded comments
- Use code snippets for suggestions
- Mark thread resolved when addressed
- Comment final approval
Sprint retrospective
Use activity feed for retrospectives:
Steps:
- Export activity for sprint period
- Filter by project and team
- Review completed tasks
- Analyze blocked tasks
- Identify patterns
- Comment learnings on retrospective task
Customer support
Track support ticket progress:
Support workflow:
- Create task from customer email
- Assign to support rep
- Rep comments with investigation notes
- @mention specialists for complex issues
- Update customer via email integration
- Resolve thread when ticket closed
- Activity log provides complete history