Untitled draft#6405
Draft
cdxker wants to merge 1 commit into
Draft
Conversation
- Updated cli/install.mdx - Updated optimize/search.mdx - Updated ai/mintlify-mcp.mdx - Updated organize/navigation.mdx - Updated cli/commands.mdx - Updated organize/pages.mdx - Updated organize/hidden-pages.mdx - Updated .vale.ini - Updated ai/llmstxt.mdx - Updated credits.mdx - Updated optimize/analytics.mdx - Updated ai-native.mdx - Updated customize/fonts.mdx - Updated customize/custom-scripts.mdx - Updated quickstart.mdx Mintlify-Source: dashboard-editor
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 10 potential issues.
Bugbot Autofix prepared fixes for all 10 issues found in the latest run.
- ✅ Fixed: Random garbage in prerequisites
- Removed the accidental garbage text from the Node.js prerequisite bullet.
- ✅ Fixed: Empty pnpm install block
- Restored the missing
pnpm add -g mintcommand in the quickstart install step.
- Restored the missing
- ✅ Fixed: Tip without prompt snippet
- Reinserted the
SkillMcpPromptcomponent after the tip that references the copyable prompt.
- Reinserted the
- ✅ Fixed: Placeholder table on page
- Removed the stray placeholder table from the AI-native overview page.
- ✅ Fixed: Stray slash renders publicly
- Deleted the lone slash so it no longer renders as page content.
- ✅ Fixed: Conflicting Starter plan wording
- Removed the duplicate plan availability and pricing tier block with conflicting Starter wording.
- ✅ Fixed: Conflicting OAuth scope text
- Replaced the corrupted OAuth paragraph with one consistent deployment-scoped authorization description.
- ✅ Fixed: Contradictory checkout behavior
- Removed the conflicting checkout tip that incorrectly framed checkout as the way to abandon a draft.
- ✅ Fixed: Broken Vale TokenIgnores config
- Restored the Vale ignore configuration to valid patterns and removed the duplicated override stanzas.
- ✅ Fixed: Pattern table under Pages
- Removed the duplicated pattern table and repeated Pages heading from the Pages section.
Or push these changes by commenting:
@cursor push 13f54718de
Preview (13f54718de)
diff --git a/.vale.ini b/.vale.ini
--- a/.vale.ini
+++ b/.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,22 +20,17 @@
(?<!`)(<\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]*[ \t]*```[\s\S]*?```$
+(?sm)^({(?!/\*).+?})$, \
+(?sm)^[ \t]*```[\s\S]*?```$
CommentDelimiters = {/*, */}
@@ -43,7 +38,6 @@
BasedOnStyles = ""
# Code-generator snippet with no prose content
-# Code-generator snippet with no prose content
[snippets/vercel-json-generator.mdx]
BasedOnStyles = ""
@@ -57,19 +51,6 @@
[{api-playground/asyncapi-setup.mdx,organize/settings-reference.mdx}]
Vale.Terms = NO
-[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
-
[**/es/**]
BasedOnStyles = ""
diff --git a/ai-native.mdx b/ai-native.mdx
--- a/ai-native.mdx
+++ b/ai-native.mdx
@@ -5,11 +5,6 @@
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
diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
--- a/ai/mintlify-mcp.mdx
+++ b/ai/mintlify-mcp.mdx
@@ -42,7 +42,7 @@
## 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 @@
</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
diff --git a/cli/install.mdx b/cli/install.mdx
--- a/cli/install.mdx
+++ b/cli/install.mdx
@@ -6,7 +6,7 @@
## 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
diff --git a/credits.mdx b/credits.mdx
--- a/credits.mdx
+++ b/credits.mdx
@@ -31,25 +31,6 @@
| 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.
diff --git a/customize/custom-scripts.mdx b/customize/custom-scripts.mdx
--- a/customize/custom-scripts.mdx
+++ b/customize/custom-scripts.mdx
@@ -6,8 +6,6 @@
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:
diff --git a/organize/navigation.mdx b/organize/navigation.mdx
--- a/organize/navigation.mdx
+++ b/organize/navigation.mdx
@@ -29,20 +29,6 @@
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."
diff --git a/quickstart.mdx b/quickstart.mdx
--- a/quickstart.mdx
+++ b/quickstart.mdx
@@ -21,6 +21,8 @@
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 @@
```
```bash pnpm
+ pnpm add -g mint
```
</CodeGroup>You can send follow-ups to the cloud agent here.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| ## Prerequisites | ||
|
|
||
| - [Node.js](https://nodejs.org/en) v20.17.0+ (LTS versions recommended) | ||
| - [Node.js](https://nodejs.org/en) v20.17.0\+ (LTS versions recommended) qowij foawij efoaijw eofiaw efawe fawe f |
There was a problem hiding this comment.
Random garbage in prerequisites
High Severity
The Node.js prerequisite bullet ends with nonsensical text (qowij foawij…) after the version requirement, which will render on the public install page and confuse readers about actual CLI requirements.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| ``` | ||
|
|
||
| ```bash pnpm | ||
| pnpm add -g mint |
There was a problem hiding this comment.
Empty pnpm install block
High Severity
The quickstart CLI step’s pnpm code block no longer contains an install command, so readers following the pnpm tab get no instructions while the npm block still shows npm i -g mint.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| 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 /> |
There was a problem hiding this comment.
Tip without prompt snippet
Medium Severity
The “Using an AI coding tool?” tip still tells readers to copy a prompt for the skill and MCP server, but the <SkillMcpPrompt /> component that supplied that prompt was removed from the page.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| | rob | | | | ||
| | --- | --- | --- | | ||
| | | | | | ||
| | | | | |
There was a problem hiding this comment.
Placeholder table on page
Medium Severity
A markdown table with header rob and empty cells was added at the top of the AI-native overview, unrelated to the product content and likely to show as broken or junk on the live docs page.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
|
|
||
| Use CSS to style HTML elements or add custom CSS and JavaScript to fully customize the look and feel of your documentation. | ||
|
|
||
| / |
There was a problem hiding this comment.
Stray slash renders publicly
Low Severity
A lone / line was inserted between the intro paragraph and the “Style with Tailwind CSS” heading, which MDX will treat as visible page content.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| ## 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. | ||
|
|
There was a problem hiding this comment.
Conflicting Starter plan wording
Medium Severity
The page now repeats “Plan availability” and “Pricing tiers” twice, and the two Starter-plan bullets disagree on whether upgrades go to Pro only or Pro or Enterprise.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
| ## 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 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 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. |
There was a problem hiding this comment.
Conflicting OAuth scope text
High Severity
One merged paragraph states the OAuth session is scoped to a single project and also scoped to one or more deployments with organization-wide access, without clarifying which applies.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
|
|
||
| <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> |
There was a problem hiding this comment.
Contradictory checkout behavior
High Severity
The same page gives opposite guidance on calling checkout again: one tip says other deployment sessions stay in memory and are not discarded; another says switching branches abandons the in-progress draft.
Additional Locations (1)
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
|
|
||
| BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \ | ||
| (?sm)^({(?!/\*).+?})$, \ | ||
| (?sm)^[ \t]*```[\s\S]*?```$ |
There was a problem hiding this comment.
Broken Vale TokenIgnores config
Medium Severity
TokenIgnores now includes a malformed continuation (\, \), a duplicated openapi fragment, and orphan regex lines that are not part of the TokenIgnores assignment, which can break or skew Vale linting.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
|
|
||
| <img | ||
| className="hidden dark:block pointer-events-none" | ||
| src="/images/navigation/pages-dark.png" |
There was a problem hiding this comment.
Pattern table under Pages
Medium Severity
Under the first ## Pages heading, the diff leaves the navigation-pattern comparison table instead of page navigation content, then repeats ## Pages again with the correct intro.
Reviewed by Cursor Bugbot for commit 533a647. Configure here.
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
High Risk
Merging would publish incorrect and contradictory guidance on admin MCP, credits, and navigation while breaking reader trust; several pages are structurally unusable until reverted or cleaned.
Overview
This PR does not read like a deliberate docs update. Across many MDX files it appends or re-inserts whole paragraphs and sections, often leaving the same content twice with inconsistent wording (for example
ai/mintlify-mcp.mdxduplicates connect tabs, session flow, tool lists, best practices, and revoke-access steps, and mixes deployment-scoped vs single-projectcheckoutlanguage).Other high-impact corruption includes
credits.mdxduplicating plan availability and pricing tiers,organize/navigation.mdxduplicating the primary-pattern table and Pages intro,organize/hidden-pages.mdxrepeating the privacy warning, andoptimize/analytics.mdxrepeating agent-visitor and MCP-search explanations plus a broken export step (ClickClick).Several pages pick up stray or nonsense text (
cli/install.mdxgibberish after the Node prerequisite,ai-native.mdxplaceholder table,customize/custom-scripts.mdxlone/and a merged phrase in the text-selection tooltip). Smaller edits escape$and>in tables/paths, reorder JSXclassName/srcon images, and tweakCodeGroupfencing in CLI install/update..vale.inigrows duplicatedTokenIgnoresblocks and repeats per-file override stanzas instead of cleanly extending lint rules.Reviewed by Cursor Bugbot for commit 533a647. Bugbot is set up for automated code reviews on this repo. Configure here.
Mintlify
0 threads from 0 users in Mintlify