Fix Samples on Docs; Fix Links on Docs; add FAQ page to docs

docs/guides/faq.md

@@ -0,0 +1,20 @@
+---
+title: Frequently Asked Questions
+---
+
+# Frequently Asked Questions
+
+>[!NOTE]
+>All of these samples assume you have `_client` defined as a `DiscordSocketClient`.
+
+#### Changing the bot's avatar
+
+[!code-csharp[Bot Avatar](samples/faq/avatar.cs)]
+
+#### Changing the bot's status
+
+[!code-sharp[Bot Status](samples/faq/status.cs)]
+
+#### Sending a message to a channel
+
+[!code-csharp[Message to Channel](samples/faq/send_message.cs)]

docs/guides/samples/command_handler.cs

@@ -1,6 +1,7 @@
 using System.Threading.Tasks;
 using System.Reflection;
 using Discord;
+using Discord.WebSocket;
 using Discord.Commands;
 
 public class Program

docs/guides/samples/dependency_map_setup.cs

@@ -1,5 +1,6 @@
 using Discord;
 using Discord.Commands;
+using Discord.WebSocket;
 
 public class Commands
 {

docs/guides/samples/dependency_module.cs

@@ -1,5 +1,6 @@
 using Discord;
 using Discord.Commands;
+using Discord.WebSocket;
 
 [Module]
 public class ModuleA

docs/guides/samples/faq/avatar.cs

@@ -0,0 +1,5 @@
+public async Task ChangeAvatar()
+{
+    var fileStream = new FileStream("./newAvatar.png", FileMode.Open);
+    await (await _client.GetCurrentUserAsync()).ModifyAsync(x => x.Avatar = fileStream);
+}

docs/guides/samples/faq/send_message.cs

@@ -0,0 +1,7 @@
+public async Task SendMessageToChannel(ulong ChannelId)
+{
+    var channel = await _client.GetChannelAsync(ChannelId) as IMessageChannel;
+    await channel?.SendMessageAsync("aaaaaaaaahhh!!!")
+    /*           ^ This question mark is used to indicate that 'channel' may sometimes be null, and
+                    in cases that it is null, we will do nothing here. */ 
+}

docs/guides/samples/faq/status.cs

@@ -0,0 +1,8 @@
+public async Task ModifyStatus()
+{
+    await (await _client.GetCurrentUserAsync()).ModifyStatusAsync(x =>
+    {
+        x.Status = UserStatus.Idle;
+        x.Game = new Game("Type !help for help");
+    });
+}

docs/guides/samples/first-steps.cs

@@ -1,4 +1,5 @@
 using Discord;
+using Discord.WebSocket;
 
 class Program
 {

docs/guides/samples/logging.cs

@@ -1,4 +1,5 @@
 using Discord;
+using Discord.Rest;
 
 public class Program
 {

docs/guides/samples/module.cs

@@ -1,4 +1,5 @@
 using Discord.Commands;
+using Discord.WebSocket;
 
 // Create a module with no prefix
 [Module]

docs/guides/toc.yml

@@ -6,4 +6,6 @@
 - name: Logging
   href: logging.md
 - name: Commands
-  href: commands.md
+  href: commands.md
+- name: FAQ
+  href: faq.md

docs/index.md

@@ -1,6 +1,6 @@
 
 # Discord.Net Documentation
 
-Refer to [Guides](guides/) for tutorials on using Discord.Net, or the [API documentation](api/) to review individual objects in the library.
+Refer to [Guides](guides/intro.md) for tutorials on using Discord.Net, or the [API documentation](api/index.md) to review individual objects in the library.
 
 **Todo:** Put something meaningful here.