Files
Q-A_test/apps/docs/i18n/en/docusaurus-plugin-content-docs/current/01-user-guide/05-issue-management.md
T
SDI 12e4f17b62
CI / typecheck (push) Successful in 1m8s
CI / format (push) Failing after 1m6s
CI / lint (push) Failing after 49s
CI / test (push) Failing after 1m8s
first commit
2026-07-15 18:05:12 +09:00

11 KiB

title, description, sidebar_position
title description sidebar_position
Issue This document explains how to create and manage issues in ABC User Feedback and efficiently track them using kanban/list views. 5

Issue

Issues are a core feature for systematically managing problems or improvements found in feedback. This document covers all issue management features, from issue creation to category management and various view modes.

issue


Issue Overview

Role of Issues

Issues are used for the following purposes:

  • Problem tracking: Systematically manage bugs, errors, performance issues, etc.
  • Feature request management: Structure user requests and reflect them in development plans
  • Identifying improvements: Identify improvement points through feedback analysis

Issue Status

Each issue has the following status:

Status Description When Used
New Newly registered Initial issue creation
On Review Under review When assignee starts review
In Progress In progress During actual work
Resolved Resolved Problem solved and completed
On Hold Temporarily on hold Waiting for additional info or deferred

Creating/Editing/Deleting Issues

Issue Creation Methods

Issues can be created in two ways.

The most common method, creating an issue based on specific feedback.

  1. Click feedback in the Feedback tab to open detail view
  2. Click the + button in the Issue section of the right detail panel
  3. Enter the issue name and press Enter or click the Create option

2. Create Directly from Issue List

  1. Click the Issue tab in the top menu
  2. Click the + Create Issue button at the top left
  3. Enter information in the issue creation dialog:
Item Description Required Example
Title Issue title Required Login button malfunction
Description Detailed description Optional Occurs in specific browser
Category Issue classification Optional Bug
Status Initial status (default: New) Optional New

Editing Issues

You can modify information of created issues.

Editing Method

  1. Click the issue you want to edit in the issue list
  2. Click the Edit button in the Issue Details panel that opens on the right
  3. In edit mode, you can modify the following items:

Editable Items

Item Editable Description
Title Yes Issue title
Description Yes Detailed description
Category Yes Issue classification (select from dropdown)
Status Yes Current progress status
Ticket Yes External issue tracker ticket number
ID No System auto-generated
Created No Creation date/time

Save and Cancel

  • Save button: Saves changes and exits edit mode
  • Cancel button: Cancels changes and reverts to original state

External Issue Tracker Integration

When integration with external issue trackers (Jira, etc.) is configured, you can link external tickets to issues.

Ticket Linking Method

  1. Enter the external ticket number in the Ticket field in the issue detail panel
  2. The entered number is automatically converted to an external system link

Note

: External issue tracker integration requires prior configuration in Settings > Issue Tracker Management.

Deleting Issues

You can delete issues that are no longer needed.

Deletion Method

  1. Click the Delete button in the issue detail panel

  2. Approve deletion in the confirmation dialog

Deletion Notes

  • Cannot be recovered: Deleted issues cannot be restored
  • Feedback links removed: Issue links in connected feedback are removed
  • Statistics impact: Data is excluded from dashboard issue statistics

Kanban View

Kanban view is a viewing method that allows visual management by separating issues into columns by status.

issue-kanban

Accessing Kanban View

  1. Click the Issue tab in the top menu
  2. Select Kanban view at the top right

Kanban Board Structure

Columns are organized by each status, and issues are displayed as cards.

Kanban Column Structure

Column Display Information Card Count Display
New Newly registered issues Number at top
On Review Issues under review Number at top
In Progress Issues in progress Number at top
Resolved Resolved issues Number at top
On Hold Issues on hold Number at top

Issue Card Information

Each issue card displays the following information:

  • Issue title: Click to go to detail view
  • Feedback count: Number of linked feedback (with 📝 icon)
  • Category: Displayed at bottom if set
  • External ticket: Ticket number displayed if linked

Drag and Drop Status Change

A core feature of kanban view, you can change status by dragging issue cards to different columns.

Usage Method

  1. Click and drag an issue card with the mouse
  2. Move it over the desired status column
  3. Release the mouse to automatically change status

Kanban View Filtering

You can display only issues matching specific conditions using the filter function at the top.

Available Filters

  1. Date filter: Display only issues created in a specific period
  2. Filter button: Set advanced filter conditions

Filter Condition Examples

Filter Type Condition Example Use Case
Category Category = "Bug" Check only bug issues
Title Title contains "Login" Find login-related issues
Created Created >= 2024-03-01 Issues created after specific date
Status Status != "Resolved" Display only unresolved issues

Kanban View Sorting

You can change the sort order of issue cards within each column.

Sort Options

  • Created Date ↓: Newest first
  • Created Date ↑: Oldest first
  • Feedback Count ↓: Most linked feedback first

List View

List view is a viewing method that displays issues grouped by category in table format.

Accessing List View

  1. Click the Issue tab in the top menu
  2. Select List view at the top right

List View Structure

Issues grouped by category are displayed hierarchically.

Category Groups

Each category is displayed as a collapsible/expandable group:

  • Group header: Category name and number of included issues
  • Collapse/Expand arrow: Toggle group content display/hide
  • "No Category": Issues without assigned category

List View Filtering

Provides the same filter function as kanban view.

Filter Application Method

  1. Click the Date or Filter button at the top
  2. Set desired conditions
  3. Filtered results are displayed grouped by category

Empty Category Handling

Categories with no issues in the filtering results are automatically hidden.

List View Sorting

You can sort by clicking each column header.

Sort Behavior

  • First click: Ascending sort ↑
  • Second click: Descending sort ↓

Each Sort Content

Sort Criteria Use Case
Created ↓ Check latest issues first
Feedback Count ↓ Prioritize high-impact issues
Status Check grouped by status

Issue Categories

Issue categories are a feature that allows systematic management by classifying issues.

Purpose of Categories

  • Issue classification: Distinguish bugs, feature requests, improvements, etc.
  • Analysis ease: Analyze issue occurrence patterns by category

Default Category Examples

Commonly used category classifications:

Category Description Priority Example Team
Bug Function malfunction, errors High Development Team
Feature Request New feature addition requests Medium Planning Team
Improvement Existing feature enhancement Medium UX Team
Performance Speed, stability issues High Infrastructure Team
UI/UX User interface problems Low Design Team
Documentation Help, guide related Low Technical Documentation Team

Category Management

Adding Categories

You can add new categories in the issue detail panel:

  1. Click the Add button in the Category field of the issue detail panel
  2. Enter the new category name
  3. Press Enter or click the confirm button

Assigning Categories

You can assign or change categories for existing issues:

  1. Click the Edit button in the issue detail panel
  2. Select the desired category from the Category dropdown
  3. Save changes with the Save button

Category-Based Issue Management

Checking by Category in List View

In list view, you can see issues grouped by category at a glance:

  • Issue count by category: Number of included issues displayed in each group header
  • Group collapse/expand: Selectively check only needed categories
  • "No Category" group: Separate management of unclassified issues

Category-Based Filtering

When you want to check only issues of a specific category:

  1. Click the Filter button
  2. Add a Category condition
  3. Select the desired category