From 15a160e1e587a4cea6e1c3a00b899e2629b91919 Mon Sep 17 00:00:00 2001
From: Armano den Boef <68127614+Rozen4334@users.noreply.github.com>
Date: Sun, 17 Oct 2021 16:27:35 +0200
Subject: [PATCH] FAQ revamped, metadata updated (#241)
* FAQ revamped, metadata updated
* Update FAQ.md
* Update README.md
* Docs index improvement
---
FAQ.md | 50 ++++++
README.md | 158 ++++++------------
docs/docfx.json | 7 +-
docs/faq/basics/basic-operations.md | 123 --------------
docs/faq/basics/client-basics.md | 94 -----------
docs/faq/basics/getting-started.md | 82 ---------
docs/faq/basics/images/dev-mode.png | Bin 80742 -> 0 bytes
docs/faq/basics/images/mention-escape.png | Bin 19611 -> 0 bytes
docs/faq/basics/images/role-copy.png | Bin 16091 -> 0 bytes
docs/faq/basics/images/snowflake.png | Bin 73062 -> 0 bytes
docs/faq/basics/samples/cast.cs | 15 --
docs/faq/basics/samples/emoji-others.cs | 18 --
docs/faq/basics/samples/emoji-self.cs | 17 --
docs/faq/commands/dependency-injection.md | 54 ------
docs/faq/commands/general.md | 147 ----------------
docs/faq/commands/samples/DI.cs | 28 ----
docs/faq/commands/samples/Remainder.cs | 20 ---
docs/faq/commands/samples/missing-dep.cs | 29 ----
.../faq/commands/samples/runmode-cmdattrib.cs | 7 -
.../faq/commands/samples/runmode-cmdconfig.cs | 10 --
docs/faq/misc/glossary.md | 82 ---------
docs/faq/misc/legacy.md | 29 ----
docs/faq/toc.yml | 18 --
docs/index.md | 24 ++-
.../SVG/Combinationmark White Background.svg | 84 ++++------
.../logo/SVG/Combinationmark White Border.svg | 30 ++++
docs/toc.yml | 3 +-
27 files changed, 182 insertions(+), 947 deletions(-)
create mode 100644 FAQ.md
delete mode 100644 docs/faq/basics/basic-operations.md
delete mode 100644 docs/faq/basics/client-basics.md
delete mode 100644 docs/faq/basics/getting-started.md
delete mode 100644 docs/faq/basics/images/dev-mode.png
delete mode 100644 docs/faq/basics/images/mention-escape.png
delete mode 100644 docs/faq/basics/images/role-copy.png
delete mode 100644 docs/faq/basics/images/snowflake.png
delete mode 100644 docs/faq/basics/samples/cast.cs
delete mode 100644 docs/faq/basics/samples/emoji-others.cs
delete mode 100644 docs/faq/basics/samples/emoji-self.cs
delete mode 100644 docs/faq/commands/dependency-injection.md
delete mode 100644 docs/faq/commands/general.md
delete mode 100644 docs/faq/commands/samples/DI.cs
delete mode 100644 docs/faq/commands/samples/Remainder.cs
delete mode 100644 docs/faq/commands/samples/missing-dep.cs
delete mode 100644 docs/faq/commands/samples/runmode-cmdattrib.cs
delete mode 100644 docs/faq/commands/samples/runmode-cmdconfig.cs
delete mode 100644 docs/faq/misc/glossary.md
delete mode 100644 docs/faq/misc/legacy.md
delete mode 100644 docs/faq/toc.yml
create mode 100644 docs/marketing/logo/SVG/Combinationmark White Border.svg
diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 000000000..fbae6d524
--- /dev/null
+++ b/FAQ.md
@@ -0,0 +1,50 @@
+# Frequently Asked Questions
+
+#### Whats the difference between DNet and DNet Labs?
+DNet Labs is mostly the same as DNet as it just adds additional features. Discord.NET-labs adds several features Discord.NET does not. Examples of this are: Threads, application commands, message components, stage channels, role icons & more small functionality changes. More details [here](https://github.com/discord-net/Discord.Net/pull/1923).
+
+#### Should I use DNet Labs instead of DNet? or can I use both at the same time?
+DNet Labs implements new experimental/unstable features and generally shouldn't be used in production environments. You should only use it if you want to test out new Discord features. As DNet Labs builds on top of DNet, you can not use both at the same time, however DNet Labs should be a pretty straight forward drop-in replacement for DNet.
+
+#### Why is x not doing y when it should?
+Double check you are on the most recent version of Discord .Net labs, if you are and it looks like an issue, report it on [Discord](https://discord.com/invite/dnet-labs) or create an issue on [GitHub](https://github.com/Discord-Net-Labs/Discord.Net-Labs)
+
+#### When is feature x going to be added?
+When someone adds it. If a new Discord feature is currently untouched, submit an issue on [GitHub](https://github.com/Discord-Net-Labs/Discord.Net-Labs) regarding the request.
+
+#### What's the difference between RespondAsync, DeferAsync and FollowupAsync?
+The difference between these 3 functions is in how you handle the command response. [RespondAsync](https://discord-net-labs.com/api/Discord.WebSocket.SocketCommandBase.html#Discord_WebSocket_SocketCommandBase_DeferAsync_System_Boolean_Discord_RequestOptions_) and [DeferAsync](https://discord-net-labs.com/api/Discord.WebSocket.SocketCommandBase.html#Discord_WebSocket_SocketCommandBase_DeferAsync_System_Boolean_Discord_RequestOptions_) let the API know you have succesfully received the command. This is also called 'acknowledging' a command. DeferAsync will not send out a response, RespondAsync will not. [FollowupAsync](https://discord-net-labs.com/api/Discord.WebSocket.SocketCommandBase.html#Discord_WebSocket_SocketCommandBase_DeferAsync_System_Boolean_Discord_RequestOptions_) follows up on succesful acknowledgement.
+
+> [!WARNING]
+> If you have not acknowledged the command FollowupAsync will not work.
+
+#### What's the difference between global commands and guild commands? (Why isn't my command show up in discord?)
+Global commands can be used in every guild your bot is in. However, it can take up to an hour for every guild to have access to the commands.
+Guild commands can only be used in specific guilds. They are available within a few minutes. (This is great for testing purposes).
+
+#### I'm getting a 50001: Missing access error while trying to create a guild command!
+Guild commands require you give grant the bot the applications.commands OAuth2 scope in order to register guild commands in that guild. You can register global commands without this OAuth2 scope but will need it to use global commands in that guild.
+
+#### I'm getting errors when trying to create a slash command (The application command failed to be created, 400 bad request, 50035: Invalid Form Body, etc)
+This could be caused by several things but the most common one is an invalid "Name" for the command or any of the options/arguments for the command. Make sure your "Name" is all lowercase and only contains letters or dashes. It should also be less than 32 characters. If you are still having issues after checking this, read up on the other slash commands limits [here](https://discord.com/developers/docs/interactions/slash-commands#a-quick-note-on-limits).
+
+> [!NOTE]
+> In most cases, you can catch an [ApplicationCommandException](https://discord-net-labs.com/api/Discord.Net.ApplicationCommandException.html?q=applicationcommandexception) error from creation.
+> This exception will tell you what part of your command is invalid as well as why.
+
+#### How can I use Victoria with Labs?
+You can add a special build of victoria that supports labs by adding the below to your references:
+```xml
+
+ https://www.myget.org/F/yucked/api/v3/index.json
+
+```
+
+#### I'm getting a 10062 exception: Unknown Interaction. What can I do?
+This exception happens when an app tries to send an initial response to an interaction twice. This can be caused by:
+- 2 instances of your app running at once.
+- Responding 3+ seconds after the interaction was received.
+If you're positive that your app doesn't do this and you are still receiving the exception, please submit an issue.
+
+#### Why is BannerId/AccentColour always null?
+Currently SocketUser/SocketGuildUser does not expose the [BannerId](https://discord-net-labs.com/api/Discord.IUser.html#Discord_IUser_BannerId) nor [AccentColor](https://discord-net-labs.com/api/Discord.IUser.html#Discord_IUser_AccentColor). To get this info, a [RestUser](https://discord-net-labs.com/api/Discord.Rest.RestUser.html?q=RestUser) must be requested.
diff --git a/README.md b/README.md
index c3343cd38..789119574 100644
--- a/README.md
+++ b/README.md
@@ -20,17 +20,60 @@
This repo is a custom fork of Discord.Net that introduces the newest features of discord for testing and experimenting. Nothing here is guaranteed to work but you are more than welcome to submit bugs in the issues tabs
-### ♥ Sponsor us!
+----
+
+- 📄 [Documentation](https://discord-net-labs.com)
+- 🔗 [Support](https://discord.com/invite/dnet-labs)
+- 📚 [Guides](https://discord-net-labs.com/guides/introduction/intro.html)
+
+## Sponsor us! ❤
- If this library benefits you consider [sponsoring](https://github.com/sponsors/quinchs) the project as it really helps out. *Only sponsor if you're financially stable!*
-## Known issues
-Labs will not work with normal package of Playwo's [InteractivityAddon](https://www.nuget.org/packages/Discord.InteractivityAddon). The reason is that his package depends on the base discord.net lib. You can instead use the [InteractivityAddon.Labs](https://www.nuget.org/packages/Discord.InteractivityAddon.Labs) package which implements some of the features added in Discord.Net-Labs.
+## Known compatibility issues
+
+- Playwo's [InteractivityAddon](https://www.nuget.org/packages/Discord.InteractivityAddon)
+ * ❌ Reason: The default package depends on Discord.NET instead of labs.
+ * ✔ Fix: [InteractivityAddon.Labs](https://www.nuget.org/packages/Discord.InteractivityAddon.Labs), which implements some of the features added in Discord.Net-Labs.
+
+- [Victoria](https://github.com/Yucked/Victoria)
+ * ❌ Reason: Victoria is built around Discord.NET and is not supported by labs.
+ * ✔ Fix: A custom build based on Discord.NET-labs:
+```xml
+
+ https://www.myget.org/F/yucked/api/v3/index.json
+
+```
## How to use
Setting up labs in your project is really simple, here's how to do it:
1) Remove Discord.Net from your project
2) Add Discord.Net Labs nuget to your project
-3) Enjoy!
+3) That's all!
+
+## Implementations
+What Discord.NET-labs has that Discord.NET does not:
+
+- Major changes
+ * Added Interaction Support.
+ * Added Application commands (slash, user, message).
+ * Added Message Components (buttons, select menus).
+ * Added Thread Channels.
+ * Added Stage Channels.
+ * Revamped Stickers.
+
+- Minor changes
+ * Added `TimestampTag`.
+ * Made `Hierarchy` a `IGuildUser` property.
+ * Changes embed discription length to 4096.
+ * Added `Name` property to teams.
+ * Added url validation to embeds.
+ * Added `NsfwLevel` to Guilds.
+ * Added helpers to `Emoji` for parsing.
+ * Fixed gateway serialization to include nulls.
+ * Added banner and accent color to guild users.
+ * Fixed `CurrentUserId` in sharded clients being null.
+ * Fixed Guild owner and Admin `GuildPermissions.All`.
+ * Added `RatelimitCallback` to `RequestOptions`.
## Branches
@@ -45,110 +88,3 @@ This branch is on pause and does not work currently, There is a pull request ope
### feature/xyz
These branches are features for new things, you are more than welcome to clone them and give feedback in the discord server or issues tab.
-
-## Listening for Interactions
-
-Interaction docs can be found [here](https://github.com/Discord-Net-Labs/Discord.Net-Labs/tree/release/3.x/docs/guides/interactions). They are much more in depth than this readme.
-
-```cs
-// Subscribe to the InteractionCreated event
-client.InteractionCreated += Client_InteractionCreated;
-
-...
-private async Task Client_InteractionCreated(SocketInteraction interaction)
-{
- // Checking the type of this interaction
- switch (interaction)
- {
- // Slash commands
- case SocketSlashCommand commandInteraction:
- await MySlashCommandHandler(commandInteraction);
- break;
-
- // Button clicks/selection dropdowns
- case SocketMessageComponent componentInteraction:
- await MyMessageComponentHandler(componentInteraction);
- break;
-
- // Unused or Unknown/Unsupported
- default:
- break;
- }
-}
-```
-
-### Simple handling slash commands
-```cs
-private async Task MySlashCommandHandler(SocketSlashCommand interaction)
-{
- // Checking command name
- if (interaction.Data.Name == "ping")
- {
- // Respond to interaction with message.
- // You can also use "ephemeral" so that only the original user of the interaction sees the message
- await interaction.RespondAsync($"Pong!", ephemeral: true);
-
- // Also you can followup with a additional messages, which also can be "ephemeral"
- await interaction.FollowupAsync($"PongPong!", ephemeral: true);
- }
-}
-```
-
-### Simple handling button clicks and selection dropdowns
-```cs
-private async Task MyMessageComponentHandler(SocketMessageComponent interaction)
-{
- // Get the custom ID
- var customId = interaction.Data.CustomId;
- // Get the user
- var user = (SocketGuildUser) interaction.User;
- // Get the guild
- var guild = user.Guild;
-
- // Respond with the update message. This edits the message which this component resides.
- await interaction.UpdateAsync(msgProps => msgProps.Content = $"Clicked {interaction.Data.CustomId}!");
-
- // Also you can followup with a additional messages
- await interaction.FollowupAsync($"Clicked {interaction.Data.CustomId}!", ephemeral: true);
-
- // If you are using selection dropdowns, you can get the selected label and values using these
- var selectedLabel = ((SelectMenu) interaction.Message.Components.First().Components.First()).Options.FirstOrDefault(x => x.Value == interaction.Data.Values.FirstOrDefault())?.Label;
- var selectedValue = interaction.Data.Values.First();
-}
-```
-
-> Note: The example above assumes that the selection dropdown is expecting only 1 returned value, if you configured your dropdown for multiple values, you'll need to modify the code slightly.
-
-### Sending messages with buttons
-Theres a new field in all `SendMessageAsync` functions that takes in a `MessageComponent`, you can use it like so:
-```cs
-var builder = new ComponentBuilder().WithButton("Hello!", customId: "id_1", ButtonStyle.Primary, row: 0);
-await Context.Channel.SendMessageAsync("Test buttons!", component: builder.Build());
-```
-
-### Sending messages with selection dropdowns
-Theres a new field in all `SendMessageAsync` functions that takes in a `MessageComponent`, you can use it like so:
-```cs
-var builder = new ComponentBuilder()
- .WithSelectMenu(new SelectMenuBuilder()
- .WithCustomId("id_2")
- .WithPlaceholder("This is a placeholder")
- .AddOption(
- label: "Option",
- value: "value1",
- description: "Evan pog champ",
- emote: Emote.Parse("<:evanpog:810017136814194698>")
- )
- .AddOption("Option B", "value2", "Option B is poggers")
- );
-
-await Context.Channel.SendMessageAsync("Test selection!", component: builder.Build());
-```
-
-> Note: You can only have 5 buttons per row and 5 rows per message. If a row contains a selection dropdown it cannot contain any buttons.
-
-## Slash Commands & Context Menu Commands
-Slash command & Context command examples and how to's can be found [here](https://github.com/Discord-Net-Labs/Discord.Net-Labs/tree/release/3.x/docs/guides/interactions/application-commands).
-
-## Message Components
-Message components (buttons, menus, etc) examples and how to's can be found [here](https://github.com/Discord-Net-Labs/Discord.Net-Labs/tree/release/3.x/docs/guides/interactions/message-components)
diff --git a/docs/docfx.json b/docs/docfx.json
index 424b951bc..9179035fd 100644
--- a/docs/docfx.json
+++ b/docs/docfx.json
@@ -23,7 +23,8 @@
"files": ["toc.yml", "index.md"]
},
{
- "files": ["faq/**.md", "faq/**/toc.yml"]
+ "src": "../",
+ "files": ["FAQ.md"]
},
{
"files": ["guides/**.md", "guides/**/toc.yml"]
@@ -59,8 +60,8 @@
],
"overwrite": "_overwrites/**/**.md",
"globalMetadata": {
- "_appTitle": "Discord.Net Documentation",
- "_appFooter": "Discord.Net (c) 2015-2020 2.2.0",
+ "_appTitle": "Discord.Net-Labs Documentation",
+ "_appFooter": "Discord.Net-Labs (c) 2020-2021 3.1.6",
"_enableSearch": true,
"_appLogoPath": "marketing/logo/SVG/Logomark Purple.svg",
"_appFaviconPath": "favicon.ico"
diff --git a/docs/faq/basics/basic-operations.md b/docs/faq/basics/basic-operations.md
deleted file mode 100644
index 35c71709f..000000000
--- a/docs/faq/basics/basic-operations.md
+++ /dev/null
@@ -1,123 +0,0 @@
----
-uid: FAQ.Basics.BasicOp
-title: Questions about Basic Operations
----
-
-# Basic Operations Questions
-
-In the following section, you will find commonly asked questions and
-answers regarding basic usage of the library, as well as
-language-specific tips when using this library.
-
-## How should I safely check a type?
-
-> [!WARNING]
-> Direct casting (e.g., `(Type)type`) is **the least recommended**
-> way of casting, as it *can* throw an [InvalidCastException]
-> when the object isn't the desired type.
->
-> Please refer to [this post] for more details.
-
-In Discord.Net, the idea of polymorphism is used throughout. You may
-need to cast the object as a certain type before you can perform any
-action.
-
-A good and safe casting example:
-
-[!code-csharp[Casting](samples/cast.cs)]
-
-[InvalidCastException]: https://docs.microsoft.com/en-us/dotnet/api/system.invalidcastexception
-[this post]: https://docs.microsoft.com/en-us/dotnet/csharp/how-to/safely-cast-using-pattern-matching-is-and-as-operators
-
-## How do I send a message?
-
-> [!TIP]
-> The [GetChannel] method by default returns an [IChannel], allowing
-> channel types such as [IVoiceChannel], [ICategoryChannel]
-> to be returned; consequently, you cannot send a message
-> to channels like those.
-
-Any implementation of [IMessageChannel] has a [SendMessageAsync]
-method. You can get the channel via [GetChannel] under the client.
-Remember, when using Discord.Net, polymorphism is a common recurring
-theme. This means an object may take in many shapes or form, which
-means casting is your friend. You should attempt to cast the channel
-as an [IMessageChannel] or any other entity that implements it to be
-able to message.
-
-[SendMessageAsync]: xref:Discord.IMessageChannel.SendMessageAsync*
-[GetChannel]: xref:Discord.WebSocket.DiscordSocketClient.GetChannel*
-
-## How can I tell if a message is from X, Y, Z channel?
-
-You may check the message channel type. Visit [Glossary] to see the
-various types of channels.
-
-[Glossary]: xref:FAQ.Glossary#message-channels
-
-## How can I get the guild from a message?
-
-There are 2 ways to do this. You can do either of the following,
-
-1. Cast the user as an [IGuildUser] and use its [IGuild] property.
-2. Cast the channel as an [IGuildChannel] and use its [IGuild] property.
-
-## How do I add hyperlink text to an embed?
-
-Embeds can use standard [markdown] in the description field as well
-as in field values. With that in mind, links can be added with
-`[text](link)`.
-
-[markdown]: https://support.discordapp.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-
-
-## How do I add reactions to a message?
-
-Any entity that implements [IUserMessage] has an [AddReactionAsync]
-method. This method expects an [IEmote] as a parameter.
-In Discord.Net, an Emote represents a custom-image emote, while an
-Emoji is a Unicode emoji (standard emoji). Both [Emoji] and [Emote]
-implement [IEmote] and are valid options.
-
-# [Adding a reaction to another message](#tab/emoji-others)
-
-[!code-csharp[Emoji](samples/emoji-others.cs)]
-
-# [Adding a reaction to a sent message](#tab/emoji-self)
-
-[!code-csharp[Emoji](samples/emoji-self.cs)]
-
-***
-
-[AddReactionAsync]: xref:Discord.IMessage.AddReactionAsync*
-
-## What is a "preemptive rate limit?"
-
-A preemptive rate limit is Discord.Net's way of telling you to slow
-down before you get hit by the real rate limit. Hitting a real rate
-limit might prevent your entire client from sending any requests for
-a period of time. This is calculated based on the HTTP header
-returned by a Discord response.
-
-## Why am I getting so many preemptive rate limits when I try to add more than one reactions?
-
-This is due to how HTML header works, mistreating
-0.25sec/action to 1sec. This causes the lib to throw preemptive rate
-limit more frequently than it should for methods such as adding
-reactions.
-
-## Can I opt-out of preemptive rate limits?
-
-Unfortunately, not at the moment. See [#401](https://github.com/RogueException/Discord.Net/issues/401).
-
-[IChannel]: xref:Discord.IChannel
-[ICategoryChannel]: xref:Discord.ICategoryChannel
-[IGuildChannel]: xref:Discord.IGuildChannel
-[ITextChannel]: xref:Discord.ITextChannel
-[IGuild]: xref:Discord.IGuild
-[IVoiceChannel]: xref:Discord.IVoiceChannel
-[IGuildUser]: xref:Discord.IGuildUser
-[IMessageChannel]: xref:Discord.IMessageChannel
-[IUserMessage]: xref:Discord.IUserMessage
-[IEmote]: xref:Discord.IEmote
-[Emote]: xref:Discord.Emote
-[Emoji]: xref:Discord.Emoji
\ No newline at end of file
diff --git a/docs/faq/basics/client-basics.md b/docs/faq/basics/client-basics.md
deleted file mode 100644
index 1176ee3fd..000000000
--- a/docs/faq/basics/client-basics.md
+++ /dev/null
@@ -1,94 +0,0 @@
----
-uid: FAQ.Basics.ClientBasics
-title: Basic Questions about Client
----
-
-# Client Basics Questions
-
-In the following section, you will find commonly asked questions and
-answers about common issues that you may face when utilizing the
-various clients offered by the library.
-
-## My client keeps returning 401 upon logging in!
-
-> [!WARNING]
-> Userbot/selfbot (logging in with a user token) is no
-> longer supported with this library starting from 2.0, as
-> logging in under a user account may result in account termination.
->
-> For more information, see issue [827] & [958], as well as the official
-> [Discord API Terms of Service].
-
-There are few possible reasons why this may occur.
-
-1. You are not using the appropriate [TokenType]. If you are using a
- bot account created from the Discord Developer portal, you should
- be using `TokenType.Bot`.
-2. You are not using the correct login credentials. Please keep in
- mind that a token is **different** from a *client secret*.
-
-[TokenType]: xref:Discord.TokenType
-[827]: https://github.com/RogueException/Discord.Net/issues/827
-[958]: https://github.com/RogueException/Discord.Net/issues/958
-[Discord API Terms of Service]: https://discord.com/developers/docs/legal
-
-## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect?
-
-Your bot should **not** attempt to interact in any way with
-guilds/servers until the [Ready] event fires. When the bot
-connects, it first has to download guild information from
-Discord for you to get access to any server
-information; the client is not ready at this point.
-
-Technically, the [GuildAvailable] event fires once the data for a
-particular guild has downloaded; however, it is best to wait for all
-guilds to be downloaded. Once all downloads are complete, the [Ready]
-event is triggered, then you can proceed to do whatever you like.
-
-[Ready]: xref:Discord.WebSocket.DiscordSocketClient.Ready
-[GuildAvailable]: xref:Discord.WebSocket.BaseSocketClient.GuildAvailable
-
-## How do I get a message's previous content when that message is edited?
-
-If you need to do anything with messages (e.g., checking Reactions,
-checking the content of edited/deleted messages), you must set the
-[MessageCacheSize] in your [DiscordSocketConfig] settings in order to
-use the cached message entity. Read more about it [here](xref:Guides.Concepts.Events#cacheable).
-
-1. Message Cache must be enabled.
-2. Hook the MessageUpdated event. This event provides a *before* and
- *after* object.
-3. Only messages received *after* the bot comes online will be
- available in the cache.
-
-[MessageCacheSize]: xref:Discord.WebSocket.DiscordSocketConfig.MessageCacheSize
-[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
-[MessageUpdated]: xref:Discord.WebSocket.BaseSocketClient.MessageUpdated
-
-## What is a shard/sharded client, and how is it different from the `DiscordSocketClient`?
-As your bot grows in popularity, it is recommended that you should section your bot off into separate processes.
-The [DiscordShardedClient] is essentially a class that allows you to easily create and manage multiple [DiscordSocketClient]
-instances, with each one serving a different amount of guilds.
-
-There are very few differences from the [DiscordSocketClient] class, and it is very straightforward
-to modify your existing code to use a [DiscordShardedClient] when necessary.
-
-1. You need to specify the total amount of shards, or shard ids, via [DiscordShardedClient]'s constructors.
-2. The [Connected], [Disconnected], [Ready], and [LatencyUpdated] events
- are replaced with [ShardConnected], [ShardDisconnected], [ShardReady], and [ShardLatencyUpdated].
-3. Every event handler you apply/remove to the [DiscordShardedClient] is applied/removed to each shard.
- If you wish to control a specific shard's events, you can access an individual shard through the `Shards` property.
-
-If you do not wish to use the [DiscordShardedClient] and instead reuse the same [DiscordSocketClient] code and manually shard them,
-you can do so by specifying the [ShardId] for the [DiscordSocketConfig] and pass that to the [DiscordSocketClient]'s constructor.
-
-[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[DiscordShardedClient]: xref:Discord.WebSocket.DiscordShardedClient
-[Connected]: xref:Discord.WebSocket.DiscordSocketClient.Connected
-[Disconnected]: xref:Discord.WebSocket.DiscordSocketClient.Disconnected
-[LatencyUpdated]: xref:Discord.WebSocket.DiscordSocketClient.LatencyUpdated
-[ShardConnected]: xref:Discord.WebSocket.DiscordShardedClient.ShardConnected
-[ShardDisconnected]: xref:Discord.WebSocket.DiscordShardedClient.ShardDisconnected
-[ShardReady]: xref:Discord.WebSocket.DiscordShardedClient.ShardReady
-[ShardLatencyUpdated]: xref:Discord.WebSocket.DiscordShardedClient.ShardLatencyUpdated
-[ShardId]: xref:Discord.WebSocket.DiscordSocketConfig.ShardId
diff --git a/docs/faq/basics/getting-started.md b/docs/faq/basics/getting-started.md
deleted file mode 100644
index e254226d0..000000000
--- a/docs/faq/basics/getting-started.md
+++ /dev/null
@@ -1,82 +0,0 @@
----
-uid: FAQ.Basics.GetStarted
-title: Beginner Questions / How to Get Started
----
-
-# Basic Concepts / Getting Started
-
-In this following section, you will find commonly asked questions and
-answers about how to get started with Discord.Net, as well as basic
-introduction to the Discord API ecosystem.
-
-## How do I add my bot to my server/guild?
-
-You can do so by using the [permission calculator] provided
-by [FiniteReality].
-This tool allows you to set permissions that the bot will be assigned
-with, and invite the bot into your guild. With this method, bots will
-also be assigned a unique role that a regular user cannot use; this
-is what we call a `Managed` role. Because you cannot assign this
-role to any other users, it is much safer than creating a single
-role which, intentionally or not, can be applied to other users
-to escalate their privilege.
-
-[FiniteReality]: https://github.com/FiniteReality/permissions-calculator
-[permission calculator]: https://finitereality.github.io/permissions-calculator
-
-## What is a token?
-
-A token is a credential used to log into an account. This information
-should be kept **private** and for your eyes only. Anyone with your
-token can log into your account. This risk applies to both user
-and bot accounts. That also means that you should **never** hardcode
-your token or add it into source control, as your identity may be
-stolen by scrape bots on the internet that scours through
-constantly to obtain a token.
-
-## What is a client/user/object ID?
-
-Each user and object on Discord has its own snowflake ID generated
-based on various conditions.
-
-
-
-Anyone can see the ID; it is public. It is merely used to
-identify an object in the Discord ecosystem. Many things in the
-Discord ecosystem require an ID to retrieve or identify the said
-object.
-
-There are 2 common ways to obtain the said ID.
-
-### [Discord Developer Mode](#tab/dev-mode)
-
-By enabling the developer mode you can right click on most objects
-to obtain their snowflake IDs (please note that this may not apply to
-all objects, such as role IDs, or DM channel IDs).
-
-
-
-### [Escape Character](#tab/escape-char)
-
-You can escape an object by using `\` in front the object in the
-Discord client. For example, when you do `\@Example#1234` in chat,
-it will return the user ID of the aforementioned user.
-
-
-
-***
-
-## How do I get the role ID?
-
-> [!WARNING]
-> Right-clicking on the role and copying the ID will **not** work.
-> This will only copy the message ID.
-
-Several common ways to do this:
-
-1. (Easiest) Right click on the role either in the Server Settings
- or in the user's role list.
- 
-2. Make the role mentionable and mention the role, and escape it
- using the `\` character in front.
-3. Inspect the roles collection within the guild via your debugger.
\ No newline at end of file
diff --git a/docs/faq/basics/images/dev-mode.png b/docs/faq/basics/images/dev-mode.png
deleted file mode 100644
index fd20b95d188751a2f3b4268e7ba7294b71afaf06..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 80742
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