Docs Platform Migration

[colinloretz]

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 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 after Nov 7, the migration is complete! 🎉

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. 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.

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 to collect feedback.

See our Contributing Guidelines for how to get involved.

[anthonydiscord]

First

[markmandel]

Second.

[colinloretz]

We are merging this now and will be pointing the docs to the new platform today.

[markmandel]