Skip to content

Conversation

@HedwigAR
Copy link

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.

@CLAassistant
Copy link

CLAassistant commented Oct 14, 2025

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ ConnorLand
❌ HedwigJDoets
You have signed the CLA already but the status is still pending? Let us recheck it.

@ConnorLand ConnorLand self-assigned this Oct 14, 2025

### 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.
Copy link
Collaborator

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.

Copy link
Author

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

@ConnorLand
Copy link
Collaborator

Edits on this doc are mostly done. The work remaining is to:

  1. Make a new parent doc in Modeling titled something related to best practices
  2. Move this doc and 2 others into the new category
  3. Fix broken links
  4. Set up aliases in the moved docs' metadata

I will finish that work when I get back and this should merge either Nov 7 or 10.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants