Accessibility (a117) improvements

content/en/docs/refguide/general/mx-command-line-tool/merge.md

@@ -84,6 +84,7 @@ The image below illustrates the meaning of the parameters:
 In the diagram, note the following:
 
 * <span style="color:green">**A"**</span> is `MINE`, the current commit you want to merge changes into
+<!-- TODO: change color of B below (style color orange) so it meets WCAG contrast ratios. -->  
 * <span style="color:orange">**B'**</span> is `THEIRS`, the last commit on the branch you want to merge changes from
 * <span style="color:red">**A**</span> is `BASE`, the common commit where the branches diverged
 

content/en/docs/refguide/general/studio-pro-overview/_index.md

@@ -86,7 +86,7 @@ For example, you can view the [list of errors](/refguide/errors-pane/), run the
 
 At the bottom of the Studio Pro main window pane is a status bar:
 
-{{< figure src="/attachments/refguide/studio-pro-overview/status-bar.png" class="no-border" >}}
+{{< figure src="/attachments/refguide/studio-pro-overview/status-bar.png" class="no-border" alt="Status bar example">}}
 
 On the left is the current status of your app.
 

content/en/docs/refguide/general/studio-pro-overview/keyboard-shortcuts.md

@@ -25,7 +25,7 @@ These keys are active within the [Dockable Panes](#panes) and editors, such as t
 
 You can navigate between Studio Pro panes (for example, the domain model editor or the **Errors** pane) using <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Tab</kbd>. This opens a selection dialog where you can choose a pane using the mouse, <kbd>Ctrl</kbd> + arrow keys, or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Tab</kbd>. You are taken to the selected pane when you click the main mouse button or release the <kbd>Ctrl</kbd> key.
 
-{{< figure src="/attachments/refguide/studio-pro-overview/ctrl-tab-navigation.png" class="no-border" >}}
+{{< figure src="/attachments/refguide/studio-pro-overview/ctrl-tab-navigation.png" class="no-border" alt="Shows pane and editor selection dialog". >}}
 
 There are alternative ways to navigate between tabs within panes: 
 

content/en/docs/refguide/installation/_index.md

@@ -14,3 +14,5 @@ Before installing Studio Pro 11, it is important to understand the [System Requi
 If you have been using Studio Pro 10, see [Upgrading from Mendix Studio Pro 10 to 11](/refguide/upgrading-from-10-to-11/).
 
 ## Documents in This Category
+
+<!-- TODO: Resolve serious flag about how our metadata Lists and Description Lists organize parent and child elements. Direct children are not allowed. Help here: https://dequeuniversity.com/rules/axe/4.13/list?application=AxeChrome&lang=en -->  

content/en/docs/refguide/installation/install.md

@@ -29,7 +29,7 @@ Mendix Studio Pro needs to be installed on your computer before you can start bu
 
 1. Open the downloaded Mendix Studio Pro executable. It is named: *Mendix-11.X.X-Setup.exe*. Then, click **Next**:
 
-    {{< figure src="/attachments/refguide/installation/install/setup-wizard.png" width="500" >}}
+    {{< figure src="/attachments/refguide/installation/install/setup-wizard.png" width="500" alt="Setup wizard screen." >}}
 
 2. Select **I accept the terms in the License Agreement** and click **Next**.
 
@@ -151,7 +151,7 @@ You can download and install [portable version](https://git-scm.com/downloads/wi
 
 Versions of Mendix Studio Pro that are installed via the portable installer do not show up in the Mendix Version Selector where you can manage Mendix versions. However, you can manually add a Studio Pro version by clicking **Add custom version** in **Manage Mendix versions** and specifying the path to the executable file of the Studio Pro version:
 
-{{< figure src="/attachments/refguide/installation/install/version-selector.png"  alt="Version Selector" width="450" class="no-border" >}}
+{{< figure src="/attachments/refguide/installation/install/version-selector.png"  alt="Version Selector" width="450" class="no-border" alt="Shows how to add a custom version and specify its path." >}}
 
 ## Signing In
 
@@ -161,7 +161,7 @@ You can sign in with your Mendix account or with your own company account if thi
 
 In some situations, for example, when your network has a firewall or proxy server, a warning about an untrusted certificate may appear during the sign-in process:
 
-{{< figure src="/attachments/refguide/installation/install/untrusted-certificate.png" width="600px" class="no-border" >}}
+{{< figure src="/attachments/refguide/installation/install/untrusted-certificate.png" width="600px" class="no-border" alt="Untrusted certificate warning dialog." >}}
 
 To continue, you may accept the certificate for the current session by clicking **Accept for this session**, or install it permanently by clicking **View certificate information**. 
 

content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md

@@ -191,6 +191,8 @@ The `com.mendix.storage.s3.EndPoint` setting must either not be set or set to an
 
 When the region is not specified or there is an incompatibility between the two settings above, error logs will contain entries similar to following:
 
+<!-- TODO: change color of "in" as it renders purple, below threshold of required contrast ratio. -->  
+
 ```
 - Unable to load region from any of the providers in the chain.
 - The bucket you are attempting to access must be addressed using the specified endpoint.

content/en/docs/refguide/installation/upgrading-from-10-to-11/atlas4-migration.md

@@ -6,6 +6,8 @@ weight: 10
 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. -->  
+
 ## Introduction
 
 Atlas UI 4 marks a significant evolution in Mendix theming, bringing modern web standards and enhanced flexibility to your application's design. The most significant change to custom styling in Atlas 4 is the shift from **SASS variables** to **native CSS variables**.

content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md

@@ -102,31 +102,31 @@ The conversational interface includes the following features.
 
 Clicking **New Chat** allows you to clear the messages and start a new conversation that does not reference your current chat.
 
-{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/new-chat.jpg" width="250px" alt="" >}}
+{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/new-chat.jpg" width="250px" alt="Click new chat to clear previous messages." >}}
 
 #### Configure MCP Connections
 
 This option ({{% icon name="plug" %}}) allows you to connect external [MCP](https://modelcontextprotocol.io/introduction) servers to Maia, giving it access to third-party tools during chat. For more information on how to configure MCP connections, see [Maia MCP Client](/refguide/maia-mcp/).
 
-{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/configure.jpg" width="250px" alt="" >}}
+{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/configure.jpg" width="250px" alt="Shows the configure MCP connections option." >}}
 
 #### Add
 
 **{{% icon name="paperclip" %}} Add** allows you to attach images, PDFs, or user stories to help Maia understand your requirements better.
 
-{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/add.jpg" width="250px" alt="" >}}
+{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/add.jpg" width="250px" alt="Shows the Add option." >}}
 
 #### Add file to Maia Chat
 
 This option (@ icon) allows you to add certain logic or pages to Maia as context. You can also access this option by right-clicking the documents (microflows or pages) in the **App Explorer**, where it appears in the context menu.
 
-{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/add-files.jpg" width="250px" alt="" >}}
+{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/add-files.jpg" width="250px" alt="Shows the Add File to Maia Chat option." >}}
 
 #### Changed List
 
 A list of items added or changed by Maia appears above the chat box. Click an entry to open the relevant document. To undo all changes, click **Undo all**. To undo a single change, click the undo button on the right side of that item.
 
-{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/changed-list.png" width="250px" alt="" >}}
+{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/changed-list.png" width="250px" alt="Shows the changed list option." >}}
 
 #### Clarifying Questions
 
@@ -191,7 +191,7 @@ To configure an OpenAI-compatible provider, follow these steps:
 
 [Private Mendix Platform](/private-mendix-platform/) provides an environment where you can develop and deploy your applications within your own enterprise security boundary to ensure the highest levels of data security and compliance. Because Private Mendix Platform instances are hosted within the enterprise firewall, selecting an LLM provider other than the default [Mendix Platform](#mendix-platform) requires you to also configure the LLM Gateway URL.
 
-{{< figure src="/attachments/private-platform/pmp-llm-gateway.png" class="no-border" alt="" >}}
+{{< figure src="/attachments/private-platform/pmp-llm-gateway.png" class="no-border" alt="Shows LLM gateway configuration." >}}
 
 The LLM Gateway URL is configured during the installation or upgrade of Private Mendix Platform. For more information, see [Installing Maia for Private Mendix Platform](/private-mendix-platform/interactive-installation/#maia).
 

content/en/docs/refguide/mendix-ai-assistance/start-with-maia.md

@@ -20,12 +20,12 @@ To create an app using **Start with Maia**, do the following:
 1. Open Studio Pro and choose **Create New App**.
 1. Choose the **Start with Maia** starting point.
 
-    {{< figure src="/attachments/refguide/mendix-ai-assistance/start-with-maia/start-with-maia-starting-point.png" >}}
+    {{< figure src="/attachments/refguide/mendix-ai-assistance/start-with-maia/start-with-maia-starting-point.png" alt="The Start with Maia starting point.">}}
 
 1. In the **App Settings** dialog box, click **Create app**.
 1. A blank app is created and the **Start with Maia** dialog box appears:
 
-    {{< figure src="/attachments/refguide/mendix-ai-assistance/start-with-maia/start-with-maia-dialog-box.png" max-width=80% >}}
+    {{< figure src="/attachments/refguide/mendix-ai-assistance/start-with-maia/start-with-maia-dialog-box.png" max-width=80% alt="The start with Maia dialog box.">}}
 
 1. In the **Start with Maia** dialog box, enter a description of the app you want to build. You may optionally attach either an image or a PDF to help Maia better understand your request (only one attachment is allowed. For more information. see the [Attachment Requirements](#attachment-requirements) section below).
 1. Click **Start** and Maia will start generating the following for your app:

content/en/docs/releasenotes/_index.md

@@ -9,6 +9,8 @@ cascade:
     - 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.
 ---
 
 The release notes for the Mendix Platform are divided into the following categories:
+

content/en/docs/releasenotes/deployment/mendix-cloud/2017.md

@@ -129,6 +129,7 @@ weight: 10
 #### Improvements
 
 * For all apps running on the Mendix Cloud, the following HTTP request headers are now available: `SSL-Protocol` (possible values: `TLSv1`, `TLSv1.1`, `TLSv1.2`) and `SSL-Cipher` (for example, `ECDHE-RSA-AES256-GCM-SHA384`). These can be used to block login attempts (for example, `TLSv1` connections). *(Please note that these release notes previously stated the header name was `SSL-Version`, but it should have been `SSL-Protocol`.)*
+<!-- TODO: `SSL-Version` and `SSL-Protocol` styling is a violation of WCAG contrast requirements -->  
 * Modern browsers are aggressively caching static HTML resources, which can lead to user problems after deploying new versions of applications. Clearing the cache can solve this, but that is a bad user experience. So, for all apps running on Mendix Cloud v3, we have added an explicit `no-cache` header to the resources `/` and `/index.html`, `/login.html`, and `/index[0-9].html`. For Mendix Cloud v4, an `expires` with a negative value was already used, so no changes are required there. We believe this change eliminates most of the browser caching issues we have seen so far.
 * You can now restrict access to your Mendix Cloud v4 applications based on IP ranges. This is available for all Mendix Cloud v4 regions and can be configured from the **Connectivity** tab of your cloud environment.
 

content/en/docs/releasenotes/deployment/mendix-cloud/2018.md

@@ -158,7 +158,7 @@ In some cases, you may still experience false positives for the runtime heartbea
 * We have introduced scaling via API for Mendix Cloud v4. It is now possible to scale Mendix Cloud v4 applications via the Deploy API. For instructions, see the [Deploy API](/apidocs-mxsdk/apidocs/deploy-api/).
 * We have aggregated the health icons for the acceptance and test environments in the **Nodes** dashboard and **Company Admin** screen.
 
-    {{< figure src="/attachments/releasenotes/deployment/mendix-cloud/CPHealthIcon.png"   width="300"  class="no-border" >}}
+    {{< figure src="/attachments/releasenotes/deployment/mendix-cloud/CPHealthIcon.png"   width="300"  class="no-border" alt="Health icons in the nodes dashboard and company admin screen." >}}
 
 * The health icon will display the health status of the environment that is in the worst condition. This is to prepare for an upcoming release that will support more than three environments per application.
 

content/en/docs/releasenotes/deployment/mendix-cloud/2019.md

@@ -71,6 +71,8 @@ We have renewed the SSL/TLS certificate for `*.mendixcloud.com`. Browsers like M
 If you run services that connect to a `*.mendixcloud.com` endpoint AND use a static or outdated trust store, we advise you to update them. The new SSL/TLS certificate can be downloaded [here](/attachments/releasenotes/deployment/mendix-cloud/mendixcloud.com-2019-09-12.crt.txt).
 {{% /alert %}}
 
+<!-- TODO: change color of CODE TICKED text when it is in WARNINGS so it meets WCAG contrast ratios. The current red is a little too bright to meet the requirements. -->  
+
 **Current Certificate Details**
 
 * Subject: `*.mendixcloud.com`

content/en/docs/releasenotes/deployment/mendix-cloud/2023.md

@@ -67,6 +67,8 @@ weight: 4
     | Between 20 and 400 GiB | gp3                   | 3000 IOPS / 125 MiB/s             | N/A                    | N/A                          |
     | 400 GiB and higher     | gp3                   | 12000 IOPS / 500 MiB/s            | 12000 - 64000 IOPS     | 500 - 4000 MiB/s             |
 
+ <!-- TODO: table above flagged for safari keyboard issue -->  
+
     * Existing databases eligible for this upgrade will be migrated later. More details will follow.
 
     * For more information, see [Database IOPS Burst Balance](/developerportal/operate/metrics/#Trends-dbmxdatabaseburstbalance) in the *Metrics* documentation.

content/en/docs/releasenotes/deployment/mendix-cloud/2024.md

@@ -128,6 +128,8 @@ weight: 3
     | Between 20 and 400 GiB | gp3                   | 3000 IOPS / 125 MiB/s             | N/A                    | N/A                          |
     | 400 GiB and higher     | gp3                   | 12000 IOPS / 500 MiB/s            | 12000 - 64000 IOPS     | 500 - 4000 MiB/s             |
 
+ <!-- TODO: table above flagged for safari keyboard issue -->  
+
 ### March 7, 2024
 
 #### Bug Fixes