Fix vale errors (#1213)

* don't lint inside JSON examples

* actually don't lint inside JSON snippets

* update vocab

* fix errors

* update vocab

* remove latin abbreviations

* don't lint snippets

* update vocab

* don't lint in angle brackets

* add language tags

* update vocab

* regexify vocab list

* grammar

Author: ethanpalm

.vale.ini

@@ -22,7 +22,8 @@ Vale.Avoid = NO # Too aggressive about common technical terms
 # Token and block ignores for MDX-specific syntax
 TokenIgnores = (?sm)((?:import|export) .+?$), \
 (?<!`)(<\w+ ?.+ ?\/>)(?!`), \
-(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
+(<[A-Z]\w+>.+?<\/[A-Z]\w+>), \
+(<[^>]*>)
 
 BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
 (?sm)^({.+.*})

.vale/styles/Google/Quotes.yml

@@ -4,4 +4,5 @@ link: 'https://developers.google.com/style/quotation-marks'
 level: error
 nonword: true
 tokens:
-  - '"[^"]+"[.,?]'
+  # Match quotes with trailing punctuation, but exclude content in JSON
+  - '(?<!^\s*)"[^"]+"[.,?](?!\s*$)'

.vale/styles/config/vocabularies/Mintlify/accept.txt

@@ -8,83 +8,87 @@ bearerAuth
 borderRadius
 camelCase
 discoverability
-callout
-Callouts
-callouts
+(?i)callouts?
 drilldown
 expandables
 favicon
 isHidden
-Mintlify
-mintlify
-modeToggle
-ModeToggle
+(?i)mintlify
+(?i)modetoggle
 myName
 myObject
 onboarding
-openapi
-OpenAPI
+(?i)openapi
 repo
 topbar
-tooltip
-Tooltip
-tooltips
+(?i)tooltips?
 url
 
 # =============================================================================
-# PROGRAMMING LANGUAGES & FRAMEWORKS
+# NAMES OF THINGS
 # =============================================================================
 Angular
 AWS
 Azure
-Babel
-babel
+(?i)babel
 Bitbucket
+(?i)chatgpt
+(?i)claude
+CloudFront
 Chromium
 CircleCI
+Clearbit
+Ctrl
 Cypress
 Django
 DynamoDB
 Elasticsearch
-ESLint
-eslint
+Entra
+(?i)eslint
 Express
 Firefox
 Flask
 GCP
-Git
-git
+(?i)git
 GitHub
 GitLab
 Go
 Golang
 GraphQL
 Heroku
+Hightouch
 IntelliJ
 Java
 JavaScript
-Jest
-jest
+(?i)jest
 JSDoc
 Kotlin
 Kubernetes
 Laravel
 Linux
+LLMs
+Lucide
 macOS
+(?i)mcp
 MDX
+Mixpanel
 Mocha
 MongoDB
 MySQL
 Next.js
 Node.js
 NodeJS
+npx
 Nuxt
 OAuth
+Okta
+Osano
+Pirsch
 PNPM
+Posthog
 Postman
 PostgreSQL
-Prettier
-prettier
+(?i)prettier
 Python
 React
 Redis
@@ -100,27 +104,29 @@ Terraform
 TypeDoc
 TypeScript
 Unix
-Vercel
-vercel
-Vite
-vite
+(?i)vercel
+(?i)vite
 Visual Studio Code
 VS Code
+vscode
 Vue
 Vuex
 Webflow
 WebKit
-Webpack
-webpack
+(?i)webpack
 WebStorm
+Zapier
 
 # =============================================================================
 # TERMS
 # =============================================================================
+agentic
 allowlist
 APIs
 args
 async
+autogenerated
+autogenerating
 await
 bool
 boolean
@@ -145,14 +151,18 @@ elem
 enum
 env
 err
+favicons
 func
+frontmatter
+Gantt
 gui
 href
 html
 http
 https
 ide
 impl
+ingestible
 init
 instanceof
 jvm
@@ -164,6 +174,7 @@ md
 middleware
 Multiline
 mvc
+monorepo
 nav
 next
 nodejs
@@ -175,16 +186,22 @@ orm
 params
 pnpm
 png
+prepend
+prepended
 prev
 proc
+proxied
+proxying
 ptr
 pytest
 req
 res
 rpc
 runtime
 scss
+SDKs
 sdk
+serverless
 Singleline
 sql
 ssh
@@ -194,16 +211,23 @@ stdin
 stdout
 Strikethrough
 struct
+subpaths
+subschema
+Subscribable
+subscribable
+SVGs
 svg
 tcp
 tls
 tmp
 toc
 todo
+transpilation
 tsx
 TTL
 typeof
 ui
+uncached
 undefined
 uri
 ux
@@ -217,3 +241,10 @@ xhr2
 yaml
 yarn
 yml
+
+# =============================================================================
+# LOCALIZATION
+# =============================================================================
+cn
+ko
+ru

advanced/dashboard/sso.mdx

@@ -45,7 +45,7 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta, Google
             </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 (e.g. `<your-tenant-name>.okta.com`). You can send these via a service like 1Password or SendSafely.
+                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>
@@ -97,7 +97,7 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta, Google
     <Tab title="SAML">
         <Steps>
             <Step title="Create an application">
-                1. Under "Enterprise applications", select **New 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">

advanced/subpath/route53-cloudfront.mdx

@@ -70,7 +70,7 @@ All Behaviors must have the an **origin request policy** of `AllViewerExceptHost
   If you use Vercel, use the `.vercel.app` domain available for every project.
 </Info>
 
-3. Create a new Origin and add your staging URL as the "Origin domain".
+3. Create a new Origin and add your staging URL as the "Origin domain."
 
   <Frame>
     ![CloudFront "Create origin" page with a "Origin domain" input field highlighted.](/images/cloudfront/default-origin.png)
@@ -101,7 +101,7 @@ Behaviors in CloudFront enable control over the subpath logic. At a high level,
 
 Create behaviors for Vercel domain verification paths with a **Path pattern** of `/.well-known/*` and set **Origin and origin groups** to your docs URL.
 
-For "Cache policy", select **CachingDisabled** to ensure these verification requests pass through without caching.
+For "Cache policy," select **CachingDisabled** to ensure these verification requests pass through without caching.
 
 <Frame>
   ![CloudFront "Create behavior" page with a "Path pattern" of "/.well-known/*" and "Origin and origin groups" pointing to the staging URL.](/images/cloudfront/well-known-policy.png)

changelog.mdx

@@ -184,7 +184,7 @@ noindex: true
   ## API playground enhancements
 
   - New [Search API endpoint](https://mintlify.com/docs/api-reference/assistant/search) so you can build agents and MCP servers on top of your docs
-  - `openapi` and `asyncapi` files are now served at their specified paths (e.g. `https://mydocsurl.extension/{openapi-or-file-name}.json`)
+  - `openapi` and `asyncapi` files are now served at their specified paths (for example, `https://mydocsurl.extension/{openapi-or-file-name}.json`)
   - You can now use the [`x-mint` field in your openapi files](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) to override generated fields, customize preface content, or change endpoint URLs in code samples
   - [`x-mcp` is now `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) in OpenAPI configurations to control which routes are exposed as MCP tools
 
@@ -426,7 +426,7 @@ noindex: true
   ## AI Assistant Improvements
 
   - New UI with dedicated chat page & pre-filled prompts
-  - Stability improvements, e.g. bug fixes of editing the wrong file or no files at all
+  - Stability improvements. For example, bug fixes of editing the wrong file or no files at all
   - More robust knowledge for adding & editing components
   - Improved `docs.json` file editing
 
@@ -439,7 +439,7 @@ noindex: true
   We’ve overhauled the design and performance of the [API Playground](/api-playground/). Updates include:
 
   - Easier detail expansion for an overview of a field
-  - More intuitive nested design, e.g. adding or deleting items
+  - More intuitive nested design. For example, adding or deleting items
   - Faster response times
 
   ## Quality Improvements

components/cards.mdx

@@ -107,7 +107,7 @@ Use the [Columns component](/components/columns) to organize multiple cards side
 <IconsOptional />
 
 <ResponseField name="color" type="string">
-  Icon color as a hex code (e.g., `#FF6B6B`).
+  Icon color as a hex code (for example, `#FF6B6B`).
 </ResponseField>
 
 <ResponseField name="href" type="string">

guides/auth0.mdx

@@ -13,7 +13,7 @@ This guide walks you through setting up Auth0 as an authentication provider for
 
 <Steps>
   <Step title="Create a Regular Web Application in Auth0">
-    Log in to your Auth0 dashboard and navigate to **Applications** > **Applications**. Click the **Create Application** button, give your application a name (e.g., "Mintlify"), and select **Regular Web Applications** as the application type. Then click **Create**.
+    Log in to your Auth0 dashboard and navigate to **Applications** > **Applications**. Click the **Create Application** button, give your application a name (for example, "Mintlify"), and select **Regular Web Applications** as the application type. Then click **Create**.
 
     <Frame>![Creating a new application in Auth0](/images/guides/auth0/auth0-create-application.png)</Frame>
   </Step>
@@ -23,7 +23,7 @@ This guide walks you through setting up Auth0 as an authentication provider for
     <Frame>![Auth0 client settings page](/images/guides/auth0/auth0clientsettings.png)</Frame>
 
     Make note of the following information:
-    - **Domain**: This is your Auth0 tenant domain (e.g., `your-tenant.auth0.com`)
+    - **Domain**: This is your Auth0 tenant domain (for example, `your-tenant.auth0.com`)
     - **Client ID**: The public identifier for your application
     - **Client Secret**: The secret key for your application (keep this secure)
 

image-embeds.mdx

@@ -32,7 +32,7 @@ Use [Markdown syntax](https://www.markdownguide.org/basic-syntax/#images) to add
   Always include descriptive alt text to improve accessibility and SEO. The alt text should clearly describe what the image shows.
 </Tip>
 
-Image files must be less than 20MB. For larger files, host them on a CDN service like [Amazon S3](https://aws.amazon.com/s3) or [Cloudinary](https://cloudinary.com).
+Image files must be less than 20 MB. For larger files, host them on a CDN service like [Amazon S3](https://aws.amazon.com/s3) or [Cloudinary](https://cloudinary.com).
 
 ### HTML image embeds
 

installation.mdx

@@ -116,7 +116,7 @@ You can use the CLI to check your OpenAPI file for errors using the following co
 mint openapi-check <openapiFilenameOrUrl>
 ```
 
-You can pass in a filename (e.g. `./openapi.yaml`) or a URL (e.g. `https://petstore3.swagger.io/api/v3/openapi.json`).
+You can pass in a filename (for example, `./openapi.yaml`) or a URL (for example, `https://petstore3.swagger.io/api/v3/openapi.json`).
 
 ### Renaming files