Repository navigation
fix(a11y): ISSUE_TEMPLATE README.md Mermaid diagram missing YAML header block accTitle/accDescr #991
Description
Summary
The Mermaid diagram in .github/ISSUE_TEMPLATE/README.md uses the deprecated inline accTitle/accDescr syntax (declared inside the flowchart body, after the diagram-type line) rather than the canonical YAML header block format mandated by instructions/mermaid.instructions.md v2.0.
Current (broken) format
flowchart TD
accTitle: Issue template workflow
accDescr: Shows how users select an issue template...
Required format
---
accTitle: Issue template workflow
accDescr: Shows how users select an issue template...
---
flowchart TD
Impact
validate:mermaid-accessibilityCI check flags diagrams that do not carry the YAML header block- Screen readers may not surface the accessible title/description for this diagram
- Inconsistency with all other diagrams in the repository which were updated to YAML block format in the Wave-5 Mermaid WCAG sweep
Acceptance Criteria
-
.github/ISSUE_TEMPLATE/README.mddiagram uses the YAML header block (---delimiters before the diagram type line) foraccTitleandaccDescr -
validate:mermaid-accessibilitypasses - Frontmatter
versionandlast_updatedbumped per convention
Related
instructions/mermaid.instructions.mdv2.0 — canonical diagram standards- Wave-5 Mermaid WCAG sweep (PR feat(mermaid): WCAG 2.2 AA colour contrast validation and updated diagram standards #977, PR [codex] Mermaid diagrams WCAG 2.2 AA contrast sweep #987)
Metadata
Metadata
Assignees
Type
Fields
Priority
None yet
Activity
linear-code commentedon Jun 18, 2026
LS-1102
github-actions commentedon Jun 18, 2026
Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)
The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:
If this was opened by automation, update the automation to preserve the template sections before creating the issue.
fix(a11y): convert ISSUE_TEMPLATE README diagram to YAML header block…
fix(changelog): add entry for Mermaid inline accessibility syntax fix
github-actions commentedon Aug 4, 2026
⏱️ Aging and SLA annotation
Maintained by project-meta-sync workflow.
fix(ci): exclude pre-migration low-numbered issue links from lychee
fix(ci): upgrade create-github-app-token to v3 and fix permission inp…
github-actions commentedon Sep 8, 2026
This issue has labels that are not in the canonical taxonomy:
migrate:type:bugmigrate:area:documentationmigrate:area:a11yValid Canonical Labels
Please use labels with a prefix from the canonical taxonomy:
type:bug,type:feature,type:task,type:documentation, etc.status:needs-triage,status:in-progress,status:done, etc.priority:critical,priority:high,priority:normal,priority:lowarea:ci,area:docs,area:labels,area:security, etc.meta:needs-changelog,meta:duplicate,meta:blocked, etc.For the complete list, see .github/labels.yml.