Add alt text

api-playground/troubleshooting.mdx

@@ -7,7 +7,7 @@
 
 <AccordionGroup>
   <Accordion title="All of my OpenAPI pages are completely blank">
     In this scenario, it's likely that either Mintlify cannot find your OpenAPI document,
     or your OpenAPI document is invalid.
 
     Running `mint dev` locally should reveal some of these issues.
@@ -27,7 +27,7 @@
     you could encounter this issue. You can convert your document at [editor.swagger.io](https://editor.swagger.io/) (under Edit \> Convert to OpenAPI 3):
 
     <Frame>
-      ![](/images/convert-oas-3.png)
+      ![Screenshot of the Swagger Editor with the Edit menu expanded and the "Convert to OpenAPI 3" menu item highlighted.](/images/convert-oas-3.png)
     </Frame>
   </Accordion>
   <Accordion title="One of my OpenAPI pages is completely blank">
@@ -64,8 +64,8 @@
   <Accordion title="Requests from the API Playground don't work">
     If you have a custom domain configured, this could be an issue with your reverse proxy. By
     default, requests made via the API Playground start with a `POST` request to the
     `/_mintlify/api/request` path on the docs site. If your reverse proxy is configured to only allow `GET`
     requests, then all of these requests will fail. To fix this, configure your reverse proxy to
     allow `POST` requests to the `/_mintlify/api/request` path.
 
     Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described in the [settings documentation](/organize/settings#param-proxy). When using this configuration, you will need to configure CORS on your server since requests will come directly from users' browsers rather than through your proxy.

components/update.mdx

@@ -14,14 +14,14 @@
     <img
       className="block"
       src="https://mintlify-assets.b-cdn.net/hero-light.png"
-      alt=""
+      alt="Screenshot of the PearsDB Introduction page as an example of an image in an Update component."
     />
   </Frame>
 
   ### Features
   - Responsive design
   - Anchor for each update
   - Generated RSS feed entry for each update
 </Update>
 
 ## How to use

dashboard/sso.mdx

@@ -1,25 +1,25 @@
 ---
 title: "Single sign-on (SSO)"
 description: "Customize how your team can login to your admin dashboard"
 ---
 
 <Info>
   SSO functionality is available on [Enterprise plan](https://mintlify.com/pricing?ref=sso).
 </Info>
 
 Use single sign-on to your dashboard via SAML and OIDC. If you use Okta, Google Workspace, or Microsoft Entra, we have provider-specific documentation for setting up SSO. If you use another provider, please [contact us](mailto:[email protected]).
 
 ## Okta
 
 <Tabs>
     <Tab title="SAML">
         <Steps>
             <Step title="Create an application">
                 Under `Applications`, click to create a new app integration using SAML 2.0.
             </Step>
             <Step title="Configure integration">
                 Enter the following:
                 * Single sign-on URL (provided by Mintlify)
                 * Audience URI (provided by Mintlify)
                 * Name ID Format: `EmailAddress`
                 * Attribute Statements:
@@ -28,13 +28,13 @@
                     | `firstName` | Basic | `user.firstName` |
                     | `lastName` | Basic | `user.lastName` |
             </Step>
             <Step title="Send us your IdP information">
                 Once the application is set up, navigate to the sign-on tab and send us the metadata URL.
                 We'll enable the connection from our side using this information.
             </Step>
         </Steps>
     </Tab>
     <Tab title="OIDC">
         <Steps>
             <Step title="Create an application">
                 Under `Applications`, click to create a new app integration using OIDC.
@@ -44,14 +44,14 @@
                 Select the authorization code grant type and enter the Redirect URI provided by Mintlify.
             </Step>
             <Step title="Send us your IdP information">
                 Once the application is set up, navigate to the General tab and locate the client ID & client secret.
                 Please securely provide us with these, along with your Okta instance URL (for example, `<your-tenant-name>.okta.com`). You can send these via a service like 1Password or SendSafely.
             </Step>
         </Steps>
     </Tab>
 </Tabs>
 
 ## Google Workspace
 
 <Tabs>
     <Tab title="SAML">
@@ -59,24 +59,24 @@
             <Step title="Create an application">
                 Under `Web and mobile apps`, select `Add custom SAML app` from the `Add app` dropdown.  
                 <Frame>
-                    ![](/images/gsuite-add-custom-saml-app.png)
+                    ![Screenshot of the Google Workspace SAML application creation page with the "Add custom SAML app" menu item highlighted](/images/gsuite-add-custom-saml-app.png)
                 </Frame>              
             </Step>
             <Step title="Send us your IdP information">
                 Copy the provided SSO URL, Entity ID, and x509 certificate and send it to the Mintlify team.
                 <Frame>
-                    ![](/images/gsuite-saml-metadata.png)                    
+                    ![Screenshot of the Google Workspace SAML application page with the SSO URL, Entity ID, and x509 certificate highlighted. The specific values for each of these are blurred out.](/images/gsuite-saml-metadata.png)                    
                 </Frame>
             </Step>
             <Step title="Configure integration">
                 On the Service provider details page, enter the following:
                 * ACS URL (provided by Mintlify)
                 * Entity ID (provided by Mintlify)
                 * Name ID format: `EMAIL`
                 * Name ID: `Basic Information > Primary email`
 
                 <Frame>
-                    ![](/images/gsuite-sp-details.png)
+                    ![Screenshot of the Service provider details page with the ACS URL and Entity ID input fields highlighted.](/images/gsuite-sp-details.png)
                 </Frame>
 
                 On the next page, enter the following attribute statements:
@@ -94,16 +94,16 @@
 ## Microsoft Entra
 
 <Tabs>
     <Tab title="SAML">
         <Steps>
             <Step title="Create an application">
                 1. Under "Enterprise applications," select **New application**.
                 2. Select **Create your own application** and choose "Integrate any other application you don't find in the gallery (Non-gallery)."
             </Step>
             <Step title="Configure SAML">
                 Navigate to the Single Sign-On setup page and select **SAML**. Under "Basic SAML Configuration," enter the following:
                 * Identifier (Entity ID): The Audience URI provided by Mintlify.
                 * Reply URL (Assertion Consumer Service URL): The ACS URL provided by Mintlify.
 
                 Leave the other values blank and select **Save**.
             </Step>

deploy/gitlab.mdx

@@ -3,15 +3,15 @@
 description: "Sync your docs with a GitLab repo"
 ---
 
 We use access tokens and webhooks to authenticate and sync changes between GitLab and Mintlify.
 
 - Mintlify uses access tokens to pull information from GitLab.
 - GitLab uses webhooks to notify Mintlify when changes are made, enabling preview deployments for merge requests.
 
 ## Set up the connection
 
 <Note>
   **HTTPS cloning required**: Your GitLab project must have HTTPS cloning enabled for Mintlify to access your repository. You can verify this in GitLab by going to your project's **Settings** > **General** > **Visibility and access controls** section.
 </Note>
 
 <Steps>
@@ -53,13 +53,13 @@
 
 ## Create the webhook
 
 Webhooks allow us to receive events when changes are made so that we can
 automatically trigger deployments.
 
 <Steps>
   <Step title="Navigate to Settings > Webhooks and click 'Add new Webhook'">
     <Frame>
-      <img src="/images/gitlab/gitlab-webhook.png" />
+      <img src="/images/gitlab/gitlab-webhook.png" alt="Screenshot of the Webhooks page in the GitLab dashboard." />
     </Frame>
   </Step>
   <Step title="Set up URL and webhook">
@@ -69,12 +69,12 @@
   <Step title="Paste token">
     Paste the Webhook token generated after setting up the connection.
     <Frame>
-      <img src="/images/gitlab/gitlab-show-webtoken.png" />
+      <img src="/images/gitlab/gitlab-show-webtoken.png" alt="Screenshot of the GitLab connection in the Mintlify dashboard. The Show Webtoken button is highlighted." />
     </Frame>
   </Step>
   <Step title="Select events">
     Select these events to trigger the webhook:
     - **Push events** (All branches)
     - **Merge requests events**
 
     When you're done it should look like this:
@@ -83,11 +83,11 @@
     </Frame>
   </Step>
   <Step title="Test the Webhook">
     After creating the Webhook, click the "Test" dropdown and select "Push events" to send a sample payload to ensure it's configured correctly. It'll say "Hook executed successfully: HTTP 200" if configured correctly.
 
     This will help you verify that everything is working correctly and that your documentation will sync properly with your GitLab repository.
     <Frame>
-      <img src="/images/gitlab/gitlab-project-webtoken-test.png" />
+      <img src="/images/gitlab/gitlab-project-webtoken-test.png" alt="Screenshot of the GitLab Webhooks page. The 'Push events' menu item is highlighted in the 'Test' menu." />
     </Frame>
 
   </Step>