Merge remote-tracking branch 'upstream/main'

Author: Lulalaby

CONTRIBUTING.md

@@ -81,7 +81,7 @@ Buttons are simply... clickable buttons. They take `href` and `color` as argumen
 ![Button MDX Component](images/mdx-button.png)
 
 ```markdown
-<Button href="https://discord.com/developers/docs/getting-started" color="brand">click the button!</Button>
+<LinkButton to="https://discord.com/developers/docs/getting-started" color="brand">click the button!</LinkButton>
 ```
 
 #### Cards

docs/Intro.mdx

@@ -1,51 +1,76 @@
 ---
 showTOC: false
+sidebar_label: Intro
 ---
 
-![Welcome to the Discord Developer Platform](docs-header.svg)
-
-# Welcome to the Discord Developer Platform
-
-The Discord developer platform lets you develop apps to customize and extend Discord for millions of users. A toolkit of [APIs](#DOCS_REFERENCE) and [resources](#DOCS_DEVELOPER_TOOLS_COMMUNITY_RESOURCES) pair splendidly with a supportive community to help you build bots, integrate 3rd party services, and add Discord support to your game.
-
-<Button href="https://discord.com/developers/docs/getting-started" color="brand">Get Started</Button>
-
----
-
-## Explore the Platform
-
-#### Engage with Users
-
-Add interactivity to your app with [commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS) and [message components](#DOCS_INTERACTIONS_MESSAGE_COMPONENTS) to build engaging experiences in the place where users are already hanging out.
-
-#### Customize Servers
-
-Customize Discord servers by using apps to do things like [send messages](#DOCS_RESOURCES_MESSAGE/create-message), modify [channels](#DOCS_RESOURCES_CHANNEL) and [guilds](#DOCS_RESOURCES_GUILD), [integrate with AutoMod](#DOCS_RESOURCES_AUTO_MODERATION), or [connect to voice](#DOCS_TOPICS_VOICE_CONNECTIONS).
-
-Plus, use the [Gateway API](#DOCS_TOPICS_GATEWAY) to respond to [real-time events](#DOCS_TOPICS_GATEWAY_EVENTS/receive-events) happening in a server, like when a reaction is added to a message.
-
-#### Connect Metadata
-
-Link and update metadata to enhance Discord for users. Add [Rich Presence](#DOCS_RICH_PRESENCE_OVERVIEW) to display live data on users' profiles, or [connection metadata](#DOCS_RESOURCES_APPLICATION_ROLE_CONNECTION_METADATA) to make it easy for admins to create roles using metadata associated with your app.
-
-#### Build Interactive Activities and Games
-
-Currently in Developer Preview, the [Embedded App SDK](#DOCS_DEVELOPER_TOOLS_EMBEDDED_APP_SDK) allows you to build [Activities](#DOCS_ACTIVITIES_OVERVIEW), such as multiplayer games or social experiences, that run inside Discord.
-
-## Discover Developer Resources
-
-#### Find Tools and Libraries
-
-The Discord developer community has built and maintained a ton of different [libraries and tools](#DOCS_DEVELOPER_TOOLS_COMMUNITY_RESOURCES/libraries) over the years. No matter your experience level or language of choice, there are resources to speed up and simplify app development for you over on the [Community Resources](#DOCS_DEVELOPER_TOOLS_COMMUNITY_RESOURCES) page.
-
-You can also check out our [Postman collections](https://www.postman.com/discord-api) to try and test API endpoints.
-
-#### Connect with Support
-
-- Join the [Discord Developers server](https://discord.gg/discord-developers) for support, discussion, and events about the Discord developer platform.
-- Explore the [Developer Help Center](https://support-dev.discord.com/hc) to find articles about common topics and questions, or to reach directly out to our developer support team.
-- Use our [GitHub](https://github.com/discord/discord-api-docs) to report API bugs, start a discussion about a developer feature request, or suggest an edit to our open source developer documentation.
-
-So go ahead and [build an app](https://discord.com/developers/applications)! We can’t wait to see what you make.
-
-— Discord
+<Hero title="Build Where the World Plays" subheading="Build social games, experiences, and integrations for millions of users on Discord" />
+
+## Get Started
+
+Learn more about what apps can do on Discord or jump right into building your own.
+
+<Container>
+  <Card title="Overview of Apps" link="#DOCS_QUICK_START_OVERVIEW_OF_APPS" icon="AppsIcon">
+    Learn more about the different types of apps you can build on Discord and how users can interact with them
+  </Card>
+  <Card title="Build your First Discord App" link="#DOCS_QUICK_START_GETTING_STARTED" icon="RobotIcon">
+    Follow the guide to build a Discord app with interactive features like commands and message components.
+  </Card>
+  <Card title="Build a Discord Activity" link="#DOCS_ACTIVITIES_BUILDING_AN_ACTIVITY" icon="GameControllerIcon">
+    Follow the guide to build an Activity in Discord using the Embedded App SDK.
+  </Card>
+</Container>
+
+## Discover Platform Features
+
+Learn about different features and explore their reference documentation to bring your idea to life.
+
+<Container>
+  <Card title="Messaging" link="#DOCS_RESOURCES_MESSAGE" icon="ChatIcon">
+    Send, retrieve, and manage messages in channels where your app has access.
+  </Card>
+  <Card title="Message Components" link="#DOCS_INTERACTIONS_OVERVIEW/message-components" icon="SparklesIcon">
+    Add interactive elements like buttons and select menus in messages sent by your app.
+  </Card>
+  <Card title="Commands" link="#DOCS_INTERACTIONS_OVERVIEW/commands" icon="SlashBoxIcon">
+    Create interactive entry points for your app's features that can be accessed across Discord.
+  </Card>
+  <Card title="Activities" link="#DOCS_ACTIVITIES_OVERVIEW" icon="GameControllerIcon">
+    Build embedded games and social experiences that are launchable in Discord.
+  </Card>
+  <Card title="Monetization" link="#DOCS_MONETIZATION_OVERVIEW" icon="PiggyBankIcon">
+    Integrate native monetization features like subscriptions and one-time purchases.
+  </Card>
+  <Card title="Rich Presence" link="#DOCS_RICH_PRESENCE_OVERVIEW" icon="UserIcon">
+    Display actionable data in a user's profile about what they're doing in your game or app.
+  </Card>
+</Container>
+
+## Explore the APIs
+
+Learn about some of the different APIs Discord apps have access to.
+
+<Container>
+  <Card title="HTTP API" link="#DOCS_REFERENCE/http-api">
+    Fetch information about and modify core Discord resources like channels, servers, users, and messages.
+  </Card>
+  <Card title="Gateway API" link="#DOCS_REFERENCE/gateway-websocket-api" >
+    Receive and send realtime events over a WebSocket connection for things happening in Discord.
+  </Card>
+</Container>
+
+## Find Support
+
+Reach out to the community or developer support to get support and stay updated about API changes.
+
+<Container>
+  <Card title="Discord Developer Server" link="https://discord.gg/discord-developers" icon="ClydeIcon">
+   Join our community for support, API announcements, and events hosted by Discord staff.
+  </Card>
+  <Card title="Find us on GitHub" link="https://github.com/discord/discord-api-docs" icon="ForumIcon">
+    Visit us on GitHub to report API bugs, provide platform feature requests, or to suggest updates to the documentation.
+  </Card>
+  <Card title="Developer Help Center" link="https://support-dev.discord.com" icon="UnknownGameIcon">
+    Find articles on common topics and questions, or reach directly out to the developer support team.
+  </Card>
+</Container>

docs/Reference.mdx

@@ -126,7 +126,7 @@ All HTTP-layer services and protocols (e.g. HTTP, WebSocket) within the Discord
 
 ## Snowflakes
 
-Discord utilizes Twitter's [snowflake](https://github.com/twitter-archive/snowflake/tree/snowflake-2010) format for uniquely identifiable descriptors (IDs). These IDs are guaranteed to be unique across all of Discord, except in some unique scenarios in which child objects share their parent's ID. Because Snowflake IDs are up to 64 bits in size (e.g. a uint64), they are always returned as strings in the HTTP API to prevent integer overflows in some languages. See [Gateway ETF/JSON](#DOCS_TOPICS_GATEWAY/encoding-and-compression) for more information regarding Gateway encoding.
+Discord utilizes Twitter's [snowflake](https://github.com/twitter-archive/snowflake/tree/snowflake-2010) format for uniquely identifiable descriptors (IDs). These IDs are guaranteed to be unique across all of Discord, except in some unique scenarios in which child objects share their parent's ID. Because Snowflake IDs are up to 64 bits in size (e.g. a uint64), they are always returned as strings in the HTTP API to prevent integer overflows in some languages. See [Gateway ETF/JSON](#DOCS_EVENTS_GATEWAY/encoding-and-compression) for more information regarding Gateway encoding.
 
 ###### Snowflake ID Broken Down in Binary
 
@@ -235,6 +235,10 @@ Clients may append more information and metadata to the _end_ of this string as
 > warn
 > Client requests that do not have a valid User Agent specified may be blocked and return a [Cloudflare error](https://support.cloudflare.com/hc/en-us/articles/360029779472-Troubleshooting-Cloudflare-1XXX-errors).
 
+### Content Type
+
+Clients using the HTTP API must provide a valid `Content-Type` header, either `application/json`, `application/x-www-form-urlencoded`, or `multipart/form-data`, except where specified. Failing to do so will result in a `50035` "Invalid form body" error.
+
 ### Rate Limiting
 
 The HTTP API implements a process for limiting and preventing excessive requests in accordance with [RFC 6585](https://tools.ietf.org/html/rfc6585#section-4). API users that regularly hit and ignore rate limits will have their API keys revoked, and be blocked from the platform. For more information on rate limiting of requests, please see the [Rate Limits](#DOCS_TOPICS_RATE_LIMITS/rate-limits) section.
@@ -245,7 +249,7 @@ Certain endpoints in the API are documented to accept booleans for their query s
 
 ## Gateway (WebSocket) API
 
-Discord's Gateway API is used for maintaining persistent, stateful websocket connections between your client and our servers. These connections are used for sending and receiving real-time events your client can use to track and update local state. The Gateway API uses secure websocket connections as specified in [RFC 6455](https://tools.ietf.org/html/rfc6455). For information on opening Gateway connections, please see the [Gateway API](#DOCS_TOPICS_GATEWAY/connections) section.
+Discord's Gateway API is used for maintaining persistent, stateful websocket connections between your client and our servers. These connections are used for sending and receiving real-time events your client can use to track and update local state. The Gateway API uses secure websocket connections as specified in [RFC 6455](https://tools.ietf.org/html/rfc6455). For information on opening Gateway connections, please see the [Gateway API](#DOCS_EVENTS_GATEWAY/connections) section.
 
 ## Message Formatting
 
@@ -293,11 +297,13 @@ Timestamps are expressed in seconds and display the given timestamp in the user'
 
 Guild navigation types link to the corresponding resource in the current server.
 
-| Type      | Description                                                                                           |
-|-----------|-------------------------------------------------------------------------------------------------------|
-| customize | _Customize_ tab with the server's [onboarding prompts](#DOCS_RESOURCES_GUILD/guild-onboarding-object) |
-| browse    | _Browse Channels_ tab                                                                                 |
-| guide     | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655)                          |
+| Type                 | Description                                                                                           |
+|----------------------|-------------------------------------------------------------------------------------------------------|
+| customize            | _Customize_ tab with the server's [onboarding prompts](#DOCS_RESOURCES_GUILD/guild-onboarding-object) |
+| browse               | _Browse Channels_ tab                                                                                 |
+| guide                | [Server Guide](https://support.discord.com/hc/en-us/articles/13497665141655)                          |
+| linked-roles         | [Linked Roles](https://support.discord.com/hc/en-us/articles/10388356626711)                          |
+| linked-roles:ROLE_ID | _Linked Role_ connection                                                                              |
 
 ## Image Formatting
 
@@ -335,7 +341,7 @@ Discord uses ids and hashes to render images in the client. These hashes can be
 | Avatar Decoration           | avatar-decoration-presets/[avatar_decoration_data_asset](#DOCS_RESOURCES_USER/avatar-decoration-data-object).png                                                                                                                                                                                                                                                              | PNG                  |
 | Application Icon            | app-icons/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/[icon](#DOCS_RESOURCES_APPLICATION/application-object).png                                                                                                                                                                                                                                         | PNG, JPEG, WebP      |
 | Application Cover           | app-icons/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/[cover_image](#DOCS_RESOURCES_APPLICATION/application-object).png                                                                                                                                                                                                                                  | PNG, JPEG, WebP      |
-| Application Asset           | app-assets/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/[asset_id](#DOCS_TOPICS_GATEWAY_EVENTS/activity-object-activity-assets).png                                                                                                                                                                                                                       | PNG, JPEG, WebP      |
+| Application Asset           | app-assets/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/[asset_id](#DOCS_EVENTS_GATEWAY_EVENTS/activity-object-activity-assets).png                                                                                                                                                                                                                       | PNG, JPEG, WebP      |
 | Achievement Icon            | app-assets/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/achievements/[achievement_id](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct)/icons/[icon_hash](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct).png | PNG, JPEG, WebP      |
 | Store Page Asset            | app-assets/[application_id](#DOCS_RESOURCES_APPLICATION/application-object)/store/asset_id                                                                                                                                                                                                                                                                                    | PNG, JPEG, WebP      |
 | Sticker Pack Banner         | app-assets/710982414301790216/store/[sticker_pack_banner_asset_id](#DOCS_RESOURCES_STICKER/sticker-pack-object).png                                                                                                                                                                                                                                                           | PNG, JPEG, WebP      |
@@ -391,7 +397,7 @@ https://cdn.discordapp.com/attachments/1012345678900020080/1234567891233211234/m
 ## Uploading Files
 
 > info
-> A file upload size limit applies to *all* files in a request (rather than each individual file). While the limit depends on the [**Boost Tier**](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-FAQ-#h_419c3bd5-addd-4989-b7cf-c7957ef92583) of a guild, it is `25 MiB` by default.
+> A file upload size limit applies to *all* files in a request (rather than each individual file). While the limit depends on the [**Boost Tier**](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-FAQ-#h_419c3bd5-addd-4989-b7cf-c7957ef92583) of a guild, it is `10 MiB` by default.
 
 Some endpoints support file attachments, indicated by the `files[n]` parameter. To add file(s), the standard `application/json` body must be replaced by a `multipart/form-data` body. The JSON message body can optionally be provided using the `payload_json` parameter.