# Issues Overview

## Issues Overview

Issues help you track problems, blockers, and concerns that need resolution.

Updated over a month ago

### What are Issues?

Issues represent:

* **Bugs** - Technical problems
* **Blockers** - Things preventing progress
* **Risks** - Potential problems
* **Concerns** - Questions or uncertainties
* **Defects** - Quality issues

### Viewing Issues

#### Issue List

Navigate to **Issues** to see all issues in your organization.

The list shows:

* Issue title
* Status
* Priority
* Assigned project(s)
* Created date

#### Project Issues

{% stepper %}
{% step %}
Open a project.
{% endstep %}

{% step %}
Go to the **Issues** tab.
{% endstep %}

{% step %}
See issues linked to that project.
{% endstep %}
{% endstepper %}

#### Issue Groups

Issues can be organized into groups for better management:

* View issues by group
* Filter by group
* Create custom groups

### Creating Issues

#### Create an Issue

{% stepper %}
{% step %}
Navigate to **Issues** or a project's Issues tab.
{% endstep %}

{% step %}
Click **+ New Issue**.
{% endstep %}

{% step %}
Fill in the details:

* **Title** - Brief description of the issue
* **Description** - Full details
* **Priority** - Critical, High, Medium, Low
* **Group** - Category or type
* **Project** - Associated project (optional)
  {% endstep %}

{% step %}
Click **Create**.
{% endstep %}
{% endstepper %}

#### Quick Create

{% stepper %}
{% step %}
From the issues list, type in the quick input.
{% endstep %}

{% step %}
Press Enter.
{% endstep %}

{% step %}
Add details later.
{% endstep %}
{% endstepper %}

### Issue Properties

| **Property**     | **Description**                   |
| ---------------- | --------------------------------- |
| **Title**        | Brief description                 |
| **Description**  | Full details and context          |
| **Status**       | Current state                     |
| **Priority**     | Importance level                  |
| **Group**        | Category or type                  |
| **Project(s)**   | Linked projects                   |
| **Linked Items** | Related tasks, requirements, etc. |

### Issue Status

| **Status**      | **Meaning**                      |
| --------------- | -------------------------------- |
| **Open**        | Issue is active, needs attention |
| **In Progress** | Being worked on                  |
| **Pending**     | Waiting for something            |
| **Resolved**    | Fixed or addressed               |
| **Closed**      | No longer active                 |

### Issue Priority

| **Priority** | **Meaning**                  |
| ------------ | ---------------------------- |
| **Critical** | Immediate attention required |
| **High**     | Important, address soon      |
| **Medium**   | Normal priority              |
| **Low**      | Address when possible        |

### Linking Issues

Issues can be linked to many items for traceability:

#### Link to Projects

* An issue can affect multiple projects
* Project teams see relevant issues

#### Link to Tasks

* Show which tasks are blocked
* Track issue resolution progress

#### Link to Requirements

* Connect issues to business requirements
* Impact assessment for changes

#### Link to Documents

* Reference relevant documentation
* Attach evidence or reports

#### Link to Activities

* Connect to meeting notes
* Reference discussions about the issue

### Creating Links

{% stepper %}
{% step %}
Open the issue.
{% endstep %}

{% step %}
Click **Link** and choose the item type.
{% endstep %}

{% step %}
Select the item to link.
{% endstep %}

{% step %}
View all links in the issue details.
{% endstep %}
{% endstepper %}

### Issue Groups

Organize issues by creating groups.

#### Create a Group

{% stepper %}
{% step %}
Go to **Issues**.
{% endstep %}

{% step %}
Click **Manage Groups**.
{% endstep %}

{% step %}
Click **+ New Group**.
{% endstep %}

{% step %}
Enter a name (e.g., "Technical Bugs", "Process Issues").
{% endstep %}

{% step %}
Click **Create**.
{% endstep %}
{% endstepper %}

#### Assign to Group

{% stepper %}
{% step %}
When creating or editing an issue, select the **Group** dropdown.
{% endstep %}

{% step %}
Choose a group.
{% endstep %}

{% step %}
The issue appears under that group.
{% endstep %}
{% endstepper %}

### Updating Issues

{% stepper %}
{% step %}
Open the issue.
{% endstep %}

{% step %}
Edit any field.
{% endstep %}

{% step %}
Changes save automatically.
{% endstep %}
{% endstepper %}

Status changes are logged for audit purposes.

### Issue Heatmap

{% stepper %}
{% step %}
Open a project.
{% endstep %}

{% step %}
View the issue heatmap.
{% endstep %}

{% step %}
See patterns of issue creation and resolution.
{% endstep %}

{% step %}
Identify problem periods.
{% endstep %}
{% endstepper %}

### Best Practices

#### Writing Good Issue Titles

* Be general
* Example: "Authentication & SSO"