Skip to content

task: label-consolidation - Approve Decision template and Discussions routing [TEMPLATE-UPDATE-REQUEST] #3557

Description

@ashleyshaw

Task Summary

[TEMPLATE-UPDATE-REQUEST]: approval request for changes to the locked issue templates in .github/ISSUE_TEMPLATE/, as required by constitution §II (Curated Assets with Locked Governance). The changes are in PR #3534 (spec 008 tasks T040b and T053), which closes this issue when it merges and should not merge until this request is approved.

Status (2026-09-25): not yet approved. Your next-step request asked to confirm the default area and the Discussions link. The template and its contract now agree on area:governance, and the title prefix is decision:.

Requested changes:

  1. Add .github/ISSUE_TEMPLATE/06-decision.md: a Decision template with the sections Summary, Context, Options Considered, Decision, Consequences and Linked Work, plus Definition of Ready and Definition of Done. Defined in .github/specs/008-label-audit-consolidation/contracts/decision-issue-template.md. Frontmatter to approve:
    • Title: decision: {scope} - {short description}. This is a new issue-title prefix, added to docs/ISSUE_PR_TITLE_GOVERNANCE.md §5 in chore: label-consolidation - Align Decision taxonomy and templates #3534.
    • Default labels: type:decision, status:needs-triage, priority:normal, area:governance. Every other template sets one default area, and the author changes it when another area fits.
    • Recommended branch: docs/.
  2. Remove .github/ISSUE_TEMPLATE/06-question.md. It is the only template for the Question type, which is being retired (see the companion [ISSUE-TYPE-UPDATE-REQUEST] task: label-consolidation - Approve issue type and label changes [ISSUE-TYPE-UPDATE-REQUEST] #3556). Existing issues titled question: keep their titles until they are converted to Discussions or relabelled (task T063).
  3. Update .github/ISSUE_TEMPLATE/config.yml: add a "Questions and support" contact link to https://github.com/lightspeedwp/.github/discussions, so the issue chooser sends questions to Discussions. Issues are for tracked work; decisions use the Decision template, and help requests stay in Discussions.

Decision work that changes files uses a docs/ branch, so its PR is labelled type:docs and routed to pr_docs.md by branch prefix. No PR template changes are requested.

Linked Stories/Tasks

Milestones & Timeline

Acceptance Criteria

Steps / Checklist

Dependencies

Additional Context

  • Impact on dependent systems: template frontmatter and label checks (scripts/agents/includes/check-template-labels.js) pass with the new template; the issue template count stays at 25, one per issue type. The title normaliser (scripts/automation/normalize-issue-pr-titles.js) now maps type:decision to decision: instead of chore:.
  • Breaking changes: new issues can no longer use the Question template. Existing open type:question issues convert to Discussions later (task T063).
  • Rollback: revert chore: label-consolidation - Align Decision taxonomy and templates #3534.

Definition of Ready (DoR)

  • Task described and scoped
  • Change set and impact analysis included
  • Acceptance criteria mapped
  • Estimate added if relevant

Definition of Done (DoD)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions