-
-
Notifications
You must be signed in to change notification settings - Fork 3.8k
Description
I'm finding this theme to be very capable. However, one thing that presents an issue is that the built-in styling generates errors when evaluating for WCAG compliance (you can analyze the Just the Docs pages with something like the WAVE plugin for a quick read). With WACG 2.2 coming out later in 2021, there will probably be renewed attention to accessibility issues and, for larger organizations in many countries, compliance with 2.1 is already mandated.
Overall, the default style has a lot of positives: structural elements are strong, keyboard nav works, etc. The chief area for improvement seems to be contrast. It shows up in several areas, including code blocks, labels, buttons.
Obviously, I can (and will) modify SCSS to address this on my site, but it might be worth looking at tweaking the default variables and elements to be WCAG-friendly out of the box. That way Just the Docs users create more accessible sites without having to be well-versed in standards.
Thanks for considering this.