Issue Management Guide
Issues are the core work items in ISO Mate’s DevOps module.
Issue Types and Hierarchy
ISO Mate supports five issue types in a parent-child hierarchy:
- Epic: Contains Stories, Tasks, and Bugs
- Story: Can contain Subtasks
- Task: Can contain Subtasks
- Bug: Can contain Subtasks
- Subtask: Must belong to a Story, Task, or Bug
Project Keys
Every issue receives a unique project key when it is created. If the issue belongs to a project, the key uses the project prefix (e.g., PROJ-1, API-5). If no project is assigned, the prefix is determined by the issue type:
- EPC: Epics (EPC-1, EPC-2, …)
- USR: Stories (USR-1, USR-2, …)
- TSK: Tasks (TSK-1, TSK-2, …)
- BUG: Bugs (BUG-1, BUG-2, …)
- SUB: Subtasks (SUB-1, SUB-2, …)
Project keys are permanent. If you change an issue’s type after creation, the original key is preserved so that references in commits, comments, and external tools remain valid.
Creating an Issue
- Navigate to DevOps > Backlog.
- Click the Add button.
- Fill in the required fields:
- Title: A clear, descriptive title
- Type: Select Epic, Story, Task, Bug, or Subtask
- Priority: High, Medium, or Low
- Optionally add: description (rich text), assignee, sprint, release, story points, parent issue (for Subtasks), and labels.
- Click Save.
Type-Aware AI Descriptions
The description editor includes an AI writing assistant that tailors its output to the selected work item type when you generate or refine. A Bug draft covers steps to reproduce, actual result, expected result, and environment. A Story is written as a user story statement followed by acceptance criteria. A Task gives a concise objective and a checklist. An Epic outlines a high-level goal, scope, and the themes of its child stories, and a Subtask stays focused on the specific unit of work. This works in the create issue dialog, the issue detail view, the add parent and add subtask dialogs, and the issue template form.
Comments
Collaborate on an issue using comments on the issue detail page. Comments support rich text formatting such as bold, italics, lists, and links, using the same editor as issue descriptions, and saved comments keep their formatting.
Issue Statuses
Issues move through three statuses:
- To Do: Not started
- In Progress: Work has begun
- Done: Work completed
Story Points
Assign story points to estimate effort. Story points from Subtasks automatically aggregate to the parent issue, giving you an accurate picture of total effort.
Filtering the Backlog
Use the filter bar above the backlog to narrow your view:
- Search by title
- Filter by type, status, priority, assignee, sprint, or release
- Click Clear Filters to reset
Bulk Operations
Select multiple issues using the checkboxes, then use the bulk actions toolbar to:
- Update status for all selected issues
- Change assignee
- Delete selected issues
Reordering
Drag and drop issues in the backlog to reorder them. The order is preserved for your team.
Exporting Issues
Click the Export dropdown and choose CSV or PDF. The export respects your current filters.
ICE Scoring
Prioritize issues with ICE (Impact, Confidence, Ease) scoring. Click the ICE score badge on any issue to rate it on three dimensions and get a weighted priority score. See Prioritizing Issues with ICE Scoring for full details.