Issue Templates

Intent

Capture the right data for changes and defects upfront. Good templates guide contributors to provide context, link to ADRs, and categorise by area — making triage faster and metrics meaningful.

Implementation Considerations

GitHub forms

name: Change Proposal
description: Request a change to profiles, extensions, terminology, or examples
body:
  - type: dropdown
    id: area
    attributes:
      label: Area
      options: [profile, extension, terminology, example]
  - type: textarea
    id: motivation
    attributes:
      label: Motivation
  - type: input
    id: adr
    attributes:
      label: Related ADR (link)

GitLab templates

# Change Proposal

**Area**: profile|extension|terminology|example
**Related ADR**: #
**Motivation**: 
**Acceptance Criteria**: 

# Defect

**Observed**: 
**Expected**: 
**Steps to Reproduce**:

Labels & triage

type:profile, type:extension, type:terminology, type:example
area:* labels match folder layout
needs:decision links to ADR workflow

Benefits

Faster triage
Better metrics

Trade-offs

Template maintenance