Merge branch 'main' into new-support-page

Author: dino475

.github/workflows/check-links.yml

@@ -13,6 +13,6 @@ jobs:
         with:
           node-version: "latest"
       - name: Install Mintlify CLI
-        run: npm i -g mintlify
+        run: npm i -g mint
       - name: Run broken link checker
-        run: mintlify broken-links
+        run: mint broken-links

advanced/dashboard/roles.mdx

@@ -0,0 +1,23 @@
+---
+title: "Roles"
+description: "Control access to your dashboard with roles."
+---
+
+Mintlify provides two dashboard access levels: Editor and Admin.
+
+The following describes actions that are limited to the Admin role:
+
+|                         | Editor | Admin |
+| ----------------------- | :----: | :---: |
+| Update user roles       |   ❌   |  ✅   |
+| Delete users            |   ❌   |  ✅   |
+| Invite admin users      |   ❌   |  ✅   |
+| Manage & update billing |   ❌   |  ✅   |
+| Update custom domain    |   ❌   |  ✅   |
+| Update Git source       |   ❌   |  ✅   |
+| Delete org              |   ❌   |  ✅   |
+
+Other actions on the dashboard are available to both roles.
+
+You can invite as many admins as you want, but we recommend limiting admin
+access to users who need it.

advanced/mcp/generate.mdx

@@ -0,0 +1,51 @@
+---
+title: "AI Ingestion"
+description: "Learn how to feed your documentation into LLMs and AI tools"
+icon: "bot-message-square"
+---
+
+export const PreviewButton = ({ children, href }) => {
+  return (
+    <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
+      {children}
+    </a>
+  )
+}
+
+Documentation pages are content rich and can be a great source of information for LLMs for AI tools.
+
+Today, you can use your documentation to fine-tune a chatbot, answer questions about your product, or use it to generate code.
+
+## Supported Shortcuts
+
+We support a variety of shortcuts and configurations to make it easier to use your documentation in AI tools.
+
+### /llms.txt
+
+An [industry standard](https://llmstxt.org) that helps general-purpose LLMs index more efficiently (e.g. a sitemap for AI).
+
+Every documentation site automatically hosts a **/llms.txt** file at the root that lists all available pages in your documentation.
+
+<PreviewButton href="https://mintlify.com/docs/llms.txt">Open llms.txt for this site</PreviewButton>
+
+### /llms-full.txt
+
+A markdown file of all your content is automatically available at **/llms-full.txt**.
+
+llms-full.txt contains the entire content of your docs, and is a great way to provide a complete context to AI tools.
+
+<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Open llms-full.txt for this site</PreviewButton>
+
+### .md extension
+
+Add **.md** to an individual docs page to see a markdown version of that page. Helps load individual pages into AI tools with better token efficiency & inference time.
+
+<PreviewButton href="https://mintlify.com/docs/quickstart.md">Open quickstart.md</PreviewButton>
+
+### contextual menu
+
+You can enable a [contextual menu](settings#param-contextual) to allow users to copy markdown source, view markdown source, or open ChatGPT with the page content.
+
+### ⌘ \+ c shortcut
+
+Copy markdown source of any page using command \+ c.

advanced/mcp/quickstart.mdx

@@ -31,7 +31,7 @@ Mintlify allows you to define your API endpoints using a combination of `docs.js
     }
     ```
 
-    Find a full list of API configurations [here](/core-concepts/settings#param-api).
+    Find a full list of API configurations [here](settings#param-api).
   </Step>
 
   <Step title="Create your endpoint pages">
@@ -53,7 +53,7 @@ Mintlify allows you to define your API endpoints using a combination of `docs.js
 
     <Note>
 
-    If you have `server` configured in [docs.json](/core-concepts/settings), you can use relative paths like `/v1/endpoint`.
+    If you have `server` configured in [docs.json](settings), you can use relative paths like `/v1/endpoint`.
 
     </Note>
 
@@ -69,6 +69,6 @@ Mintlify allows you to define your API endpoints using a combination of `docs.js
   </Step>
 
   <Step title="Add your endpoints to your docs">
-    Add your endpoint pages to the sidebar by adding the paths to the `navigation` field in your `docs.json`. Learn more about structuring your docs [here](/core-concepts/navigation).
+    Add your endpoint pages to the sidebar by adding the paths to the `navigation` field in your `docs.json`. Learn more about structuring your docs [here](navigation).
   </Step>
 </Steps>

ai-ingestion.mdx

@@ -136,40 +136,61 @@ paths:
             planter.list({ potted: true });
 ```
 
-## `x-hidden`
+## `x-hidden` and `x-excluded`
 
-If your pages are [autogenerated](/api-playground/openapi/setup) from an OpenAPI document, but there are some paths that you don't want to create pages for, you can hide them by adding the property `x-hidden`.
+If your pages are [autogenerated](/api-playground/openapi/setup) from an OpenAPI document, but there are some paths that you don't want to create pages for, you can exclude them from having pages generated by adding the property `x-excluded`.
 
-You can add the `x-hidden` tag under endpoint or webhook paths below the method.
+If you want to have pages generated, but not have them appear in the navigation, add `x-hidden`.
+
+You can add the `x-hidden` or `x-excluded` tag under endpoint or webhook paths below the method.
 
 Here's are examples of how that would look in an OpenAPI schema document for an endpoint or a webhook path:
 
-```json {14}
+```json {11, 19}
 "paths": {
   "/plants": {
     "get": {
       "description": "Returns all plants from the store",
       "parameters": { ... },
-      "responses": { ... },
+      "responses": { ... }
     }
-  }
+  },
+  "/hidden_plants": {
+    "get": {
+      "x-hidden": true,
+      "description": "Returns all somewhat secret plants from the store",
+      "parameters": { ... },
+      "responses": { ... }
+    }
+  },
   "/secret_plants": {
     "get": {
-      "description": "Returns all secret plants from the store (do not publish this endpoint!)",
+      "x-excluded": true,
+      "description": "Returns all top secret plants from the store (do not publish this endpoint!)",
       "parameters": { ... },
-      "responses": { ... },
-      "x-hidden": true
+      "responses": { ... }
     }
   }
 },
 ```
 
-```json {5}
+```json {9, 15}
 "webhooks": {
-  "/secret_pants_hook": {
+  "/plants_hook": {
+    "post": {
+      "description": "Webhook for information about a new plant added to the store",
+    }
+  },
+  "/hidden_plants_hook": {
+    "post": {
+      "x-hidden": true,
+      "description": "Webhook for somewhat secret information about a new plant added to the store"
+    }
+  },
+  "/secret_plants_hook": {
     "post": {
-      "description": "Secret webhook for information about a new plant added to the store",
-      "x-hidden": true
+      "x-excluded": true,
+      "description": "Webhook for top secret information about a new plant added to the store (do not publish this endpoint!)"
     }
   }
 }