Added Next Gen Docs

colinloretz · colinloretz · commit fc6b720acd2d · 2025-11-07T08:49:13.000-08:00
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -22,82 +22,13 @@ See the [README](https://github.com/discord/discord-api-docs/blob/main/README.md
 
 ## Markdown Syntax
 
-This repository uses special markdown syntax that helps style the resulting web version of the documentation.
+Our documentation uses standard [Markdown](https://www.markdownguide.org/basic-syntax/) syntax with some additional [MDX](https://mdxjs.com/) features.
 
-### H6 Headings
+We also support the following formatting from Mintlify:
 
-H6 headings should be used above tables and code blocks to properly label them.
-
-### Linking
-
-Links between docs can be achieved by using a hash symbol (#), plus the markdown file name, plus a slash, and finally the dash-separated anchor. For instance, to link to the above H6 heading section:
-
-```md
-[Links to README.md H6](#README/h6-headings)
-```
-
-### Alert Boxes
-
-Alert boxes are created by placing a line with 3 colons (`:::`) before and after the text. The first 3 colons must be followed by a label specifying the alert box type. For example, to create a warning alert:
-
-```
-:::warn
-Something that requires warning here
-:::
-```
-
-Currently the following types are available: `info`, `warn`, `danger` and `preview`
-
-![Available alert types](images/alerts.webp)
-
-### MDX Components
-
-There are a few reusable MDX components that can be used on pages with the `mdx` extension. 
-
-#### Collapsibles
-
-Collapsibles allow you to show/hide content on a page that may be secondary to the page's primary content. They have four fields that can be set: `title`, `description`, `icon`, and an `open` flag (which makes the collapsible element open by default).
-
-Available options for `icon`:
-
-- `"list"`
-- `"view"`
-- `"question"`
-- `"code"`
-- `"warning"`
-
-###### Example
-
-![Collapsible MDX Component with the list icon](images/mdx-collapsible.webp)
-
-```markdown
-<Collapsible title="Title" description="Description text" icon="list">
-Collapsed content
-</Collapsible>
-```
-
-#### Buttons
-
-Buttons are simply... clickable buttons. They take `href` and `color` as arguments, but currently we only use `"brand"` as a value for `color`.
-
-###### Example
-
-![Button MDX Component](images/mdx-button.webp)
-
-```markdown
-<LinkButton to="https://discord.com/developers/docs/getting-started" color="brand" text="click the button!" />
-```
-
-#### Cards
-
-Cards let you display links in a card format. They accept two arguments, `title` and `link`.
-
-###### Example
-
-![Card MDX Component](images/mdx-card.webp)
-
-```markdown
-<Card title="Card Title" href="https://discord.com/developers/docs/getting-started">
-This is the content inside of the card~
-</Card>
-```
+- [Format Text](https://www.mintlify.com/docs/create/text)
+- [Format Code](https://www.mintlify.com/docs/create/code)
+- [Images & Embeds](https://www.mintlify.com/docs/create/image-embeds)
+- [Files](https://www.mintlify.com/docs/create/files)
+- [Lists & Tables](https://www.mintlify.com/docs/create/list-table)
+- [Available Components](https://www.mintlify.com/docs/components/accordions)
diff --git a/README.md b/README.md
@@ -1,13 +1,13 @@
-# Discord API Documentation
+# Discord for Developers Documentation
 
-This repo contains the official Discord API documentation, which can be viewed online [HERE](https://discord.com/developers/docs/intro). Before submitting pull-requests, please remember to _fully_ read the [Contributing](CONTRIBUTING.md) guidelines.
+This repo contains the official Discord for Developers documentation, which can be viewed online [HERE](https://discord.com/developers/docs/intro). Before submitting pull-requests, please remember to _fully_ read the [Contributing](CONTRIBUTING.md) guidelines.
 
-This repository reflects the Discord API as it is meant to be accessed by third-party applications. It omits features and capabilities that are not generally available, or are not fully supported for third-party usage.
+This repository reflects the Discord Developer Platform as it is meant to be accessed by third-party applications. It omits features and capabilities that are not generally available, or are not fully supported for third-party usage.
 
 We welcome your contributions!
 
--   Issue tracker: Discord API bugs
--   Discussions: Discord API feature and improvement requests
+-   Issue tracker: [Discord API bugs](https://github.com/discord/discord-api-docs/issues)
+-   Discussions: [Discord API feature and improvement requests](https://github.com/discord/discord-api-docs/discussions/categories/api-feature-requests-ideas)
 -   Pull Requests: See [Contributing.md](https://github.com/discord/discord-api-docs/blob/main/CONTRIBUTING.md) for types of changes accepted and specific markdown syntax used in the documentation.
 
 ### Local Preview
@@ -18,16 +18,17 @@ Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview th
 npm i -g mintlify
 ```
 
-Run the following command at the root of the docs to see your changes locally.
+Run the `mintlify dev` in the `discord` directory to see your changes locally.
 
 ```
+cd discord
 mintlify dev
 ```
 
-You will need to add `/developers/docs/` to the preview URL to see the docs and your changes.
+Your local browser should open automatically to the correct page, but if not, navigate to:
 
 ```
-http://localhost:3000/developers/docs/
+http://localhost:3000/developers/docs/intro
 ```
 
 ## Need some help?
diff --git a/discord/developers/docs/change-log.mdx b/discord/developers/docs/change-log.mdx
@@ -3,11 +3,75 @@ title: "Change Log"
 description: "Discover the latest updates, new features, and bug fixes on the Discord Developer Platform. To join in on the conversation, join the [Discord Developers Server](https://discord.com/invite/discord-developers)."
 ---
 
+import {Route} from '/snippets/route.jsx'
+
 ---
 
-import {Route} from '/snippets/route.jsx'
+<Update label="Next Generation Docs Project" description="2025-11-06" tags={["Docs"]}>
+
+  ## Next Generation Docs Project
+
+  We're excited to announce the launch of our Next Gen Docs project! This initiative aims to improve the way developers interact with Discord's developer documentation, making it more accessible, comprehensive, and user-friendly.
+
+  ## Our Goal
+
+  The Discord API has evolved far beyond its origins as a platform for bots. Today, we're a comprehensive developer platform supporting:
+
+  - **Discord Apps and Bots** - The foundation of our ecosystem, extending Discord's functionality with custom apps, commands, and integrations
+  - **Discord Activities** - Real-time games and social experiences that users can launch directly inside Discord
+  - **Social SDK for Games** - Bringing Discord-powered features like voice, chat, rich presence, and social graph to games
+
+  Our documentation needs to evolve with us. With this project, we're not just updating our docs. We're aiming to improve the entire developer experience for learning and building on Discord as it exists in 2025 and beyond.
+
+  ## Our Next Gen Docs Journey
+
+  **What we've done so far:**
+  - Migrated to [Mintlify](https://mintlify.com) for a modern documentation experience
+  - For this migration, we preserved our existing content and familiar design but plan to evolve this over time
+  - We no longer have to maintain and build our own documentation platform and can instead focus on making content and improving our developer experience
+  - Gained new capabilities:
+    - **PR Previews** - See documentation changes before they go live! This works locally as well as in your pull requests
+    - **More Components and Docs Features** - We now have access to all of Mintlify's documentation components that will continue to grow over time
+    - **AI features & improved search** - You can now send our docs to your LLM of choice or access them via MCP (more on this soon!)
+
+  If you're reading this, the migration is complete! 🎉 
+
+  <Warning>
+      This migration did require us to reorganize the entire repository and make a lot of formatting changes. If you have an open PR, it will be a pretty gnarly merge conflict to resolve. We will be focusing on getting our PR backlog down over the next few weeks.
+  </Warning>
+
+  <Info>
+      We combed through the existing documentation to ensure everything was migrated correctly, but if you spot anything that looks off, please let us know by opening an issue or submitting feedback [here](https://github.com/discord/discord-api-docs/discussions/categories/next-gen-docs-feedback). We will be actively monitoring feedback to quickly address any issues.
+  </Info>
+
+  ## Why This Matters
+
+  Great documentation isn't just about having the right information, it's about presenting it in a way that helps developers succeed. 
+  
+  In the coming months, we'll be shipping changes to our documentation to ensure that it:
+
+  - **Reduces time-to-first-success** for new developers
+  - **Scales with complexity** as your projects grow
+  - **Stays current** with our rapidly evolving platform
+  - **Serves all skill levels** from beginners to experts
+
+  ## Contributing to Our Vision
+
+  This transformation is happening with the developer community at its heart. We welcome:
+
+  - **Feedback** on what's working and what isn't
+  - **Content contributions** through our existing PR process
+  - **Bug reports** when documentation doesn't match reality
+
+  We have created a Github Discussion topic for [Next Gen Docs Feedback](https://github.com/discord/discord-api-docs/discussions/categories/next-gen-docs-feedback) to collect feedback.
+
+  See our [Contributing Guidelines](https://github.com/discord/discord-api-docs/blob/main/CONTRIBUTING.md) for how to get involved.
+</Update>
 
 <Update label="Discord Social SDK Release 1.6.12170" description="2025-10-15" tags={["Discord Social SDK"]}>
+
+  ## Discord Social SDK Release 1.6.12170
+
   A new release of the Discord Social SDK is now available, with the following updates:
 
   ## New Features
@@ -41,6 +105,9 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Discord Social SDK Release 1.6" description="2025-09-26" tags={["Discord Social SDK"]}>
+
+  ## Discord Social SDK Release 1.6
+
   A new release of the Discord Social SDK is now available, with the following updates:
 
   ### ✨ New Features
@@ -84,6 +151,9 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Adding More Modal Components!" description="2025-09-10" tags={["Interactions", "Components"]}>
+
+  ## Adding More Modal Components!
+
   We've added more components to modals! All select menus (User, Role, Mentionable, Channel) are now fully supported in modals. In order to use a select menu in a modal, it must be placed inside a [Label](/developers/docs/components/reference#label) component. We've also added the [Text Display](/developers/docs/components/reference#text-display) component with markdown support as a top-level component in modals.
 
   #### Components Now Supported in Modals:
@@ -104,10 +174,16 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Banner, avatar, and bio can be set on modify current member" description="2025-09-10" tags={["HTTP API"]}>
+
+  ## Banner, avatar, and bio can be set on modify current member
+
   As of September 10, 2025, bots can set `banner`, `avatar`, and `bio` fields using the [modify current member](/developers/docs/resources/guild#modify-current-member) route.
 </Update>
 
 <Update label="Deprecating Non-E2EE Voice Calls" description="2025-09-02" tags={["Voice"]}>
+
+  ## Deprecating Non-E2EE Voice Calls
+
   We started work on end-to-end encryption for Discord over two years ago to enhance our user privacy and security. With
   DAVE now supported across all platforms, we’re very close to making every call fully end-to-end encrypted.
 
@@ -133,6 +209,9 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Discord Social SDK Release 1.5.11353" description="2025-08-28" tags={["Discord Social SDK"]}>
+
+  ## Discord Social SDK Release 1.5.11353
+
   A new release of the Discord Social SDK is now available, with the following updates:
 
   ### Unity Plugin
@@ -149,6 +228,9 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Introducing New Modal Components!" description="2025-08-25" tags={["Interactions", "Components"]}>
+
+  ## Introducing New Modal Components!
+
   You asked for them, and now they're here! Modals are getting new components!!
 
   #### What's New
@@ -183,10 +265,13 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Pin Permission Split" description="2025-08-20" tags={["Breaking Changes", "HTTP API"]}>
-[Pinning](/developers/docs/resources/message#pin-message) and [unpinning](/developers/docs/resources/message#unpin-message) messages now has its own [permission](/developers/docs/topics/permissions#permissions-bitwise-permission-flags). We split `PIN_MESSAGES` out of `MANAGE_MESSAGES` to give more granular control over who can pin messages in a channel. This is effective immediately for both users and apps. This change will be backwards compatible until January 12th 2026 when `MANAGE_MESSAGES` will no longer grant the ability to pin or unpin messages.
+  ## Pin Permission Split
+  [Pinning](/developers/docs/resources/message#pin-message) and [unpinning](/developers/docs/resources/message#unpin-message) messages now has its own [permission](/developers/docs/topics/permissions#permissions-bitwise-permission-flags). We split `PIN_MESSAGES` out of `MANAGE_MESSAGES` to give more granular control over who can pin messages in a channel. This is effective immediately for both users and apps. This change will be backwards compatible until January 12th 2026 when `MANAGE_MESSAGES` will no longer grant the ability to pin or unpin messages.
 </Update>
 
 <Update label="Discord Social SDK Release 1.5" description="2025-08-15" tags={["Discord Social SDK"]}>
+  ## Discord Social SDK Release 1.5
+
   A new release of the Discord Social SDK is now available, with the following updates:
 
   ### **DM History Support**
@@ -254,6 +339,8 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Introducing Rate Limit When Requesting All Guild Members" description="2025-08-14" tags={["Gateway"]}>
+  ## Introducing Rate Limit When Requesting All Guild Members
+
   We're introducing a change to the [Request Guild Members](/developers/docs/events/gateway-events#request-guild-members) gateway opcode. 
 
   ### What's changing?
@@ -292,7 +379,7 @@ import {Route} from '/snippets/route.jsx'
 
   ### Timeline
 
-  Most apps won’t encounter this rate limit until it is rolled out to all servers on **October 1, 2025**. However, if you are the developer of an app that is requesting all guild members in very large guilds then you may start seeing this **as soon as today**, so we can ensure platform stability.
+  Most apps won't encounter this rate limit until it is rolled out to all servers on **October 1, 2025**. However, if you are the developer of an app that is requesting all guild members in very large guilds then you may start seeing this **as soon as today**, so we can ensure platform stability.
 
   ### What you need to do
 
@@ -305,7 +392,7 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Discord Social SDK Communication Features - General Availability" description="2025-08-13" tags={["Discord Social SDK"]}>
-  ### Discord Social SDK Communication Features - General Availability
+  ## Discord Social SDK Communication Features - General Availability
 
   Communication features (cross-platform messaging, voice chat, lobbies, and linked channels) are now generally available for all Discord
   Social SDK users that meet our application process criteria. Previously available only in closed beta, these features 
@@ -330,6 +417,8 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Embedded App SDK Version 2.1 & 2.2" description="2025-08-11"  tags={["Activities", "Embedded App SDK"]}>
+  ## Embedded App SDK Version 2.1 & 2.2
+  
   We've made a few improvements to the Embedded App SDK for version 2.2.0, here are the highlights:
 
   ### Changes in version 2.1
@@ -353,6 +442,8 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Remove .proxy/ from Discord Activity proxy path" description="July 30, 2025" tags={["Activities", "Embedded App SDK"]}>
+  ## Remove .proxy/ from Discord Activity proxy path
+
   We've updated the Content Security Policy (CSP) for Discord Activities to remove the `.proxy/` path requirement when making requests through the discordsays.com proxy. This change simplifies the developer experience while maintaining full backwards compatibility. This was made possible by resolving the underlying privacy considerations that originally required the `.proxy/` path restriction.
 
   #### Before
@@ -393,6 +484,8 @@ import {Route} from '/snippets/route.jsx'
 </Update>
 
 <Update label="Guild Create Deprecation" description="July 28, 2025" tags={["HTTP API"]}>
+  ## Guild Create Deprecation
+  
   Apps can no longer create guilds. The documentation for these endpoints has been removed and the endpoints have been removed from the OpenAPI specification.
 
   See our [earlier changelog entry](/developers/docs/change-log#deprecating-guild-creation-by-apps) for more information.
diff --git a/discord/developers/docs/intro.mdx b/discord/developers/docs/intro.mdx
@@ -21,7 +21,9 @@ import {CircleQuestionIcon} from '/snippets/icons/CircleQuestionIcon.jsx'
           <p id="hero-tagline">Build Where the World Plays</p>
           <p>Create social games, experiences, and integrations for millions of users on Discord</p>
         </div>
-        <div id="hero-image" />
+        <div id="hero-image">
+          <img src="/images/frame-wumpus.png" alt="Discord Developers" />
+        </div>
   </div>
 </div>
 
diff --git a/discord/docs.json b/discord/docs.json
@@ -15,18 +15,6 @@
     "eyebrows": "breadcrumbs"
   },
   "favicon": "/favicon.png",
-  "fonts": {
-    "body": {
-      "family": "gg sans",
-      "weight": 400,
-      "format": "woff2"
-    },
-    "heading": {
-      "family": "gg sans",
-      "weight": 600,
-      "format": "woff2"
-    }
-  },
   "errors": {
     "404": {
       "redirect": false
@@ -342,6 +330,10 @@
       "linkedin": "https://www.linkedin.com/showcase/discord-developers"
     }
   },
+  "banner" : {
+    "content": "New docs? Check out the [change log](/developers/docs/change-log#next-generation-docs-project) to learn more!",
+    "dismissible": true 
+  },
   "integrations": {
     "gtm": {
         "tagId": "G-5CWMJQ1S0X"
diff --git a/discord/styles/fonts.css b/discord/styles/fonts.css
@@ -30,6 +30,20 @@ Imports Discord brand font
     src: url('https://mintlify-assets.b-cdn.net/fonts/discord/gg_800.woff2')
 }
 
+body {
+    font-family: "gg sans", var(--font-inter), -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+    font-weight: 400;
+}
+
+h1, h2, h3, h4, h5, h6 {
+    font-family: "gg sans", var(--font-inter), -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+    font-weight: 600;
+}
+
+.\[\&_\*\:not\(h1\2c h2\2c h3\2c h4\2c h5\2c h6\2c h1_\*\2c h2_\*\2c h3_\*\2c h4_\*\2c h5_\*\2c h6_\*\)\]\:font-bodyWeight :not(h1,h2,h3,h4,h5,h6,h1 *,h2 *,h3 *,h4 *,h5 *,h6 *) {
+    font-weight: 400;
+}
+
 
 
 
diff --git a/discord/styles/homepage.css b/discord/styles/homepage.css
diff --git a/discord/styles/theme.css b/discord/styles/theme.css
