What does good accessibility docs look like? I’ve been shopping around and mostly see one of a few options No accessibility docs, accessibility docs that more or less say “we’re WCAG compliant,” the latter plus they accept issue reports - ThreadSky

About ThreadSky

jacobasper.com • 74 days ago

What does good accessibility docs look like? I’ve been shopping around and mostly see one of a few options

No accessibility docs, accessibility docs that more or less say “we’re WCAG compliant,” the latter plus they accept issue reports

Comments

emmadawsondev.bsky.social•73 days ago

I think I’d just like to see more libraries where it doesn’t seem like an afterthought. Either it’s included on every page or it has its own section on what to include and where accessibility issues might arise if not careful

emmadawsondev.bsky.social•73 days ago

Good point! I think any docs is better than no docs but definitely agree that the quality can leave a lot to be desired.

One library I’m currently looking at does have some reference to aria roles but it was hidden several links deep so that doesn’t make me feel like it’s a priority

jacobasper.com•73 days ago

Another fun one is when accessibility is a paid add on! Usually this is an accessibility checker for the content inside, but still

emmadawsondev.bsky.social•73 days ago

Yeah, that’s terrible. People shouldn’t have to pay extra for something to be accessible. That’s like adding a disability tax

jacobasper.com•73 days ago

My use case is rich text editors, so most of the articles on accessibility talk about semantic markup. I do appreciate that, but sometimes the editing experience leaves something to be desired

For example, keyboard users need 3 clicks to do the same as a hover for one action

Posting Rules

Be respectful to others
No spam or self-promotion
Stay on topic
Follow Bluesky's terms of service

Comments

Posting Rules

Reply