[Audit] 44 README Files - Mermaid Diagrams & Accessibility Review

[ashleyshaw]

Overview

Comprehensive audit of 44 README.md files across the repository to verify Mermaid diagram syntax, accessibility compliance, and content freshness.

Current Problems

1. Mermaid diagrams may have syntax errors or be outdated
2. Diagrams may lack accessibility attributes (accTitle, accDescr)
3. Diagrams may not work in light/dark mode
4. README content may be outdated or incomplete
5. No systematic way to verify diagram accessibility compliance

Areas to Audit

See child issues for detailed audits of:

• Root & core README files (6 files)
• Feature folder README files (12 files)
• Sub-folder README files (20 files)
• Test/config README files (6 files)
• Mermaid diagram syntax validation
• Accessibility compliance (WCAG AA)
• Light/dark mode rendering

Acceptance Criteria

• All 44 README files inventoried
• Mermaid diagram syntax validated
• Accessibility attributes added where needed
• Content freshness verified and updated
• Audit report generated

Related Files

All README.md files across the repository (see audit report for inventory)

Related Issues

• #512 — Wave 3A: README & Mermaid Diagram Discovery & Audit
• #513 — Wave 3B: README & Mermaid Diagram Repair & Update

Related Documentation

• Documentation Index
• Accessibility Instructions
• Documentation Formats Guide

[linear-code]

LS-826

[ashleyshaw]

PR reference correction (2026-06-01):\n\nFor the Wave 5 README stream tied to child issues #667-#670:\n- Canonical merge: PR #723 (merged).\n- Accidental merge: PR #703.\n- Revert of accidental merge: PR #726 (merged).\n\nThis issue set should reference #723 as the intended delivery path.

[ashleyshaw]

Correction for child stream #667-#670: canonical delivery is PR #723 to develop. PR #703 was an accidental main merge and PR #726 reverted it on main.