Vale style audit: fix em-dash spacing and tune Acronyms/kbd scopes

.vale.ini

@@ -2,7 +2,7 @@
 
 StylesPath = .vale/styles
 MinAlertLevel = suggestion
-IgnoredScopes = code, tt, img, url, a
+IgnoredScopes = code, tt, img, url, a, kbd
 SkippedScopes = script, style, pre, figure, code
 
 Vocab = Mintlify

.vale/styles/Mintlify/Acronyms.yml

@@ -8,36 +8,54 @@ second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
 # ... with the exception of these:
 exceptions:
   - AAA
+  - ACS
+  - AEO
+  - ANSI
   - API
   - ASCII
   - ASP
+  - AWS
   - BETA
+  - CAA
+  - CDN
+  - CIDR
   - CLI
+  - CNAME
   - CPU
   - CRM
+  - CSP
   - CSS
   - CSV
+  - CTA
+  - CTR
   - DEBUG
+  - DNS
+  - DOCX
   - DOM
   - DPI
   - FAQ
   - GCC
   - GDB
+  - GEO
   - GET
   - GIF
   - GPU
   - GTK
   - GUI
+  - HEAD
   - HTML
   - HTTP
   - HTTPS
+  - IAM
   - ICO
   - IDE
+  - ISO
   - JAR
   - JIT
   - JPEG
   - JPG
   - JSON
+  - JSONC
   - JSX
   - JWT
   - LESS
@@ -46,27 +64,39 @@ exceptions:
   - llms
   - LLMs
   - LTS
+  - MCP
+  - MDX
+  - NAT
   - NET
   - NEW
   - NOT
   - NOTE
   - NVDA
+  - OAI
+  - OIDC
   - OSS
+  - PATCH
   - PATH
   - PDF
   - PHP
   - PNG
   - POST
   - PST
+  - PUT
   - RAG
   - RAM
+  - RBAC
   - REPL
   - REST
+  - ROI
+  - RPC
   - RSA
   - SAML
+  - SCIM
   - SCM
   - SCSS
   - SDK
+  - SEO
   - SKILL
   - SLA
   - SQL
@@ -76,16 +106,23 @@ exceptions:
   - SVG
   - TBD
   - TCP
+  - TLS
   - TODO
+  - TOML
+  - TSV
   - TTF
+  - TXT
   - URI
   - URL
   - USB
+  - UTC
   - UTF
   - UUID
   - VPN
+  - WAVE
   - WOFF
   - XML
   - XSS
   - YAML
+  - YYYY
   - ZIP

api-playground/sdk-reference-setup.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Generate SDK reference pages from doc-tool output"
 sidebarTitle: "SDK reference setup"
 description: "Publish SDK reference documentation in Mintlify from TypeDoc, DocFX, Javadoc, Sphinx, or phpDocumentor artifacts using the sdk navigation property."
 keywords: ["sdk", "typedoc", "docfx", "javadoc", "sphinx", "phpdocumentor", "reference"]
 ---
 
@@ -57,15 +57,15 @@
       "tab": "SDK Reference",
       "sdk": {
         "format": "typedoc",
         "source": "sdk-artifacts/typedoc.json",
         "directory": "sdk/typescript"
       }
     }
   ]
 }
 ```
 
-Add `sdk` to a [group](/organize/navigation#groups) to generate pages inside one section of a tab instead of an entire tab. Groups and pages inherit the `sdk` settings of the tab or group above them. If a nested group sets its own `sdk`, Mintlify uses those settings instead of the inherited ones.
+Add `sdk` to a [group](/organize/navigation#groups) to generate pages inside one section of a tab instead of an entire tab. Groups and pages inherit the `sdk` settings of the parent tab or group. If a nested group sets its own `sdk`, Mintlify uses those settings instead of the inherited ones.
 
 ```json
 {

assistant/use.mdx

@@ -129,11 +129,11 @@ Limits:
 
   **For readers:** Ask your IT team to allow outbound HTTPS requests to the following hostnames from your network. If you can, try the assistant from a personal network to confirm the issue is network-specific.
 
-  - `leaves.mintlify.com` — assistant API
-  - `*.mintlify.dev` — assistant streaming and supporting services
-  - `*.mintlify.com` — dashboard, API, and analytics
-  - `hcaptcha.com` and `*.hcaptcha.com` — CAPTCHA verification for the assistant
+  - `leaves.mintlify.com`—assistant API
+  - `*.mintlify.dev`—assistant streaming and supporting services
+  - `*.mintlify.com`—dashboard, API, and analytics
+  - `hcaptcha.com` and `*.hcaptcha.com`—CAPTCHA verification for the assistant
 
-  **For site owners:** If a reader reports that the assistant does not load on their corporate network or VPN, treat it as an outbound network block. It is not a problem with your documentation. Point them to the hostnames above and suggest that they share the list with their IT team. This allowlist applies to the visitor's device or network. You cannot configure it from your site. If you self-host behind a reverse proxy that overwrites the default CSP, see [CSP configuration](/deploy/csp-configuration) for the domains to allow.
+  **For site owners:** If a reader reports that the assistant does not load on their corporate network or VPN, treat it as an outbound network block. It is not a problem with your documentation. Point them to the preceding hostnames and suggest that they share the list with their IT team. This allowlist applies to the visitor's device or network. You cannot configure it from your site. If you self-host behind a reverse proxy that overwrites the default CSP, see [CSP configuration](/deploy/csp-configuration) for the domains to allow.
 
 </Accordion>

assistant/widget.mdx

@@ -10,7 +10,7 @@
 
 export const WidgetCodeBlock = ({ children, ...props }) => (
   <CodeBlock {...props}>{children}</CodeBlock>
 );
 
 The [assistant](/assistant) answers questions on your Mintlify site. To embed the same capability on another site or web app, use the widget. The widget gives your users access to AI chat trained on your content, wherever they use your product. Embed it in your dashboard, marketing site, support portal, or elsewhere.
 
@@ -279,7 +279,7 @@
 
 Conversation snapshots remain private to the widget. Each method resolves to `void`.
 
 ## Content Security Policy
 
 If your site uses a Content Security Policy, allow the origins required by your enabled widget features:
 
@@ -290,10 +290,10 @@
 | `connect-src`                                | `https://api.mintlify.com`          | Configuration, messages, and feedback |
 | `connect-src`                                | `https://ph.mintlify.com`           | Internal widget analytics             |
 | `font-src`                                   | `https://widget.mintlify.com`       | Optional bundled Inter font           |
 | `script-src`, `connect-src`, and `frame-src` | `https://challenges.cloudflare.com` | Turnstile bot protection              |
 | `script-src`                                 | `https://js.hcaptcha.com`           | hCaptcha bot protection               |
 | `connect-src` and `frame-src`                | `https://*.hcaptcha.com`            | hCaptcha bot protection               |
 
-A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected stylesheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization.
+A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected style sheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization.
 
 </AssistantWidgetPlayground>