docs icon indicating copy to clipboard operation
docs copied to clipboard

Do a basic accessibility pass over the docs

Open StarfallProjects opened this issue 6 years ago • 2 comments

Issue: I don't have any disability, came to the docs (https://rethinkdb.com/docs/install/windows/) and was finding it slightly hard to read. Ran a quick checker tool (WAVE plugin for Chrome), and as I suspected, loads of very low contrast text. This is impeding readability for someone with 20/20 vision, so I assume makes it impossible for people with any visual impairment.

Suggestion: Consider doing a basic accessibility check. There are tools like the WAVE plugin which allow very quick checks of a few basics, or https://accessibilityinsights.io/ which offers more detailed reports. I ran its fast-pass assessment, and it looks like a few simple fixes (contrast, add a lang attribute to the html tag, and ensure images have alt text) would make a big difference.

StarfallProjects avatar Sep 30 '19 12:09 StarfallProjects

I don't plan to do anything beyond PR #1240 changing the text color, myself, but any other accessibility fixes are welcome.

srh avatar Oct 02 '19 01:10 srh

:+1: for the accessibility checks. I would like to make sure, everybody can enjoy the RethinkDB website. Please let us have a decision about which direction should we go with the website at all. I'll make sure that in any case, we will include this issue to make the website better.

FYI: @KittyBot

gabor-boros avatar Oct 04 '19 07:10 gabor-boros