Overview

The Triage UI enables you to work through untriaged GitHub items for a single selected repository in a focused, step-by-step session. Unlabelled issues are always included, and you can optionally include unlabelled pull requests in the same queue.

Key features:

  • You can start a triage session for one repository at a time.
  • The queue includes unlabelled issues, with an option to include unlabelled pull requests. When enabled, both types appear in the same queue.
  • Each item in the queue displays a clear item-type indicator: Issue or Pull request.
  • The interface shows your current position (e.g., Item 3 of 10), a remaining count, and a progress indicator.
  • Use the Quick Label field to search and select a label, then click Apply + next to apply it and move on.
  • Click Next to advance without making any change to the current item.
  • Progress and session context are always visible, so you know how much work remains.

How to Use

  1. Select a repository to start a triage session.
  2. The Triage UI queues all unlabelled issues for that repository. If pull request inclusion is enabled, unlabelled pull requests are also included in the queue.
  3. Review each item in turn, then either:
    • Search for a label in the Quick Label field and click Apply + next to label the item and advance, or
    • Click Next to advance to the next item without applying a label.
  4. The session completes once all queued items have been processed.
  5. Use the progress indicator and session context to track your position and the number of remaining items.

When both issues and pull requests are present, the queue operates in a mixed mode, but you still triage one item at a time using the same action surface. Where supported by GitHub, all actions are available for both item types.

Quick Label and Duplicate Actions with Keyboard Shortcuts

You can apply labels or close items (issues and pull requests) as duplicates directly from the Triage UI without leaving the triage view.

  • Use the Quick Label search field to find and select a repository label. The field accepts free-text search so you can type any part of a label name.
  • Click Apply + next (or press L) to apply the selected label and immediately advance to the next item.
  • Click Next (or press N) to move to the next item without applying a label.
  • To close the current item as a duplicate, use the Duplicate reference input to enter the reference number of the original issue, then click Close as duplicate (or press D) to close the current item and advance.
  • The Duplicate reference input is shown inline in the duplicate closure section, allowing you to specify the related issue number before confirming the closure.
  • Keyboard shortcuts work when the action button row is focused. Typing in the Quick Label or Duplicate reference fields does not trigger shortcuts.
  • Primary success and failure feedback appears inline in the triage view via the operation alert, with additional snackbar notifications used for selected error conditions.

The action model now supports three flows: label and advance, close as duplicate and advance, or advance without changes. This keeps the triage rhythm straightforward and efficient.

Assigning Milestones from the Triage UI

You can assign a milestone to an issue directly within the Triage UI, without leaving your triage session.

  • In the Planning Actions section, use the milestone dropdown to select the desired milestone for the current issue.
  • Click the Assign milestone button to apply your selection.
  • A feedback message will confirm whether the milestone was assigned successfully or if an error occurred.
  • You can continue triaging without interruption after assigning a milestone.

Milestone assignment is available for all issues where you have permission to edit milestones. If the operation fails, an error message will be shown with guidance to retry or check your permissions.

Adding Issues to Project Boards from the Triage UI

The Triage UI allows you to add issues to a GitHub project board and set their status column in context.

  • In the Planning Actions section, select a project board from the available list.
  • Choose the desired project status (column) for the issue.
  • Click the Add to project board button to place the issue in the selected board and status.
  • Success or failure feedback appears in the user feedback region, confirming the result of the operation.

If the issue is already on the selected board, you can update its status column directly. Any errors encountered during project board placement will be surfaced with actionable feedback.

All planning actions use MudBlazor controls for a consistent and accessible experience, and the workflow aligns with the triage wireframe.

Session Completion Summary and Skip/Revisit Workflow

When you complete a triage session, a grouped summary is shown with details for all actions taken during the session. The summary includes:

  • Labels applied to issues and pull requests.
  • Milestones assigned.
  • Project board actions performed.
  • Items closed as duplicates (with references).
  • Skip actions (including optional reasons).
  • Items currently skipped for revisit.

You can now skip the current item at any point during triage by clicking Skip or pressing S on your keyboard when the action button row is focused. When skipping, you may optionally provide a reason for skipping the item.

After all items are processed, the session-complete summary allows you to revisit any skipped items. Skipped items are listed in a dedicated grouped section, and skip reasons (if provided) appear in the Skip actions detail section.

The triage UI layout uses MudBlazor components and a responsive grid stack, ensuring readability and usability on both desktop and mobile devices.

Keyboard Shortcuts

  • Press S to skip the current item when the action button row is focused.
This site uses Just the Docs, a documentation theme for Jekyll.