Diagram: Alt-text quality uneven; some chapters lack descriptive alt text for figures #1893

Category: accessibility
Severity: low

Problem

Alt-text quality is mixed across the manuscript: chapters 12, 17, 19 have excellent descriptive alt text; chapters 1, 3, 9b, 16 use terse labels like "Migration Process" or "Structurizr Overview" that are inadequate for screen readers.

Suggested fix

Run an editorial pass across all figure alt text, targeting chapters 1, 3, 9b, 16 first. Each alt text should describe the diagram's content and key relationships, not just name the topic (e.g. "Migration process showing four phases: assess, plan, execute, verify, with feedback loop from verify back to assess" rather than "Migration Process"). Add an accessibility checklist to DIAGRAM_STYLE_GUIDE.md and a basic CI check enforcing minimum alt-text length.

Auto-generated by graphic-designer review agent.