Comments & Activity
Comments & Activity
Section titled “Comments & Activity”Comments and activity tracking enable collaboration throughout the assessment lifecycle. Discuss findings, track changes, and maintain a clear audit trail.
Comments
Section titled “Comments”Where Comments Appear
Section titled “Where Comments Appear”Add comments on:
- Findings
- Projects
- Assets
- Reports
Adding Comments
Section titled “Adding Comments”- Open the item (finding, project, etc.)
- Scroll to Comments section
- Type your comment
- Click Post or press Enter
Comment Features
Section titled “Comment Features”Markdown Support
- Bold, italic, code
- Lists and links
- Code blocks
@Mentions
- Type
@followed by username - User receives notification
- Creates link to profile
Attachments
- Click attachment icon
- Upload images or files
- Files linked in comment
Editing Comments
Section titled “Editing Comments”- Find your comment
- Click Edit (pencil icon)
- Modify text
- Save changes
Note: “Edited” indicator appears.
Deleting Comments
Section titled “Deleting Comments”- Find your comment
- Click Delete (trash icon)
- Confirm deletion
Admins can delete any comment.
Comment Threads
Section titled “Comment Threads”Starting a Thread
Section titled “Starting a Thread”Reply to specific comments:
- Click Reply on a comment
- Thread opens below original
- Add your reply
- Threaded discussion continues
Thread Benefits
Section titled “Thread Benefits”- Keep conversations organized
- Focus on specific topics
- Reduce notification noise
- Easy to follow history
Collapsing Threads
Section titled “Collapsing Threads”Long threads can be collapsed:
- Click Collapse thread
- Shows reply count
- Click to expand
Activity Feed
Section titled “Activity Feed”Project Activity
Section titled “Project Activity”View all project activity:
- Open project
- Go to Activity tab
- See chronological history
Activity Types
Section titled “Activity Types”| Activity | Example |
|---|---|
| Finding created | ”John created finding: SQL Injection” |
| Finding updated | ”Sarah updated severity from Medium to High” |
| Status change | ”Project status changed to In Review” |
| Comment added | ”Mike commented on finding XSS” |
| Report generated | ”Report generated by Jane” |
| Asset added | ”Nmap import added 15 assets” |
Filtering Activity
Section titled “Filtering Activity”Filter by:
- Activity type
- User
- Date range
- Related item
Activity on Findings
Section titled “Activity on Findings”Each finding tracks:
- Creation and updates
- Status changes
- Comment activity
- Evidence additions
- Assignment changes
Notifications
Section titled “Notifications”What Triggers Notifications
Section titled “What Triggers Notifications”You receive notifications for:
- @mentions in comments
- Replies to your comments
- Assignment to project/finding
- Status changes you’re watching
Notification Settings
Section titled “Notification Settings”Configure in Settings → Notifications:
- Email notifications
- In-app notifications
- Notification frequency
- Quiet hours
Watching Items
Section titled “Watching Items”Watch specific items for all activity:
- Open item (project, finding)
- Click Watch (eye icon)
- Receive all activity notifications
Unwatching
Section titled “Unwatching”- Click Watching dropdown
- Select Stop watching
@Mentions
Section titled “@Mentions”How Mentions Work
Section titled “How Mentions Work”Type @ to mention:
@john- Specific user@team- All project team@client- Client portal users
Mention Autocomplete
Section titled “Mention Autocomplete”After typing @:
- User list appears
- Filter by typing name
- Select with arrow keys
- Press Enter or click
Mention Notifications
Section titled “Mention Notifications”Mentioned users receive:
- In-app notification
- Email notification (if enabled)
- Badge on chat/notification icon
Activity Audit Trail
Section titled “Activity Audit Trail”Compliance & Audit
Section titled “Compliance & Audit”Activity tracking provides:
- Who did what, when
- Full change history
- Non-repudiation
- Compliance evidence
Exporting Activity
Section titled “Exporting Activity”Export activity logs:
- Go to Activity tab
- Click Export
- Choose format (CSV, JSON)
- Download file
Best Practices
Section titled “Best Practices”Effective Comments
Section titled “Effective Comments”- Be clear and concise
- Use @mentions sparingly
- Add context to links
- Keep discussions on-topic
Status Updates
Section titled “Status Updates”Comment when:
- Starting work on finding
- Completing verification
- Needing clarification
- Handing off to colleague
For Clients
Section titled “For Clients”When client-visible:
- Use professional language
- Explain technical terms
- Be responsive
- Document agreements
Integration with Chat
Section titled “Integration with Chat”Comments vs. Chat
Section titled “Comments vs. Chat”| Use Comments | Use Chat |
|---|---|
| Permanent record needed | Quick questions |
| Attached to specific item | General discussion |
| Client needs to see | Internal team only |
| Formal decisions | Informal coordination |
Cross-Referencing
Section titled “Cross-Referencing”Link between chat and comments:
- Share finding to chat
- Reference chat in comment
- Maintain coherent discussion
Next: Learn about Notifications