Root level core concepts (#687)

handotdev · web-flow · commit e83f79744367 · 2025-05-05T14:56:44.000-07:00
diff --git a/ai-ingestion.mdx b/ai-ingestion.mdx
@@ -44,7 +44,7 @@ Add **.md** to an individual docs page to see a markdown version of that page. H
 
 ### contextual menu
 
-You can enable a [contextual menu](/core-concepts/settings#param-contextual) to allow users to copy markdown source, view markdown source, or open ChatGPT with the page content.
+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
 
diff --git a/api-playground/mdx/configuration.mdx b/api-playground/mdx/configuration.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>
diff --git a/api-playground/openapi/setup.mdx b/api-playground/openapi/setup.mdx
@@ -81,7 +81,7 @@ and the API playground will be automatically generated from the OpenAPI document
 If you have multiple OpenAPI files, include the path to the OpenAPI file to ensure Mintlify finds the correct OpenAPI document. This is not required if you have
 only one OpenAPI file - it will automatically detect your OpenAPI file.
 
-If you want to reference an external OpenAPI file using this method, provide the file’s URL in the docs.json. See [here](https://mintlify.com/docs/core-concepts/settings#param-source-4) for the correct format.
+If you want to reference an external OpenAPI file using this method, provide the file’s URL in the docs.json. See [here](https://mintlify.com/docssettings#param-source-4) for the correct format.
 
 <CodeGroup>
   ```md Example
@@ -133,7 +133,7 @@ npx @mintlify/scraping@latest openapi-file <path-to-openapi-file> -o api-referen
 Learn more about our scraping package [here](https://www.npmjs.com/package/@mintlify/scraping).
 
 The scraper will output an array of
-[Navigation entries](/core-concepts/settings#structure) containing your OpenAPI MDX
+[Navigation entries](settings#structure) containing your OpenAPI MDX
 files. You can either append these entries to your existing Navigation, or
 reorder and add the files to your navigation manually.
 
diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx
@@ -70,7 +70,7 @@ Here's a list of common issues we've seen customers run into:
     requests, then all of these requests will fail. To fix this, configure your reverse proxy to
     allow `POST` requests to the `/api/request` path.
 
-    Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/core-concepts/settings#api-configurations). This will
+    Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](settings#api-configurations). This will
     likely require you to configure CORS on your server, as these requests will now come directly
     from your users' browsers.
   </Accordion>
diff --git a/changelog.mdx b/changelog.mdx
@@ -37,15 +37,15 @@ mode: "center"
   <Frame>
     ![AI Translations graphic](/images/changelog/translations.png)
   </Frame>
-  Translate all of your documentation with AI. [Learn more.](/core-concepts/navigation#localization)
+  Translate all of your documentation with AI. [Learn more.](navigation#localization)
 
   ## Export docs to PDF in beta
 
   Export all of your documentation, a subdirectory, or a singe page as a PDF.
 
   ## React hook support
 
-  Bring interactivity to your docs. All standard React hooks are automatically available in your MDX files. [Learn more.](/core-concepts/react-components)
+  Bring interactivity to your docs. All standard React hooks are automatically available in your MDX files. [Learn more.](react-components)
 </Update>
 
 <Update label="March 2025">
@@ -55,7 +55,7 @@ mode: "center"
     ![screenshot of MCP server generator](/images/changelog/mcpgenerator.png)
   </Frame>
   Generate MCP servers so that AI applications can interact with your docs or APIs. Written content is automatically generated as an MCP server, and you can generate an MCP server from your OpenAPI spec with one click.
-  Check out [docs on getting started with MCP.](/advanced/mcp/quickstart)
+  Check out [docs on getting started with MCP.](/mcp)
 
   ## Improvements
 
@@ -110,7 +110,7 @@ mode: "center"
   <Frame>
     ![graphic with text "Themes v2"](/images/changelog/themes.png)
   </Frame>
-  New [pre-built themes](/core-concepts/themes) to modify the look & feel of your docs. Configure via your [docs.json file](/core-concepts/settings).
+  New [pre-built themes](themes) to modify the look & feel of your docs. Configure via your [docs.json file](settings).
 
   Now available:
 
@@ -121,7 +121,7 @@ mode: "center"
   ## Other improvements
 
   - [Guide to Technical Writing:](https://mintlify.com/guides/introduction)Best practices for writing technical documentation, including audience research, content types, and writing tips.
-  - [Dropdown component](/core-concepts/navigation#dropdowns): Organize navigation with a dropdown, in addition to tabs and anchors.
+  - [Dropdown component](navigation#dropdowns): Organize navigation with a dropdown, in addition to tabs and anchors.
   - [AI syntax fixer](https://x.com/ricardonunez_io/status/1892334887644123192): The web editor will catch if there’s a parsing error and use AI to suggest fixes.
 </Update>
 
@@ -342,7 +342,7 @@ mode: "center"
   `disableProxy` to disable this behavior and support request types like file
   uploads.
 
-  - [Learn more about API configurations](/core-concepts/settings#api-configurations)
+  - [Learn more about API configurations](settings#api-configurations)
 
   ## Mobile SEO improvements
 
@@ -423,7 +423,7 @@ mode: "center"
   - Add full-screen videos or image galleries
   - Embed custom iFrame demo elements to add intractability to your docs
 
-  Check out our [Custom Mode docs](/core-concepts/pages#custom-mode).
+  Check out our [Custom Mode docs](pages#custom-mode).
 </Update>
 
 <Update label="March 2024">
diff --git a/docs.json b/docs.json
@@ -30,12 +30,12 @@
           {
             "group": "Core Concepts",
             "pages": [
-              "core-concepts/settings",
-              "core-concepts/pages",
-              "core-concepts/navigation",
-              "core-concepts/themes",
-              "core-concepts/react-components",
-              "core-concepts/ai-ingestion"
+              "settings",
+              "pages",
+              "navigation",
+              "themes",
+              "react-components",
+              "ai-ingestion"
             ]
           },
           {
@@ -111,7 +111,7 @@
               "settings/gitlab",
               "settings/ci",
               "settings/preview-deployments",
-              "core-concepts/custom-scripts",
+              "settings/custom-scripts",
               "mcp",
               {
                 "group": "Integrations",
diff --git a/navigation.mdx b/navigation.mdx
@@ -4,7 +4,7 @@ description: "Structure and customize your documentation's navigation hierarchy"
 icon: "map"
 ---
 
-The [navigation](/core-concepts/settings#param-navigation) property in [docs.json](/core-concepts/settings) defines how users will browse through your documentation. Think of it as the blueprint for your documentation's menu structure.
+The [navigation](settings#param-navigation) property in [docs.json](settings) defines how users will browse through your documentation. Think of it as the blueprint for your documentation's menu structure.
 
 With proper navigation configuration, you can organize your content into a logical hierarchy that makes it easy for users to find exactly what they're looking for.
 
@@ -15,7 +15,7 @@ Pages are the most fundamental navigation component.
 <img className="block dark:hidden pointer-events-none" src="/images/navigation/pages-light.png" />
 <img className="hidden dark:block pointer-events-none" src="/images/navigation/pages-dark.png" />
 
-Pages is an array where each entry must be a reference to the path of a [page file](/core-concepts/pages).
+Pages is an array where each entry must be a reference to the path of a [page file](pages).
 
 ```json
 {
diff --git a/pages.mdx b/pages.mdx
@@ -48,7 +48,7 @@ icon: "code"
 ---
 ```
 
-You can set icons from [Font Awesome](https://fontawesome.com/icons) and [Lucide](https://lucide.dev/icons), depending on the [icon library setting](/core-concepts/settings#param-icons).
+You can set icons from [Font Awesome](https://fontawesome.com/icons) and [Lucide](https://lucide.dev/icons), depending on the [icon library setting](settings#param-icons).
 
 You can also set the icon type for Font Awesome icons (optional). If not set, the icon type will be regular.
 
diff --git a/quickstart.mdx b/quickstart.mdx
@@ -208,10 +208,10 @@ Enter your domain (e.g., docs.yourcompany.com) and follow the provided instructi
 
 Congratulations! You've successfully deployed your documentation site with Mintlify. Here are some suggested next steps to enhance your documentation:
 
-<Card title="Customize Your Theme" icon="paintbrush" href="/core-concepts/themes" horizontal>
+<Card title="Customize Your Theme" icon="paintbrush" href="themes" horizontal>
   Learn how to customize colors, fonts, and the overall appearance of your documentation site.
 </Card>
-<Card title="Organize Navigation" icon="map" href="/core-concepts/navigation#overview" horizontal>
+<Card title="Organize Navigation" icon="map" href="navigation#overview" horizontal>
   Structure your documentation with intuitive navigation to help users find what they need.
 </Card>
 <Card title="Add Interactive Components" icon="puzzle" href="/components/accordions" horizontal>
diff --git a/react-components.mdx b/react-components.mdx
diff --git a/settings.mdx b/settings.mdx
@@ -21,7 +21,7 @@ This section contains the full reference for the docs.json file.
 <ResponseField name="theme" required>
   One of the following: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`.
 
-  The layout theme of the project. Check out the [Themes](/core-concepts/themes) page for more information.
+  The layout theme of the project. Check out the [Themes](themes) page for more information.
 </ResponseField>
 
 <ResponseField name="name" type="string" required>
@@ -369,32 +369,32 @@ This section contains the full reference for the docs.json file.
       </Expandable>
     </ResponseField>
     <ResponseField name="languages" type="array of object">
-      Organizing by [languages](/core-concepts/navigation#localization)
+      Organizing by [languages](navigation#localization)
 
     </ResponseField>
     <ResponseField name="versions" type="array of object">
-      Organizing by [versions](/core-concepts/navigation#versions)
+      Organizing by [versions](navigation#versions)
 
     </ResponseField>
     <ResponseField name="tabs" type="array of object">
-      Organizing by [tabs](/core-concepts/navigation#divisions#tabs)
+      Organizing by [tabs](navigation#divisions#tabs)
 
     </ResponseField>
     <ResponseField name="anchors" type="array of object">
-      Organizing by [anchors](/core-concepts/navigation#divisions#anchors)
+      Organizing by [anchors](navigation#divisions#anchors)
 
     </ResponseField>
 
     <ResponseField name="dropdowns" type="array of object">
-      Organizing by [dropdowns](/core-concepts/navigation#divisions#dropdowns)
+      Organizing by [dropdowns](navigation#divisions#dropdowns)
 
     </ResponseField>
     <ResponseField name="groups" type="array of object">
-      Organizing by [groups](/core-concepts/navigation#pages#pages)
+      Organizing by [groups](navigation#pages#pages)
 
     </ResponseField>
     <ResponseField name="pages" type="array of string or object">
-      An array of [page paths or groups](/core-concepts/navigation#pages#groups)
+      An array of [page paths or groups](navigation#pages#groups)
 
     </ResponseField>
 
diff --git a/settings/custom-scripts.mdx b/settings/custom-scripts.mdx
diff --git a/settings/seo.mdx b/settings/seo.mdx
@@ -6,7 +6,7 @@ icon: 'search'
 
 The platform automatically generates most meta tags.
 
-However, you can fully customize them by adding the [metadata](/core-concepts/settings#param-metadata) field to your `docs.json` or the page's frontmatter.
+However, you can fully customize them by adding the [metadata](settings#param-metadata) field to your `docs.json` or the page's frontmatter.
 
 
 
@@ -51,7 +51,7 @@ Only pages included in your `docs.json` are included by default. To include hidd
 
 ## Disabling indexing
 
-If you want to stop a page from being indexed by search engines, you can include the following in the [frontmatter](/core-concepts/pages) of your page:
+If you want to stop a page from being indexed by search engines, you can include the following in the [frontmatter](pages) of your page:
 
 ```
 ---
diff --git a/themes.mdx b/themes.mdx
@@ -34,7 +34,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
 <div className="pt-10 pb-24 px-4 px-4 max-w-3xl mx-auto prose prose-gray">
   <label className="eyebrow h-5 text-primary dark:text-primary-light text-sm font-semibold">Core Concepts</label>
   <h1 className="mt-1 mb-2 text-2xl sm:text-3xl text-gray-900 tracking-tight dark:text-gray-200 font-semibold">Themes</h1>
-  <label className="text-lg prose prose-gray dark:prose-invert">Custom the appearance of your documentation<br /><br />Configure [theme](/core-concepts/settings#param-theme) in docs.json using one of the following themes.</label>
+  <label className="text-lg prose prose-gray dark:prose-invert">Custom the appearance of your documentation<br /><br />Configure [theme](settings#param-theme) in docs.json using one of the following themes.</label>
 
 <br />
 
