Skip to content

WCAG Compliance #566

@dking-after

Description

@dking-after

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions