diff --git a/docs/discord-social-sdk/development-guides.mdx b/docs/discord-social-sdk/development-guides.mdx
index cecdf7c255..4a9f33345b 100644
--- a/docs/discord-social-sdk/development-guides.mdx
+++ b/docs/discord-social-sdk/development-guides.mdx
@@ -13,9 +13,6 @@ subpages:
- development-guides/managing-lobbies.mdx
- development-guides/linked-channels.mdx
- development-guides/managing-voice-chat.mdx
- - development-guides/integrating-moderation.mdx
- - development-guides/debugging-logging.mdx
- - development-guides/using-with-discord-apis.mdx
---
[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > Development Guides
@@ -73,14 +70,4 @@ If you are new to the Discord Social SDK, we recommend you start with the [Getti
## Developer Best Practices
-
- Use logging and debugging tools to troubleshoot issues.
-
-
- Integrating and managing content moderation for your game when using the Discord Social SDK.
-
-
- Make requests to Discord's HTTP APIs from your game.
-
\ No newline at end of file
diff --git a/docs/discord-social-sdk/development-guides/managing-lobbies.mdx b/docs/discord-social-sdk/development-guides/managing-lobbies.mdx
index 2c86aae655..98609a654c 100644
--- a/docs/discord-social-sdk/development-guides/managing-lobbies.mdx
+++ b/docs/discord-social-sdk/development-guides/managing-lobbies.mdx
@@ -62,7 +62,7 @@ There are two ways to manage lobbies:
You can use the Discord HTTP API to create, update, and delete lobbies and manage lobby membership.
-See the [Lobby](/docs/resources/lobby) API resource for available endpoints and [Using with Discord APIs](/docs/discord-social-sdk/development-guides/using-with-discord-apis) for information on how to authenticate your requests.
+See the [Lobby](/docs/resources/lobby) API resource for available endpoints and [Use with Discord APIs](/docs/discord-social-sdk/how-to/use-with-discord-apis) for information on how to authenticate your requests.
:::info
Clients will not be able to use [`Client::CreateOrJoinLobby`] or [`Client::LeaveLobby`] with lobbies created using the API.
diff --git a/docs/discord-social-sdk/development-guides/managing-voice-chat.mdx b/docs/discord-social-sdk/development-guides/managing-voice-chat.mdx
index 2f80e9c1e6..33081b5e9b 100644
--- a/docs/discord-social-sdk/development-guides/managing-voice-chat.mdx
+++ b/docs/discord-social-sdk/development-guides/managing-voice-chat.mdx
@@ -278,11 +278,11 @@ This information is particularly useful for:
## Next Steps
-
Integrating and managing content moderation for your game when using the Discord Social SDK.
-
+
Make requests to Discord's HTTP APIs from your game.
-
- Handling Unicode characters in Discord Display Names for your game's chat and friend lists.
-
+
+ Use logging and debugging tools to troubleshoot issues.
+
+
+ Make requests to Discord's HTTP APIs from your game.
+
+
+ Integrating and managing content moderation for your game when using the Discord Social SDK.
+
+
+ Handling Unicode characters in Discord Display Names for your game's chat and friend lists.
+
---
@@ -23,4 +38,5 @@ These how-to guides offer common solutions for integrating Discord Social SDK fe
| Date | Changes |
|---------------|-----------------------|
+| July 23, 2025 | migrated several docs |
| June 17, 2025 | added How To category |
\ No newline at end of file
diff --git a/docs/discord-social-sdk/development-guides/debugging-logging.mdx b/docs/discord-social-sdk/how-to/debug-log.mdx
similarity index 94%
rename from docs/discord-social-sdk/development-guides/debugging-logging.mdx
rename to docs/discord-social-sdk/how-to/debug-log.mdx
index 924efa750d..fbfefc1856 100644
--- a/docs/discord-social-sdk/development-guides/debugging-logging.mdx
+++ b/docs/discord-social-sdk/how-to/debug-log.mdx
@@ -1,10 +1,10 @@
---
-sidebar_label: Debugging & Logging
+sidebar_label: Debug & Log
---
import PublicClient from '../partials/callouts/public-client.mdx';
import SupportCallout from '../partials/callouts/support.mdx';
-[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Development Guides](/docs/discord-social-sdk/development-guides) > {sidebar_label}
+[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [How To](/docs/discord-social-sdk/how-to) > {sidebar_label}
# {sidebar_label}
diff --git a/docs/discord-social-sdk/development-guides/integrating-moderation.mdx b/docs/discord-social-sdk/how-to/integrate-moderation.mdx
similarity index 99%
rename from docs/discord-social-sdk/development-guides/integrating-moderation.mdx
rename to docs/discord-social-sdk/how-to/integrate-moderation.mdx
index c2c410e087..9ac42b970b 100644
--- a/docs/discord-social-sdk/development-guides/integrating-moderation.mdx
+++ b/docs/discord-social-sdk/how-to/integrate-moderation.mdx
@@ -1,10 +1,10 @@
---
-sidebar_label: Integrating Moderation
+sidebar_label: Integrate Moderation
---
import PublicClient from '../partials/callouts/public-client.mdx';
import SupportCallout from '../partials/callouts/support.mdx';
-[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Development Guides](/docs/discord-social-sdk/development-guides) > {sidebar_label}
+[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [How To](/docs/discord-social-sdk/how-to) > {sidebar_label}
# Moderation with the Discord Social SDK
diff --git a/docs/discord-social-sdk/development-guides/using-with-discord-apis.mdx b/docs/discord-social-sdk/how-to/use-with-discord-apis.mdx
similarity index 96%
rename from docs/discord-social-sdk/development-guides/using-with-discord-apis.mdx
rename to docs/discord-social-sdk/how-to/use-with-discord-apis.mdx
index fd4b699be9..e7a0d4e69e 100644
--- a/docs/discord-social-sdk/development-guides/using-with-discord-apis.mdx
+++ b/docs/discord-social-sdk/how-to/use-with-discord-apis.mdx
@@ -1,10 +1,10 @@
---
-sidebar_label: Using with Discord APIs
+sidebar_label: Use with Discord APIs
---
import PublicClient from '../partials/callouts/public-client.mdx';
import SupportCallout from '../partials/callouts/support.mdx';
-[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Development Guides](/docs/discord-social-sdk/development-guides) > {sidebar_label}
+[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [How To](/docs/discord-social-sdk/how-to) > {sidebar_label}
# {sidebar_label}