---

title: Handling and closing issues description: Learn how to effectively collaborate on issue solutions and correctly close non-conformities with adequate documentation sidebar_position: 3

Handling and closing issues

Working on issues

Opening an issue

1. Click on an issue name in the overview
2. The details panel opens on the right side of your screen
3. Select the "Conversation" tab for collaboration
4. The panel shows all communication and progress

Understanding the conversation interface

What you see in the conversation:

• Description section - Description of the issue
• Comments thread - Chronological communication between team members
• Comment field - Here you can enter your own comment, but also upload evidence and format text with markdown

Collaborating via comments

Adding comments

Writing new comment:

1. Scroll down to "Add your comment" section
2. Type your message in the text field
3. Use Markdown for structure (headings, lists, links)
4. Click "Submit" to post comment

Comment best practices:

• Specific updates - What did you do, what was the result?
• Actionable information - Mention concrete next steps
• Timeline context - When do you expect results?
• Evidence references - Refer to uploaded files

Using @Mentions

Notifying people:

1. Type @ followed by name or initials
2. Select person from dropdown list
3. Person receives automatic notification
4. Use for escalations, questions, or updates

Effective @mentions:

@john Can you check the firewall logs for period January 10-12?

@maria The new procedure is ready for review. See attached document.

@team We have identified the root cause. See update below.

Collecting evidence

Uploading files

Adding documents:

1. Scroll to comment section
2. Click "Drop, or click to add files" or drag files to the comment field
3. Files are uploaded and linked to comment
4. Link appears automatically in your comment

What does good evidence look like?

For Incidents:

• Timeline documentation - When what was discovered and undertaken
• Impact assessment - Which systems/users affected
• Response actions - Concrete steps taken
• Recovery evidence - Proof that systems are restored

For Audit findings:

• Original finding - Exact auditor feedback
• Gap analysis - What is missing or failing
• Action plan - How you will solve it
• Completion evidence - Proof that issue is resolved

For Control gaps:

• Current status - How it works now
• Expected status - What needs to be implemented
• Implementation evidence - New configurations/procedures
• Test results - Validation that control works

Completing, reviewing, and reopening

Closing issues

Direct closing

1. Select the three-dots menu in the top right of the Issue details panel
2. Select "Close issue" from the dropdown menu

Closing with a comment

1. Write the final comment as a new comment
2. Select "Submit and Close" instead of just "Submit"

Reviewing issues

Through Issue Reviews you can record that the Issue has been completed in the right way. A 'reviewed' label is added to the Issue.

Viewing a closed Issue

1. Navigate to 'closed' issues from the Issues overview page
2. Select the issue you want to review

Direct reviewing

1. Select the three-dots menu in the top right of the Issue details panel
2. Select "Review issue" from the dropdown menu
3. The "Reviewed" label appears immediately in the detail panel

Reviewing with a comment

1. Write the review comment as a new comment
2. a. Select "Submit and Review" instead of just "Submit" or;
3. b. Select "Submit and Reopen" to reopen the task (in case the review shows that additional work is needed)

Reopening issues

Direct reopening

1. Select the three-dots menu in the top right of the Issue details panel
2. Select "Reopen issue" from the dropdown menu

Reopening with a comment

1. Write the reason for reopening as a new comment
2. Select "Submit and Reopen" instead of just "Submit"

Next steps

After learning issue handling, you can:

• Systematically resolve issues - Work on solutions in a structured way
• Ensure adequate documentation - Correctly close issues with adequate evidence
• Team collaboration - Effectively collaborate via the conversation tab
• Support continuous improvement - Apply lessons learned to future issues

For general problems and questions, see Troubleshooting & FAQ.