From def4392c9339ed24c0a648babaf8c2e500e52e02 Mon Sep 17 00:00:00 2001 From: Jason Staack Date: Sun, 15 Mar 2026 20:53:50 -0500 Subject: [PATCH] fix(a11y): WCAG 2.1 AA compliance fixes for website Contrast: - Increase --text-muted from #64748B to #8494A7 (~5.3:1 on dark bg) - Darken --docs-text-muted from #94A3B8 to #6B7B8D (~5.3:1 on white) - Increase sidebar section title opacity from 0.5 to 0.7 Keyboard & focus: - Add skip navigation link to both pages - Make screenshot images keyboard-focusable (tabindex, role=button) - Add visible lightbox close button with focus styles - Fix search input focus: proper outline instead of outline:none Structure: - Fix heading hierarchy: single h1 per page, demote sections to h2/h3 - Replace sidebar h4 headings with p.sidebar-section-title - Add aria-labels to all nav landmarks (main, sidebar, footer) - Fix broken footer anchor links (#security-model, #api-endpoints) Accessibility: - Add sr-only label for docs search input - Add aria-label to back-to-top button - Change nav logo SVG from aria-label to aria-hidden (redundant) - Add role=dialog and aria-label to lightbox - Fix docs.html theme-color meta to #FAFBFC (matches light theme) Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/website/docs.html | 237 ++++++++++++++++++++-------------------- docs/website/index.html | 50 ++++++--- docs/website/style.css | 83 +++++++++++--- 3 files changed, 226 insertions(+), 144 deletions(-) diff --git a/docs/website/docs.html b/docs/website/docs.html index c96316d..de47a2e 100644 --- a/docs/website/docs.html +++ b/docs/website/docs.html @@ -8,7 +8,7 @@ - + @@ -35,6 +35,8 @@ + +
@@ -43,10 +45,10 @@
-