Fix Vale style warnings from CI checks (#4348)

* Fix Vale style warnings from recent PRs

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

Author: mintlify-development[bot]

.vale/styles/Mintlify/Acronyms.yml

@@ -51,6 +51,7 @@ exceptions:
   - PHP
   - PNG
   - POST
+  - PST
   - RAG
   - RAM
   - REPL
@@ -59,6 +60,7 @@ exceptions:
   - SCM
   - SCSS
   - SDK
+  - SLA
   - SQL
   - SSH
   - SSL
@@ -72,6 +74,7 @@ exceptions:
   - URL
   - USB
   - UTF
+  - VPN
   - WOFF
   - XML
   - XSS

.vale/styles/Mintlify/Headings.yml

@@ -8,15 +8,19 @@ indicators:
 exceptions:
   - Azure
   - CLI
+  - CSM
+  - Discord
   - Docker
   - Emmet
+  - FAQ
   - I
   - Kubernetes
   - Linux
   - macOS
   - Marketplace
   - MongoDB
   - REPL
+  - Slack
   - Studio
   - TypeScript
   - URL

advanced-support.mdx

@@ -45,7 +45,7 @@ Get an assigned Customer Success Manager who knows your team, setup, and goals.
 
 <AccordionGroup>
   <Accordion title="What's the difference between a dedicated CSM and standard support?">
-    Standard support is delivered via the dashboard or support@mintlify.com with a 24-48 hour response SLA. A Dedicated CSM includes both a primary point of contact and a dedicated Slack channel. The main differences are:
+    We deliver standard support via the dashboard or support@mintlify.com with a 24-48 hour response SLA. A Dedicated CSM includes both a primary point of contact and a dedicated Slack channel. The main differences are:
 
     - **Response time:** 4 hours for US customers during business hours versus 24-48 hours for standard support
     - **Relationship:** One person who knows your setup versus a support team rotation
@@ -82,7 +82,7 @@ Get an assigned Customer Success Manager who knows your team, setup, and goals.
 
 <AccordionGroup>
   <Accordion title="What's the difference between advanced Slack support and standard support?">
-    Standard support (included with Pro and Enterprise plans) is delivered via the dashboard or support@mintlify.com with a 24-48 hour response SLA. Advanced Slack support includes:
+    We deliver standard support (included with Pro and Enterprise plans) via the dashboard or support@mintlify.com with a 24-48 hour response SLA. Advanced Slack support includes:
 
     - Dedicated Slack channel versus email/dashboard support
     - 24-hour response SLA versus 24-48 hours for standard support

agent/use-cases.mdx

@@ -62,7 +62,7 @@ For example: `@mintlify Users are getting confused by step 3 in the setup guide.
 
 ## Automate with workflows
 
-Create workflows to automate recurring tasks and reactive maintenance tasks like writing changelogs or updating content when new features are added to your product.
+Create workflows to automate recurring tasks and reactive maintenance tasks like writing changelogs or updating content when you add new features to your product.
 
 See [Workflows](/agent/workflows) for more information.
 

ai/model-context-protocol.mdx

@@ -46,7 +46,7 @@ AI tools can search the web, but MCP provides distinct advantages for documentat
 Mintlify generates an MCP server for your documentation and hosts it at the `/mcp` path of your documentation URL. For example, Mintlify's MCP server is available at `https://mintlify.com/docs/mcp`.
 
 * For public documentation, your MCP server is available to anyone. It searches all indexed public pages.
-* For documentation with partial authentication, where some pages are public and others are protected, you must enable your MCP server before it is available to users. Unauthenticated users can search public content. Users who authenticate can search all content they have permission to access based on their [user groups](/deploy/authentication-setup).
+* For documentation with partial authentication, where some pages are public and others require login, you must enable your MCP server before users can access it. Unauthenticated users can search public content. Users who authenticate can search all content they have permission to access based on their [user groups](/deploy/authentication-setup).
 * For documentation where all pages require authentication, you must enable your MCP server before it is available to users. Users must authenticate before connecting to your MCP server. Your MCP server searches only the content each user has access to based on their [user groups](/deploy/authentication-setup).
 
 View and copy your MCP server URL on the [MCP server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.

installation.mdx

@@ -181,7 +181,7 @@ Identify broken links in your documentation:
 mint broken-links
 ```
 
-The command ignores files matching [.mintignore](/organize/mintignore) patterns. Links that point to ignored files are reported as broken.
+The command ignores files matching [.mintignore](/organize/mintignore) patterns. The command reports links that point to ignored files as broken.
 
 By default, the command checks only internal links. Use flags to expand the scope:
 

organize/navigation.mdx

@@ -517,7 +517,7 @@ In the `navigation` object, `versions` is an array where each entry is an object
 
 ### Default version
 
-The first version in the `versions` array is used as the default version. Use the `default` field to specify a different version as the default.
+Mintlify uses the first version in the `versions` array as the default. Use the `default` field to specify a different version as the default.
 
 ```json
 {
@@ -727,7 +727,7 @@ For automated translations, [contact our sales team](mailto:gtm@mintlify.com) to
 
 ## Nesting
 
-Navigation elements can be nested within each other to create complex hierarchies. You must have one root-level parent navigation element such as tabs, groups, or a dropdown. You can nest other types of navigation elements within your primary navigation pattern.
+You can nest navigation elements within each other to create complex hierarchies. You must have one root-level parent navigation element such as tabs, groups, or a dropdown. You can nest other types of navigation elements within your primary navigation pattern.
 
 Each navigation element can contain one type of child element at each level of your navigation hierarchy. For example, a tab can contain anchors that contain groups, but a tab cannot contain both anchors and groups at the same level.
 

organize/settings.mdx

@@ -348,11 +348,11 @@ This section contains the full reference for the `docs.json` file.
 </ResponseField>
 
 <ResponseField name="variables" type="object">
-  Global variables for use throughout your documentation. Variables are replaced at build time using `{{variableName}}` syntax.
+  Global variables for use throughout your documentation. Mintlify replaces variables at build time using `{{variableName}}` syntax.
 
   <Expandable title="Variables">
     <ResponseField name="variableName" type="string">
-      A key-value pair where the key is the variable name and the value is the replacement text. All variables referenced in your content must be defined, or the build fails. Variable names can contain alphanumeric characters, hyphens, and periods. Values are sanitized to prevent XSS attacks.
+      A key-value pair where the key is the variable name and the value is the replacement text. You must define all variables referenced in your content, or the build fails. Variable names can contain alphanumeric characters, hyphens, and periods. Mintlify sanitizes values to prevent XSS attacks.
     </ResponseField>
   </Expandable>
 </ResponseField>