Fix documentation regressions

Author: cursoragent

.vale.ini

@@ -2,7 +2,7 @@
 
 StylesPath = .vale/styles
 MinAlertLevel = suggestion
-IgnoredScopes = code, code, tt, img, url, a
+IgnoredScopes = code, tt, img, url, a
 SkippedScopes = script, style, pre, figure, code
 
 Vocab = Mintlify
@@ -20,43 +20,24 @@ TokenIgnores = (?m)((?:import|export) .+?$), \
 (?<!`)(<\w+ ?.+ ?\/>)(?!`), \
 (<[A-Z]\w+>.+?<\/[A-Z]\w+>), \
 (<[^>]*>), \
-\{(?!/\*)(?!/\*)[^}]*\}, \
-(`[^`]*`), \, \
-(?m)^openapi: .+$, \(?m)^openapi: .+$, \
-([\w-]+\.)+(?:json|jsonl|png|jpe?g|gif|svg|mdx?|txt|ya?ml|xml|com|dev|io|ts|js|tsx|jsx), \
-[\w-]+="[^"\n]*", \
-[\w.+-]+@[\w.-]+, \
-\(/[^)\s]*\)
-
+\{(?!/\*)[^}]*\}, \
+(`[^`]*`), \
+(?m)^openapi: .+$, \
 ([\w-]+\.)+(?:json|jsonl|png|jpe?g|gif|svg|mdx?|txt|ya?ml|xml|com|dev|io|ts|js|tsx|jsx), \
 [\w-]+="[^"\n]*", \
 [\w.+-]+@[\w.-]+, \
 \(/[^)\s]*\)
 
 BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({(?!/\*)(?!/\*).+??})$, \
-(?sm)^[ \t]*[ \t]*```[\s\S]*?```$
+(?sm)^({(?!/\*).+?})$, \
+(?sm)^[ \t]*```[\s\S]*?```$
 
 CommentDelimiters = {/*, */}
 
 [changelog.mdx]
 BasedOnStyles = ""
 
 # Code-generator snippet with no prose content
-# Code-generator snippet with no prose content
-[snippets/vercel-json-generator.mdx]
-BasedOnStyles = ""
-
-# Component docs use dotted JSX names (Color.Row, Tree.Folder) that
-# false-positive the sentence-spacing rule
-[components/{color,tree}.mdx]
-Mintlify.Spacing = NO
-
-# Vale lints /api-playground/... link targets in these files in a pass
-# that ignores in-document toggles
-[{api-playground/asyncapi-setup.mdx,organize/settings-reference.mdx}]
-Vale.Terms = NO
-
 [snippets/vercel-json-generator.mdx]
 BasedOnStyles = ""
 

ai-native.mdx

@@ -5,11 +5,6 @@ description: "Discover how AI-native features enhance reading, writing, and disc
 keywords: ["AI", "assistant", "agent", "llms.txt", "MCP", "llms-full.txt"]
 ---
 
-| rob |  |  |
-| --- | --- | --- |
-|  |  |  |
-|  |  |  |
-
 When you host your documentation on Mintlify, built-in AI features help your users find answers and your team maintain content more efficiently. Your content provides the context for these AI-native features to improve the experiences of reading, writing, and discovering your documentation.
 
 ## What makes your documentation AI-native

ai/mintlify-mcp.mdx

@@ -42,7 +42,7 @@ Before connecting the admin MCP, confirm the following:Before connecting the adm
 
 ## Connect to the admin MCPConnect to the admin MCP
 
-You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one project.You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one project. You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one or more deployments, depending on how you grant access. A connection scoped to specific deployments can only check out those, while an organization-wide connection can check out any deployment in your organization. You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one or more deployments, depending on how you grant access. A connection scoped to specific deployments can only check out those, while an organization-wide connection can check out any deployment in your organization.
+You must have an interactive OAuth login against your Mintlify account to connect to the admin MCP. AI tools exchange that login for a session token scoped to one or more deployments, depending on how you grant access. A connection scoped to specific deployments can only check out those, while an organization-wide connection can check out any deployment in your organization.
 
 <Tabs>
   <Tab title="Claude">
@@ -264,10 +264,6 @@ Every admin MCP session binds to a single Git branch. The flow is:
   </Step>
 </Steps>
 
-<Tip>
-  Calling `checkout` again during an active session switches the session to the new branch. Use this to abandon an in-progress draft and start fresh without ending the conversation.
-</Tip>
-
 ## What the admin MCP can doWhat the admin MCP can do
 
 ### Content

cli/install.mdx

@@ -6,7 +6,7 @@ keywords: ["CLI", "npm", "install", "Node.js", "pnpm", "mint"]
 
 ## Prerequisites
 
-- [Node.js](https://nodejs.org/en) v20.17.0\+ (LTS versions recommended) qowij foawij efoaijw eofiaw efawe fawe f
+- [Node.js](https://nodejs.org/en) v20.17.0\+ (LTS versions recommended)
 
 ## Install the CLI
 

credits.mdx

@@ -31,25 +31,6 @@ The free Starter plan does not include AI features and has no credit purchase pa
 | 50,000 | \$370 |
 | 100,000 | \$800 |
 
-## Plan availability
-
-Credits are available on the **Pro plan and above**. Every Pro plan includes 10,000 credits per month, and you can purchase additional credits from the [Usage](https://app.mintlify.com/settings/organization/usage) page whenever you need more.
-
-The free Starter plan does not include AI features. You cannot purchase credits on the starter plan. To use the assistant, agent, or automations, upgrade to Pro or Enterprise.
-
-<Note>
-  Customers on legacy credit plans keep their existing credit packs and pricing. The tiers below apply to the Pro plan.
-</Note>
-
-## Pricing tiers
-
-| Monthly credits | Monthly cost |
-| :-- | :-- |
-| 10,000 | \$0 |
-| 25,000 | \$145 |
-| 50,000 | \$370 |
-| 100,000 | \$800 |
-
 If you need more than 100,000 credits per month, [contact sales](https://www.mintlify.com/contact/sales) to discuss a custom plan.
 
 **Overages** cost an additional \$0.01 per credit rather than triggering an automatic tier upgrade. You can set usage alerts to receive an email when you reach a certain percentage of your tier limit. Allowing overages can be cheaper than moving up a tier depending on your usage patterns.

customize/custom-scripts.mdx

@@ -6,8 +6,6 @@ keywords: ["CSS", "JavaScript", "Tailwind CSS", "style customization"]
 
 Use CSS to style HTML elements or add custom CSS and JavaScript to fully customize the look and feel of your documentation.
 
-/
-
 ## Style with Tailwind CSS
 
 Use Tailwind CSS v3 to style HTML elements. You can control layout, spacing, colors, and other visual properties. Some common classes are:

organize/navigation.mdx

@@ -29,20 +29,6 @@ Use the pattern that matches how you want visitors to move between top-level sec
 
 Pages are the most fundamental navigation component. Each page is an MDX file in your documentation repository.
 
-| Pattern | Use when | Example |
-| --- | --- | --- |
-| [Groups](#groups) | Your content fits in one linear sidebar and you don't need a second axis of navigation. | A single-product SDK reference. |
-| [Tabs](#tabs) | You have parallel sections that share the same audience. | Guides, API reference, and SDKs tabs for one product. |
-| [Anchors](#anchors) | You want persistent links to a small number of top-level destinations (external or internal) visible at all times. | Community, status page, or another link alongside your product documentation. |
-| [Dropdowns](#dropdowns) | Similar to tabs, but you want to use a dropdown menu for navigation. | Switching between product documentation, API reference, and partner integrations. |
-| [Products](#products) | You maintain documentation for multiple distinct products under one deployment, and each product has its own full site. | A platform with separate content for Payments, Identity, and Analytics. |
-| [Versions](#versions) | You publish multiple versions of the same content in parallel. | Maintaining `v1` and `v2` API docs simultaneously. |
-| [Languages](#languages) | You publish translated versions of the same content. | English, Spanish, and Japanese documentation for one product. |
-
-## Pages
-
-Pages are the most fundamental navigation component. Each page is an MDX file in your documentation repository.
-
 <img
   className="block pointer-events-none dark:hidden"
   alt="Decorative graphic of pages."

quickstart.mdx

@@ -21,6 +21,8 @@ When you connect your documentation repository to your project, you can work on
   Copy the following prompt to add the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol) for better results when updating your documentation.
 </Tip>
 
+<SkillMcpPrompt />
+
 ## Deploy your documentation site
 
 Go to [mintlify.com/start](https://mintlify.com/start) and complete the onboarding process. During onboarding, you'll connect your GitHub account, create or select a repository for your documentation, and install the GitHub App to enable automatic deployments.
@@ -73,6 +75,7 @@ Find your exact URL on the **Overview** page of your [dashboard](https://app.min
         ```
 
         ```bash pnpm
+        pnpm add -g mint
         ```
 
         </CodeGroup>