[Docs] New page for generic accessibility classes and attributes

Prerequisites

• I have searched for duplicate or closed feature requests
• I have read the contributing guidelines

Proposal

There are quite a number of pages in the docs which discuss accessibility.

It would be very helpful to have a new “accessibility” page which summarises all generic accessibility classes / aria attributes in one place. I’m not referring to accessibility specific to some component, but rather those bits that are generic.

For example, I always struggle to remember how to show visually and hide to screen readers, or vice versa (aria-hidden="true" and .visually-hidden). One of those has a dedicated page, and the other does not.

Motivation and context

I refer to the docs regularly. And I always find it difficult to find the bit that I’m looking for - I can’t remember if it’s under the “text”, “reboot”, “visibility”, “visually hidden”, etc., pages.

[lonix1]

@julien-deramond LOL, you see that’s what I’m talking about. I forgot about that page completely! 😄

I was initially thinking of a small dedicated page in the “utilities” section. But the one you’ve linked to is good; maybe it could be expanded. But then the overlapping bits on other pages might need to be moved.

Basically, all the info already exists in the docs right now, but in a number of different places.

[julien-deramond]

Yes some info about a11y is very generic (global classes, our philosophy, etc.), some is very specific to one component and will depend on the context of the use of one component. But I understand the point. I haven’t checked everything but in the other pages, maybe we can link when possible to this main Accessibility page so that the users are used to go there, and try to gather in this main page most of the info. Let’s try something 😃 Thanks for the feedback btw!