Accessibility issues

[jaimeiniesta]

🐛 Bug Report

Related to #462

I've run an HTML and Accessibility check on 100 pages from https://v2.docusaurus.io/ - each page was checked using the latest version of W3C Validator for HTML issues, and Deque Axe-core 3.5.2 for Accessibility issues.

Here is the result report per page - the tabs allow to group the common issues on the site:

https://rocketvalidator.com/s/5f7336e6-2ab5-4bcf-bc42-c9627b32ebbe/p

Have you read the Contributing Guidelines on issues?

Yes

To Reproduce

Check the pages using the W3C HTML validator, axe-core for Accessibility or other checkers.

Expected behavior

Not finding incorrect HTML markup nor accessibility issues.

Actual Behavior

HTML and A11Y issues found.

Your Environment

n/a

Reproducible Demo

https://rocketvalidator.com/s/5f7336e6-2ab5-4bcf-bc42-c9627b32ebbe/p

[yangshun]

Thanks for the reports. Most of the violations are code-block/syntax highlighting related and unfortunately we can't really do anything about them. PRs welcome to fix the other issues.

[amimas]

I wonder if the code block or syntax highlight related issues need to be opened as separate issues elsewhere.

[jaimeiniesta]

I wonder if the code block or syntax highlight related issues need to be opened as separate issues elsewhere.

In case it helps, I finally chose another template for our documentation site - I run into similar issues for code blocks, fixing was easy: choosing a higher contrast theme, and making scrollable code blocks focusable by the keyboard (tabindex=0).

Also, I'll be happy to provide free accounts on our accessibility scanner for those interested in improving the accessibility of Docusaurus. Just ping me at jaime@rocketvalidator.com and I'll set yo up.