fewer broken things

Author: JustinBeckwith

docs/activities/building-an-activity.mdx

@@ -129,7 +129,7 @@ As mentioned, installation contexts determine where your app can be installed. T
 - Apps installed in a **[server context](/docs/resources/application#server-context)** (server-installed apps) must be authorized by a server member with the `MANAGE_GUILD` permission, and are visible to all members of the server.
 - Apps installed in a **[user context](/docs/resources/application#user-context)** (user-installed apps) are visible only to the authorizing user, and therefore don't require any server-specific permissions. Apps installed to a user context are visible across all of the user's servers, DMs, and GDMs—however, they're limited to using commands.
 
-Details about installation contexts is in the [Application documentation](/docs/resources/application#installation-context) and the [Developing a User-Installable App tutorial](/docs/tutorials/develing-a-user-installable-app).
+Details about installation contexts is in the [Application documentation](/docs/resources/application#installation-context) and the [Developing a User-Installable App tutorial](/docs/tutorials/developing-a-user-installable-app).
 </Collapsible>
 
 Click on **Installation** in the left sidebar, then under **Installation Contexts** make sure both "User Install" and "Guild Install" are selected. This will make sure users can launch our app's Activity across Discord servers, DMs, and Group DMs.

docs/change-log/2021-11-23-guild-scheduled-events.md

@@ -7,11 +7,11 @@ date: "2021-11-23"
 
 #### Nov 18, 2021
 
-* Breaking change for return type for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}/users`
-* Add `with_user_count` query param for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}`
-* Return additional `creator` field by default in response for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}`
+* Breaking change for return type for `GET /guilds/{guild.id}/scheduled-events/{guild-scheduled-event.id}/users`
+* Add `with_user_count` query param for `GET /guilds/{guild.id}/scheduled-events/{guild-scheduled-event.id}`
+* Return additional `creator` field by default in response for `GET /guilds/{guild.id}/scheduled-events/{guild-scheduled-event.id}`
 * More details and clarification for the guild scheduled events feature.
-* Document support for `before` and `after` query params for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}/users`
+* Document support for `before` and `after` query params for `GET /guilds/{guild.id}/scheduled-events/{guild-scheduled-event.id}/users`
 
 #### Nov 15, 2021
 

docs/change-log/2022-06-16-auto-moderation.md

@@ -3,7 +3,7 @@ title: "Auto Moderation"
 date: "2022-06-16"
 ---
 
-Add new [Auto Moderation feature](/docs/resorces/auto-moderation) which enables guilds to moderate message content based on keywords, harmful links, and unwanted spam. This change includes:
+Add new [Auto Moderation feature](/docs/resources/auto-moderation) which enables guilds to moderate message content based on keywords, harmful links, and unwanted spam. This change includes:
 
 * New endpoints for [creating](/docs/resources/auto-moderation#create-auto-moderation-rule), [updating](/docs/resources/auto-moderation#modify-auto-moderation-rule), and [deleting](/docs/resources/auto-moderation#delete-auto-moderation-rule) Auto Moderation rules
 * New gateway events emitted when Auto Moderation rules are [created](/docs/events/gateway-events#auto-moderation-rule-create) (`AUTO_MODERATION_RULE_CREATE`), [updated](/docs/events/gateway-events#auto-moderation-rule-update) (`AUTO_MODERATION_RULE_UPDATE `), and [deleted](/docs/events/gateway-events#auto-moderation-rule-delete) (`AUTO_MODERATION_RULE_DELETE `). Requires the `AUTO_MODERATION_CONFIGURATION` (`1 << 20`) intent

docs/change-log/2022-09-21-auto-moderation-spam-and-mention-spam-trigger-types.md

@@ -8,4 +8,4 @@ Two new [trigger types](/docs/resources/auto-moderation#auto-moderation-rule-obj
 * `MENTION_SPAM` blocks messages that mention more than a set number of unique server members or roles. Apps can define the number (up to 50) using the `mention_total_limit` field in the [trigger metadata object](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) when creating or updating an Auto Moderation rule.
 * `SPAM` blocks links and messages that are identified as spam.
 
-More information can be found in the [Auto Moderation documentation](/docs/resorces/auto-moderation).
+More information can be found in the [Auto Moderation documentation](/docs/resources/auto-moderation).

docs/change-log/2022-12-12-add-application-connections-metadata-and-linked-roles.md

@@ -6,8 +6,8 @@ date: "2022-12-12"
 Introducing [linked roles](https://discord.com/blog/connected-accounts-functionality-boost-linked-roles) as well as the ability for all developers to set up their own linked roles with an application. This includes:
 
 * New [`role_connections_verification_url`](/docs/resources/application#application-object) that can be set in the developer portal in order for the application to render as potential verification option for linked roles.
-* [Application metadata](/docs/resources/application_ROLE_CONNECTION_METADATA/application-role-connection-metadata-object) to specify more detailed linked role requirements.
-* New endpoints to [retrieve](/docs/resources/application_ROLE_CONNECTION_METADATA/get-application-role-connection-metadata-records) (`GET /applications/<application.id>/role-connections/metadata`) and [update](/docs/resources/application_ROLE_CONNECTION_METADATA/update-application-role-connection-metadata-records) (`PUT /applications/<application.id>/role-connections/metadata`) application connection metadata.
+* [Application metadata](/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) to specify more detailed linked role requirements.
+* New endpoints to [retrieve](/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records) (`GET /applications/<application.id>/role-connections/metadata`) and [update](/docs/resources/application-role-connection-metadata#update-application-role-connection-metadata-records) (`PUT /applications/<application.id>/role-connections/metadata`) application connection metadata.
 * New [`role_connections.write`](/docs/topics/oauth2#shared-resources-oauth2-scopes) OAuth2 scope required to authenticate the below requests.
 * Endpoints to [retrieve](/docs/resources/user#get-current-user-application-role-connection) (`GET /users/@me/applications/{application.id}/role-connection`) and [update](/docs/resources/user#update-current-user-application-role-connection) (`PUT /users/@me/applications/{application.id}/role-connection`) a user's role connections, both of which return an [application role connection](/docs/resources/user#application-role-connection-object) object.
 

docs/change-log/2024-03-18-user-installable-apps-preview.md

@@ -7,7 +7,7 @@ topics:
 
 Apps can now be installed to users—making them easier to install, discover, and access across Discord. User-installed apps can be used across all of a user's servers, within their (G)DMs, and in DMs with the app's bot user.
 
-When creating or updating your app, you can choose which installation types your app supports on the **Installation** page in your [app's settings](https://discord.com/developers/applications). To quickly get started, you can follow the new [Developing a User-Installable App tutorial](/docs/tutorials/develing-a-user-installable-app) or read details about the new changes below.
+When creating or updating your app, you can choose which installation types your app supports on the **Installation** page in your [app's settings](https://discord.com/developers/applications). To quickly get started, you can follow the new [Developing a User-Installable App tutorial](/docs/tutorials/developing-a-user-installable-app) or read details about the new changes below.
 
 This change introduces new concepts and fields across the API that apps will now encounter—
 

docs/discord-social-sdk/core-concepts.mdx

@@ -28,7 +28,7 @@ To implement the Discord Social SDK, developers for all platforms will generally
    - Implement [unified friends list](/docs/discord-social-sdk/development-guides/creating-a-unified-friends-list) and [relationships](/docs/discord-social-sdk/development-guides/managing-relationships).
    - Use [rich presence](/docs/discord-social-sdk/development-guides/setting-rich-presence) for game activity updates.
    - Set up [lobbies](/docs/discord-social-sdk/development-guides/managing-lobbies) for multiplayer interaction and [game invites](/docs/discord-social-sdk/development-guides/managing-game-invites).
-   - Manage [direct message](/docs/discord-social-sdk/development-guides/sending-direct-messages), [linked channels](/docs/discord-social-sdk/development-guides/creating-a-unified-friends-list), and [voice communication](/docs/discord-social-sdk/development-guides_JOINING_VOICE_CHAT).
+   - Manage [direct message](/docs/discord-social-sdk/development-guides/sending-direct-messages), [linked channels](/docs/discord-social-sdk/development-guides/creating-a-unified-friends-list), and [voice communication](/docs/discord-social-sdk/development-guides/joining-voice-chat).
 5. Handle events & API calls:
    - Listen for changes in friend lists, presence updates, and chat messages.
    - Use Discord's APIs to update statuses, send messages, and manage connections.
@@ -97,12 +97,12 @@ Account linking allows a game to authenticate users with their Discord credentia
 | Development Guides                                                                                       |
 |----------------------------------------------------------------------------------------------------------|
 | [Account Linking with Discord](/docs/discord-social-sdk/development-guides/account-linking-with-discord) |
-| [Account Linking on Consoles](/docs/discord-social-sdk/development-guides_ACCOUNT_LINKING_ON_CONSOLES)   |
+| [Account Linking on Consoles](/docs/discord-social-sdk/development-guides/account-linking-on-consoles)   |
 
 | Design Guidelines                                                                |
 |----------------------------------------------------------------------------------|
-| [Signing in with Discord](/docs/discord-social-sdk/design-guidelines_SIGNING_IN) |
-| [Consoles](/docs/discord-social-sdk/design-guidelines_CONSOLES)                  |
+| [Signing in with Discord](/docs/discord-social-sdk/design-guidelines/signing-in) |
+| [Consoles](/docs/discord-social-sdk/design-guidelines/consoles)                  |
 
 ### Provisional Accounts
 
@@ -130,7 +130,7 @@ The SDK models friendships and relationships in two ways:
 | Design Guidelines                                                                       |
 |-----------------------------------------------------------------------------------------|
 | [Unified Friends List](/docs/discord-social-sdk/design-guidelines/provisional-accounts) |
-| [Game Friends](/docs/discord-social-sdk/design-guidelines_GAME_FRIENDS)                 |
+| [Game Friends](/docs/discord-social-sdk/design-guidelines/game-friends)                 |
 
 ### Messaging & Communication
 
@@ -142,11 +142,11 @@ Users can communicate via direct messages (DMs) and voice calls:
 | Development Guides                                                                             |
 |------------------------------------------------------------------------------------------------|
 | [Sending Direct Messages](/docs/discord-social-sdk/development-guides/sending-direct-messages) |
-| [Joining Voice Chat](/docs/discord-social-sdk/development-guides_JOINING_VOICE_CHAT)           |
+| [Joining Voice Chat](/docs/discord-social-sdk/development-guides/joining-voice-chat)           |
 
 | Design Guidelines                                                             |
 |-------------------------------------------------------------------------------|
-| [Direct Messages](/docs/discord-social-sdk/design-guidelines_DIRECT_MESSAGES) |
+| [Direct Messages](/docs/discord-social-sdk/design-guidelines/direct-messages) |
 
 ### Presence & Rich Presence
 
@@ -162,7 +162,7 @@ Presence refers to a user's online status, while Rich Presence provides game-spe
 
 | Design Guidelines                                                                         |
 |-------------------------------------------------------------------------------------------|
-| [Status & Rich Presence](/docs/discord-social-sdk/design-guidelines_STATUS_RICH_PRESENCE) |
+| [Status & Rich Presence](/docs/discord-social-sdk/design-guidelines/status-rich-presence) |
 
 ### Lobbies & In-Game Chat
 
@@ -181,11 +181,11 @@ Games can link in-game chat with Discord's server-based text channels in their U
 
 | Development Guides                                                             |
 |--------------------------------------------------------------------------------|
-| [Linked channels](/docs/discord-social-sdk/development-guides_LINKED_CHANNELS) |
+| [Linked channels](/docs/discord-social-sdk/development-guides/linked-channels) |
 
 | Design Guidelines                                                             |
 |-------------------------------------------------------------------------------|
-| [Linked channels](/docs/discord-social-sdk/design-guidelines_LINKED_CHANNELS) |
+| [Linked channels](/docs/discord-social-sdk/design-guidelines/linked-channels) |
 
 ---
 

docs/discord-social-sdk/design-guidelines.mdx

@@ -21,40 +21,40 @@ subpages:
 
 These design guidelines provide best practices and guidelines for designing social features in your game. Following these patterns can create a seamless and engaging user experience that leverages SDK social features to enhance your game. 
 
-If you are looking for a place to get started, we recommend you start with [Principles](/docs/discord-social-sdk/design-guidelines_PRINCIPLES) or the [Getting Started](/docs/discord-social-sdk/getting-started) guide.
+If you are looking for a place to get started, we recommend you start with [Principles](/docs/discord-social-sdk/design-guidelines/principles) or the [Getting Started](/docs/discord-social-sdk/getting-started) guide.
 
 <Container>
-  <Card title="Principles" link="/docs/discord-social-sdk/design-guidelines_PRINCIPLES" icon="CrownIcon">
+  <Card title="Principles" link="/docs/discord-social-sdk/design-guidelines/principles" icon="CrownIcon">
     Fundamental best practices for integrating Discord's social layer into your game. These principles ensure a seamless and engaging user experience.
   </Card>
-  <Card title="Signing In" link="/docs/discord-social-sdk/design-guidelines_SIGNING_IN" icon="UserPlusIcon">
+  <Card title="Signing In" link="/docs/discord-social-sdk/design-guidelines/signing-in" icon="UserPlusIcon">
     Strategies for implementing user authentication and account linking, allowing players to connect their Discord accounts with your game.
   </Card>
-  <Card title="Connection Points" link="/docs/discord-social-sdk/design-guidelines_CONNECTION_POINTS" icon="DpadIcon">
+  <Card title="Connection Points" link="/docs/discord-social-sdk/design-guidelines/connection-points" icon="DpadIcon">
     Key integration points where your game can interact with Discord's services, enhancing the overall player experience through seamless connectivity.
   </Card>
-  <Card title="Branding Guidelines" link="/docs/discord-social-sdk/design-guidelines_BRANDING_GUIDELINES" icon="ClydeIcon">
+  <Card title="Branding Guidelines" link="/docs/discord-social-sdk/design-guidelines/branding-guidelines" icon="ClydeIcon">
     Guidelines for using Discord's brand assets within your game, ensuring consistent and respectful representation of the Discord brand.
   </Card>
-  <Card title="Unified Friends List" link="/docs/discord-social-sdk/design-guidelines_UNIFIED_FRIENDS_LIST" icon="ContactsIcon">
+  <Card title="Unified Friends List" link="/docs/discord-social-sdk/design-guidelines/unified-friends-list" icon="ContactsIcon">
     Techniques for designing a unified friends list - allowing players to see and interact with their Discord friends directly within your game.
   </Card>
-  <Card title="Direct Messages" link="/docs/discord-social-sdk/design-guidelines_DIRECT_MESSAGES" icon="ChatIcon">
+  <Card title="Direct Messages" link="/docs/discord-social-sdk/design-guidelines/direct-messages" icon="ChatIcon">
     Best practices for enabling direct messaging between players, facilitating private communication, and enhancing social interactions.
   </Card>
   <Card title="Provisional Accounts" link="/docs/discord-social-sdk/design-guidelines/provisional-accounts" icon="UserIcon">
     Designing around provisional accounts for users who prefer not to link their Discord accounts, allowing them to enjoy social features still.
   </Card>
-  <Card title="Status & Rich Presence" link="/docs/discord-social-sdk/design-guidelines_STATUS_RICH_PRESENCE" icon="UserStatusIcon">
+  <Card title="Status & Rich Presence" link="/docs/discord-social-sdk/design-guidelines/status-rich-presence" icon="UserStatusIcon">
     Leveraging Discord's presence and rich presence features to display detailed player status and game activity for in-game social interactions.
   </Card>
-  <Card title="Consoles" link="/docs/discord-social-sdk/design-guidelines_CONSOLES" icon="GameControllerIcon">
+  <Card title="Consoles" link="/docs/discord-social-sdk/design-guidelines/consoles" icon="GameControllerIcon">
     Integrating Discord's social features on console platforms, ensuring a consistent experience across different devices.
   </Card>
-  <Card title="Game Friends" link="/docs/discord-social-sdk/design-guidelines_GAME_FRIENDS" icon="GroupIcon">
+  <Card title="Game Friends" link="/docs/discord-social-sdk/design-guidelines/game-friends" icon="GroupIcon">
     Techniques for managing and displaying in-game friends, allowing players to connect and play with their Discord friends easily.
   </Card>
-  <Card title="Linked Channels" link="/docs/discord-social-sdk/design-guidelines_LINKED_CHANNELS" icon="TextControllerIcon">
+  <Card title="Linked Channels" link="/docs/discord-social-sdk/design-guidelines/linked-channels" icon="TextControllerIcon">
     Guidelines for linking Discord channels to your game, enabling players to connect and communicate across different platforms.
   </Card>
 </Container>

docs/discord-social-sdk/design-guidelines/connection-points.mdx

@@ -14,7 +14,7 @@ If the game has account management, then this connection point is **required**,
 
 Discord's sign-in button is presented as the **primary option** to log-in for the player amongst the list of **external identity-providers** due to providing deeper user-benefits than a standard OAuth login.
 
-Please use the [**Blurple Button**](/docs/discord-social-sdk/design-guidelines_BRANDING_GUIDELINES/buttons) button styling for the sign-in connection point.
+Please use the [**Blurple Button**](/docs/discord-social-sdk/design-guidelines/branding-guidelines/buttons) button styling for the sign-in connection point.
 
 ![Signing In](images/social-sdk/design-guidelines/ConnectionPoints-03.png)
 

docs/discord-social-sdk/design-guidelines/consoles.mdx

@@ -40,15 +40,15 @@ Game chat will be available for games who support the feature on consoles. Howev
 
 ## Friends list on console
 
-Please leverage the same [friends list guidelines](/docs/discord-social-sdk/design-guidelines_UNIFIED_FRIENDS_LIST) previously documented in the playbook. There are no notable differences in the friends list on console in comparison to other devices. However, consoles do not support hover interactions so there needs to be console-friendly way for players to access secondary information (such as alternate identities) about friends in the list. 
+Please leverage the same [friends list guidelines](/docs/discord-social-sdk/design-guidelines/unified-friends-list) previously documented in the playbook. There are no notable differences in the friends list on console in comparison to other devices. However, consoles do not support hover interactions so there needs to be console-friendly way for players to access secondary information (such as alternate identities) about friends in the list. 
 
 ![chat on console](images/social-sdk/design-guidelines/Consoles-06.jpg)
 
 ---
 
 ## Resources 
 
-- [Development Guide: Account Linking on Consoles](/docs/discord-social-sdk/development-guides_ACCOUNT_LINKING_ON_CONSOLES)
+- [Development Guide: Account Linking on Consoles](/docs/discord-social-sdk/development-guides/account-linking-on-consoles)
 
 ## Change Log