Skip to content

Accessibility (a117) improvements - #12100

Open
ConnorLand wants to merge 17 commits into
developmentfrom
ctl-a11y-tasks
Open

ConnorLand wants to merge 17 commits into
developmentfrom
ctl-a11y-tasks

Conversation

@ConnorLand

@ConnorLand ConnorLand commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

In conjunction with Hedwig's work (see TW-2841) improving our site's screen reader compatibility, I'm going down all the docs and fixing the last a11y flags that AxeDevtools indicates to us. From what I'm seeing now, most of my fixes should be mostly screen reader text for images, and hover text for links.

Basic project steps:

  • Do comprehensive AxeDevtools scans of all categories to get an idea of WCAG violations, fixing what I can as I go (bascially I can fix anything that isn't fundamental to site code as I go, and the stuff that's tied to all site code I'll do next) (in progress, longest step of the project)
  • Take fix actions that influence the entire site (e.g. add code to tables to allow Safari keyboard access, change text colors)
  • Do final LLM scan for all remaining alt text violations, initiate LLM to suggest text, then edit/approve that text
  • Present PR for review

@ConnorLand ConnorLand self-assigned this Oct 19, 2026
- content_type: "Release Notes"
- mendix_version: 10
#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
#This, and all docs, have 1 a11y issue attached to the Get Started signup link on the bottom of every page. I'll need to look into putting hovertext on that to solve it I think.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Act on this and then delete the text from the metadata

tags: ["atlas", "atlas ui", "theming", "css", "css variables", "sass", "migration", "styling", "frontend"]
---

<!-- TODO: This doc has highest # of text color contrast violations: over 50. Makes it a good litmus test for if we changed all the colors we needed to in the core code. -->

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doc has over 50 color contrast violations, making it a good test for (after we change the core code and colors text renders in) checking the overall state of the site's text.

@ConnorLand

ConnorLand commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator Author

Pausing work on this today, but I scanned all the following:

  • Release notes
  • Quickstart guides
  • Refguide
  • Installation
  • General info

I'll resume my scans with Start with Maia, but at this point I think I have a good overview of the main a11y problems and this project could probably move forward with just LLM-assisted mass commits fixing missing alt text, as well me and a stack TWer directly addressing all the core html/css issues that flag a117 issues (text color, scrollable tables, and the other website code-dependant things I noted in my comments).

* Due to licensing issues, we no longer distribute the SAP HANA JDBC driver with the Mendix runtime. If you want to run an app with a SAP HANA database, see [SAP HANA](/refguide/saphana/).
* We now automatically convert remaining long-lived browser sessions in offline-first web apps to [authentication tokens](/refguide/session-management/) when session data is refreshed. End-users do not have to sign in again during the conversion.
{{% alert color="info" %}}Authentication tokens have a default validity of one year, compared with the previous long-lived session timeout of seven days of inactivity, so users may remain signed in for longer. `LongLivedSessionTimeout` no longer applies to converted sessions, so if your app relies on the previous default or a custom `LongLivedSessionTimeout`, review and configure [com.mendix.webui.AuthTokenTimeout](/refguide/custom-settings/#commendixwebuiAuthTokenTimeout). Remember that this is specified in minutes, rather than milliseconds.{{% /alert %}}
<!-- TODO: change color of CODE TICKED text when it is in INFO boxes so it meets WCAG contrast ratios. The current hot pink is a little too bright to meet the requirements. -->

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Mendix.Capitalization] Use ''Mendix'' (capitalized)

This branch has not been deployed

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant