Verk

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:

  1. Open any task
  2. Scroll to the Comments section
  3. Type your comment in the text box
  4. Press Cmd/Ctrl + Enter to post
  5. 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** or Cmd/Ctrl + B
  • Italic - *text* or Cmd/Ctrl + I
  • Code - `code` or Cmd/Ctrl + E
  • Links - [text](url)
  • Lists - Start line with - or 1.
  • 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:

  1. Type @ in comment box
  2. Start typing team member's name
  3. Select from autocomplete dropdown
  4. 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:

  1. Hover over any comment
  2. Click Reply button
  3. Type your response
  4. Press Cmd/Ctrl + Enter to 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:

  1. Complete the discussion
  2. Click Resolve thread button
  3. Thread collapses and shows "Resolved" badge
  4. 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:

  1. Click Show resolved toggle
  2. View all resolved thread history
  3. Click thread to expand
  4. Unresolve if needed to continue discussion

Reactions

React to comments quickly with emoji:

Add reaction

Express agreement or sentiment:

  1. Hover over comment
  2. Click emoji icon
  3. Select reaction from picker
  4. 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:

  1. Open any task
  2. Click Activity tab
  3. See chronological list of all changes

Project-level activity:

  1. Open project
  2. Click Activity in sidebar
  3. View all project and task updates

Organization activity:

  1. Navigate to Dashboard
  2. Click Activity Feed
  3. See workspace-wide updates

Activity types

The feed tracks these event types:

Task Created
New task added to project
Status Changed
Task moved between columns
Assigned
Task assigned to team member
Priority Updated
Priority level changed
Due Date Set
Deadline added or modified
Field Updated
Custom field values changed
Comment Added
New comment posted
File Attached
File uploaded to task
Subtask Created
Subtask added to parent
Label Added
Label applied to task
Task Completed
Task marked as done
Task Deleted
Task removed from project

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:

  1. Open activity feed
  2. Apply desired filters
  3. Click Export button
  4. Choose format (CSV, PDF, JSON)
  5. 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:

  1. Navigate to SettingsNotifications
  2. Choose notification types:
  • All activity
  • Mentions only
  • Assignments and due dates
  • Custom selection
  1. Set channels (email, push, etc.)
  2. Configure frequency and timing
  3. 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:

  1. Hover over your comment
  2. Click three-dot menu
  3. Select Edit
  4. Make changes
  5. Press Cmd/Ctrl + Enter to save
  6. 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:

  1. Hover over your comment
  2. Click three-dot menu
  3. Select Delete
  4. 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:

  1. Hover over comment
  2. Click pin icon
  3. Comment moves to top of list
  4. Shows pinned indicator

Good uses for pinning:

  • Key decisions
  • Final requirements
  • Important updates
  • Action item summaries

Share specific comments:

  1. Hover over comment
  2. Click three-dot menu
  3. Select Copy link
  4. Paste link to jump directly to comment

Watch tasks

Follow tasks without being assigned:

Add watchers

Track task progress:

Become a watcher:

  1. Open task
  2. Click Watch button
  3. Receive notifications on updates

Add others as watchers:

  1. Open task
  2. Click Add watchers
  3. Select team members
  4. 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:

  1. Check notification settings in profile
  2. Verify email address is correct
  3. Check spam/junk folder for emails
  4. Enable browser notifications
  5. Check task watch status
  6. Review notification filters

Can't see activity

If activity feed is empty:

  1. Check filter settings
  2. Verify date range
  3. Confirm project access
  4. Try refreshing page
  5. Check if activities were deleted
  6. Contact admin if persistent

Comments not saving

If comments won't post:

  1. Check internet connection
  2. Verify comment isn't empty
  3. Check for valid formatting
  4. Try removing special characters
  5. Refresh and try again
  6. Contact support if continues

Notification overload

Too many notifications:

  1. Switch to digest mode
  2. Reduce watched tasks
  3. Unwatch less important projects
  4. Use custom notification rules
  5. Mute specific types
  6. 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:

  1. Attach design mockups to task
  2. @mention design reviewers
  3. Use threaded comments for each section
  4. React with for approved elements
  5. Resolve threads when changes made
  6. Final approval comment when complete

Code review

Review code changes in tasks:

Workflow:

  1. Link GitHub PR in task comment
  2. @mention code reviewers
  3. Discuss changes in threaded comments
  4. Use code snippets for suggestions
  5. Mark thread resolved when addressed
  6. Comment final approval

Sprint retrospective

Use activity feed for retrospectives:

Steps:

  1. Export activity for sprint period
  2. Filter by project and team
  3. Review completed tasks
  4. Analyze blocked tasks
  5. Identify patterns
  6. Comment learnings on retrospective task

Customer support

Track support ticket progress:

Support workflow:

  1. Create task from customer email
  2. Assign to support rep
  3. Rep comments with investigation notes
  4. @mention specialists for complex issues
  5. Update customer via email integration
  6. Resolve thread when ticket closed
  7. Activity log provides complete history