Skip to content

[DOCS] Create instructions/issue-templates.instructions.md #714

@ashleyshaw

Description

@ashleyshaw

Create portable instruction file for issue template usage across all repositories.

Details

  • Follow instruction template pattern (no .github assumptions)
  • Cover all 25 issue types and templates
  • Explain when to create each issue type
  • Link DoR/DoD checklists to issue type
  • Examples of well-formed issues for each type

Issue Type Coverage

  • When to use Task vs. Story vs. Epic
  • Bug: Reproduction steps, error messages, environment info
  • Feature: Problem statement, acceptance criteria, designs
  • Design: Design specs, references, dependencies
  • Automation: Expected behavior, deployment strategy
  • Security: Vulnerability details, impact assessment
  • A11y: WCAG criteria, assistive technology tested
  • Help: Asking for guidance (when to use vs. support contact)
  • (20 more types...)

Acceptance Criteria

  • Covers all 25 issue types
  • Includes Examples section with 3-5 sample issues
  • Guidance on template selection
  • Clear Definition of Ready for issue submission

Metadata

Issue Type: Task
Priority: High
Phase: 2 - Documentation & Guidance
Effort: 1.5h
Depends on: #1

Project: Template Enforcement & Governance

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Priority

    None yet

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions