Untitled draft

.vale.ini

@@ -2,7 +2,7 @@
 
 StylesPath = .vale/styles
 MinAlertLevel = suggestion
-IgnoredScopes = code, tt, img, url, a
+IgnoredScopes = code, code, tt, img, url, a
 SkippedScopes = script, style, pre, figure, code
 
 Vocab = Mintlify
@@ -20,24 +20,43 @@ TokenIgnores = (?m)((?:import|export) .+?$), \
 (?<!`)(<\w+ ?.+ ?\/>)(?!`), \
 (<[A-Z]\w+>.+?<\/[A-Z]\w+>), \
 (<[^>]*>), \
-\{(?!/\*)[^}]*\}, \
-(`[^`]*`), \
-(?m)^openapi: .+$, \
+\{(?!/\*)(?!/\*)[^}]*\}, \
+(`[^`]*`), \, \
+(?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]*\)
+
 ([\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]*```[\s\S]*?```$
+(?sm)^({(?!/\*)(?!/\*).+??})$, \
+(?sm)^[ \t]*[ \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

@@ -2,9 +2,14 @@
 title: "AI-native documentation"
 sidebarTitle: "AI-native"
 description: "Discover how AI-native features enhance reading, writing, and discovering your documentation with the assistant, agent, and MCP server."
-keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"]
+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
@@ -49,10 +54,12 @@ Select any of the following cards for more information.
   <Card title="Assistant" icon="bot-message-square" href="/assistant/configure">
     Configure the assistant to search external sites or direct people to your support team if it can't answer their questions.
   </Card>
+
   <Card title="Automations" icon="message-circle-plus" href="/automations/index">
     Get documentation updates automatically on a schedule or when a push event occurs.
   </Card>
+
   <Card title="Contextual menu" icon="sparkles" href="/ai/contextual-menu">
     Add a menu to pages that lets users query AI tools, connect to your MCP server, and copy pages as context with one click.
   </Card>
-</CardGroup>
+</CardGroup>

ai/llmstxt.mdx

@@ -9,7 +9,7 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
 
 The [llms.txt file](https://llmstxt.org) is an industry standard that helps LLMs index content more efficiently, similar to how a sitemap helps search engines. AI tools can use this file to understand your documentation structure and find content relevant to user queries.
 
-Mintlify automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project.
+Mintlify   automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project.
 
 <Note>
   Authentication affects `llms.txt` and `llms-full.txt` differently depending on your site configuration:
@@ -80,4 +80,4 @@ Mintlify automatically hosts an `llms-full.txt` file at the root of your project
 
 To add a custom `llms.txt` or `llms-full.txt` file, create an `llms.txt` or `llms-full.txt` file at the root of your project. Adding a custom file overrides the automatically generated file of the same name. If you delete a custom file, Mintlify restores the automatically generated file.
 
-Your custom `llms.txt` or `llms-full.txt` file must have a site title as an H1 heading. Other content is optional. See [Format](https://llmstxt.org/#format) in the `llms.txt` specification for more information on optional sections and best practices.
+Your custom `llms.txt` or `llms-full.txt` file must have a site title as an H1 heading. Other content is optional. See [Format](https://llmstxt.org/#format) in the `llms.txt` specification for more information on optional sections and best practices.