UX Improvement Request Template

UX Improvement Request Template

UX improvement requests differ from standard feature requests because they focus on enhancing existing workflows rather than adding new capabilities. A dedicated template captures the nuances of user experience feedback.

Template Design

name: "UX Improvement"
description: "Suggest a user experience improvement"
title: "[UX]: "
labels: ["enhancement", "ux"]
body:
  - type: textarea
    id: current_workflow
    attributes:
      label: "Current Workflow"
      description: "Describe how you currently accomplish this task"
      placeholder: "Currently I have to..."
    validations:
      required: true
  - type: textarea
    id: pain_points
    attributes:
      label: "Pain Points"
      description: "What makes the current experience frustrating?"
    validations:
      required: true
  - type: textarea
    id: ideal_experience
    attributes:
      label: "Ideal Experience"
      description: "Describe how you wish this worked"
    validations:
      required: true
  - type: dropdown
    id: user_impact
    attributes:
      label: "User Impact"
      description: "How many users does this affect?"
      options:
        - "Just me"
        - "My team"
        - "Many users"
        - "All users"
    validations:
      required: true
  - type: textarea
    id: mockups
    attributes:
      label: "Mockups / Screenshots"
      description: "Attach any mockups, wireframes, or annotated screenshots"
    validations:
      required: false

Key Differentiators from Standard Feature Requests

Current workflow documentation: Understanding the existing user journey is essential for UX improvements. This field captures the steps users currently take.

Pain point specificity: Rather than a general problem statement, pain points focus on friction in the current experience.

User impact scale: The dropdown helps product teams prioritize improvements that affect the most users.

Including Screenshots

GitHub issue forms render images uploaded via drag-and-drop into textarea fields. Encourage reporters to annotate screenshots highlighting the problematic UX elements.