Repository navigation
[Child of #652] Audit: Mermaid Diagram Accessibility (WCAG AA, Light/Dark Mode) #669
Description
Overview
Audit Mermaid diagrams for accessibility compliance (WCAG AA standards) and proper rendering in light/dark modes.
Scope
- For each Mermaid diagram, check for accessibility attributes:
accTitle(accessible title)accDescr(accessible description)
- Test diagrams in light and dark mode
- Verify color contrast (WCAG AA standards)
- Document which diagrams need accessibility improvements
Audit Checklist
- Create list of all Mermaid diagrams
- Check each diagram for
accTitleattribute - Check each diagram for
accDescrattribute - Test each diagram in light mode
- Test each diagram in dark mode
- Verify color contrast ratios meet WCAG AA (4.5:1 minimum)
- Document accessibility gaps
Deliverables
- Accessibility audit report
- Spreadsheet: Diagram | Has accTitle | Has accDescr | Light Mode OK | Dark Mode OK | Contrast OK | Fixes Needed
- List of diagrams requiring accessibility improvements
- Specific recommendations for each diagram
Related Files
- All README.md files with Mermaid diagrams
- Mermaid documentation
Related Documentation
- Accessibility Instructions
- WCAG 2.2 Standards
- Mermaid Accessibility Docs
- Documentation Formats Guide
Definition of Ready (DoR)
- Clear problem statement and expected outcome
- Acceptance criteria defined
- Related issues/dependencies identified
- Required resources/approvals listed
Definition of Done (DoD)
- All acceptance criteria met
- Changes tested and validated
- Documentation updated
- Changes merged and deployed
- Stakeholders notified
Metadata
Metadata
Assignees
Type
Fields
Priority
None yet
Activity
linear-code commentedon May 31, 2026
LS-843
LS-1145
Fix markdown linting errors - add blank lines around headings and lists
Wave 5.4 Discovery Audit: README & Mermaid Diagram Inventory
Fix markdown linting errors - add blank lines around headings and lists
Wave 5.4 Discovery: Complete README & Mermaid Diagram Audit (#667) (#687
feat(#668): Add Mermaid diagram syntax validation
feat(#668): Add Mermaid diagram syntax validation (#693)
Wave 5.4 Discovery: Complete README & Mermaid Diagram Audit (#667) (#687
feat(#668): Add Mermaid diagram syntax validation (#693)
Fix: Complete Mermaid accessibility compliance for Issue #669
Issue #669: Add Mermaid accessibility compliance audit
3 remaining items
fix(a11y): harden Mermaid validator and fix 20 pre-type accTitle/accD…
github-actions commentedon Jun 19, 2026
✅ Template check passed after update. Thanks for fixing the issue body.
github-actions commentedon Aug 20, 2026
Unchecked DoD items found. Please complete all checklist items before closing this issue.
To close this issue:
To force close this issue without completing DoD:
meta:force-closelabelFor more information on Definition of Done standards, see the issue template guide: https://github.com/lightspeedwp/.github/issues/new/choose
github-actions commentedon Aug 20, 2026
✅ Issue checklists finalised after closure.
github-actions commentedon Aug 20, 2026
Milestone Allocation
github-actions commentedon Sep 8, 2026
This issue has labels that are not in the canonical taxonomy:
migrate:priority:normalmigrate:type:auditmigrate: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.