-
Couldn't load subscription status.
- Fork 752
Add accessibility documentation #10220
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: development
Are you sure you want to change the base?
Conversation
|
|
|
|
||
| ### Link Purpose | ||
|
|
||
| [Link purpose](https://www.w3.org/TR/WCAG22/#link-purpose-in-context), instead of using **Click here**, the link's destination should be clear from the surrounding text. Ideally, that description would be part of the link itself. It would help users understand the purpose of each link, enabling them to decide whether to follow it. Also, assistive technology can provide users with a list of links on the website. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What does this mean "instead of using Click here? I think this example needs to be a bit more spelled out.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This refers to a situation where you have a link in a block of text. For example, on a museum website you could have something like: [Click here](url) to learn more about fossils
This would not comply with accessibility best practice. Instead people should do something more like: To learn more about fossils, go to our [fossil collection](url)
I'll add a mendix specific example
|
Edits on this doc are mostly done. The work remaining is to:
I will finish that work when I get back and this should merge either Nov 7 or 10. |
Here's the first draft of new accessibility documentation. The goal of this is to explain accessibility in general and give some pointers for people how to make their apps more accessible. It's very much meant as a starting point that later documentation can build off of.
It currently still needs some images of certain settings but the text should be all there already.