undo reorging MDX content

Author: ethanpalm

…yground/customization/authentication.mdx api-playground/mdx/authentication.mdxapi-playground/customization/authentication.mdx renamed to api-playground/mdx/authentication.mdx api-playground/customization/authentication.mdx renamed to api-playground/mdx/authentication.mdx

@@ -3,11 +3,11 @@ title: "Authentication"
 description: "You can set authentication parameters to let users use their real API keys."
 ---
 
-## Enabling Authentication
+## Enabling authentication
 
-You can add an authentication method to your docs.json to enable it on every page or you can set it on a per-page basis.
+You can add an authentication method to your `docs.json` to enable it globally on every page or you can set it on a per-page basis.
 
-The page's authentication method will override docs.json if both are set.
+A page's authentication method will override a global method if both are set.
 
 ### Bearer Token
 

api-playground/mdx-setup.mdx api-playground/mdx/configuration.mdxapi-playground/mdx-setup.mdx renamed to api-playground/mdx/configuration.mdx

@@ -1,7 +1,6 @@
 ---
 title: 'MDX Setup'
 description: 'Generate docs pages for your API endpoints using `MDX`'
-icon: 'markdown'
 ---
 
 You can manually define API endpoints in individual `MDX` files rather than using an OpenAPI specification. This method provides flexibility for custom content, but we recommend generating API documentation from an OpenAPI specification file for most API documentation projects as it's more maintainable and feature-rich. However, MDX can be useful for documenting small APIs, prototyping, or when you want to feature API endpoints alongside other content.
@@ -75,3 +74,92 @@ To generate pages for API endpoints using `MDX`, configure your API settings in
     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 in [Navigation](/navigation).
   </Step>
 </Steps>
+
+## Enabling authentication
+
+You can add an authentication method to your `docs.json` to enable it globally on every page or you can set it on a per-page basis.
+
+A page's authentication method will override a global method if both are set.
+
+### Bearer Token
+
+<CodeGroup>
+
+```json docs.json
+"api": {
+    "mdx": {
+      "auth": {
+        "method": "bearer"
+      }
+    }
+}
+```
+
+```md Page Metadata
+---
+title: "Your page title"
+authMethod: "bearer"
+---
+```
+
+</CodeGroup>
+
+### Basic Authentication
+
+<CodeGroup>
+
+```json docs.json
+"api": {
+    "mdx": {
+      "auth": {
+        "method": "basic"
+      }
+    }
+}
+```
+
+```md Page Metadata
+---
+title: "Your page title"
+authMethod: "basic"
+---
+```
+
+</CodeGroup>
+
+### API Key
+
+<CodeGroup>
+
+```json docs.json
+"api": {
+    "mdx": {
+      "auth": {
+        "method": "key",
+        "name": "x-api-key"
+      }
+    }
+}
+```
+
+```md Page Metadata
+---
+title: "Your page title"
+authMethod: "key"
+---
+```
+
+</CodeGroup>
+
+### None
+
+The "none" authentication method is useful to disable authentication on a specific endpoint after setting a default in docs.json.
+
+<CodeGroup>
+```md Page Metadata
+---
+title: "Your page title"
+authMethod: "none"
+---
+```
+</CodeGroup>

docs.json

@@ -85,7 +85,14 @@
                   "api-playground/asyncapi/playground"
                 ]
               },
-              "api-playground/mdx-setup",
+              {
+                "group": "MDX",
+                "icon": "markdown",
+                "pages": [
+                "api-playground/mdx/configuration",
+                "api-playground/mdx/authentication"
+                ]
+              },
               "api-playground/troubleshooting"
             ]
           },
@@ -374,14 +381,6 @@
       "source": "/api-playground/openapi/advanced-features",
       "destination": "/api-playground/customization/advanced-features"
     },
-    {
-      "source": "/api-playground/mdx/authentication",
-      "destination": "/api-playground/customization/authentication"
-    },
-    {
-      "source": "/api-playground/mdx/configuration",
-      "destination": "/api-playground/mdx-setup"
-    },
     {
       "source": "/api-playground/openapi/openapi-setup",
       "destination": "/api-playground/openapi-setup"