From db90eab9534967a9b4a43436991711a372aec320 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Tue, 21 Aug 2018 06:27:50 +0800
Subject: [PATCH 01/59] Update README.md (#1117)

* Initial commit

* Add alternative suggestion

* Fix typo

* Update README.md
---
 README.md | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/README.md b/README.md
index bd0ef20c7..7dc8cd788 100644
--- a/README.md
+++ b/README.md
@@ -16,13 +16,9 @@ Our stable builds available from NuGet through the Discord.Net metapackage:
 The individual components may also be installed from NuGet:
 - [Discord.Net.Commands](https://www.nuget.org/packages/Discord.Net.Commands/)
 - [Discord.Net.Rest](https://www.nuget.org/packages/Discord.Net.Rest/)
-- [Discord.Net.Rpc](https://www.nuget.org/packages/Discord.Net.Rpc/)
 - [Discord.Net.WebSocket](https://www.nuget.org/packages/Discord.Net.WebSocket/)
 - [Discord.Net.Webhook](https://www.nuget.org/packages/Discord.Net.Webhook/)
 
-The following provider is available for platforms not supporting .NET Standard 1.3:
-- [Discord.Net.Providers.WS4Net](https://www.nuget.org/packages/Discord.Net.Providers.WS4Net/)
-
 ### Unstable (MyGet)
 Nightly builds are available through our MyGet feed (`https://www.myget.org/F/discord-net/api/v3/index.json`).
 
@@ -41,5 +37,4 @@ The .NET Core workload must be selected during Visual Studio installation.
 ## Known Issues
 
 ### WebSockets (Win7 and earlier)
-.NET Core 1.1 does not support WebSockets on Win7 and earlier. It's recommended to use the Discord.Net.Providers.WS4Net package until this is resolved.
-Track the issue [here](https://github.com/dotnet/corefx/issues/9503).
+.NET Core 1.1 does not support WebSockets on Win7 and earlier. This issue has been fixed since the release of .NET Core 2.1. It is recommended to target .NET Core 2.1 or above for your project if you wish to run your bot on legacy platforms; alternatively, you may choose to install the [Discord.Net.Providers.WS4Net](https://www.nuget.org/packages/Discord.Net.Providers.WS4Net/) package.

From 4259b8cb0cfb63e66cde9d0f2c3e7de5a59971ab Mon Sep 17 00:00:00 2001
From: JustNrik <35231903+JustNrik@users.noreply.github.com>
Date: Mon, 27 Aug 2018 00:11:55 -0400
Subject: [PATCH 02/59] Update CommandAttribute.cs

Nullable<T> is not valid for Attributes, this is my suggested fix.
---
 src/Discord.Net.Commands/Attributes/CommandAttribute.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
index a0fcf3e4a..a9df3b409 100644
--- a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
@@ -17,5 +17,10 @@ namespace Discord.Commands
         {
             Text = text;
         }
+        public CommandAttribute(string text, bool ignoreExtraArgs)
+        {
+            Text = text;
+            IgnoreExtraArgs = ignoreExtraArgs;
+        }
     }
 }

From c56fff9fe55648cdb09325bf95bd244a125f0adc Mon Sep 17 00:00:00 2001
From: JustNrik <35231903+JustNrik@users.noreply.github.com>
Date: Mon, 27 Aug 2018 00:44:35 -0400
Subject: [PATCH 03/59] Update CommandAttribute.cs

---
 src/Discord.Net.Commands/Attributes/CommandAttribute.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
index a9df3b409..ac3ba599e 100644
--- a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
@@ -7,7 +7,7 @@ namespace Discord.Commands
     {
         public string Text { get; }
         public RunMode RunMode { get; set; } = RunMode.Default;
-        public bool? IgnoreExtraArgs { get; set; }
+        public bool? IgnoreExtraArgs { get; private set; }
 
         public CommandAttribute()
         {

From 143fb2808bcf034a1cbb4231fc19424972a22ca4 Mon Sep 17 00:00:00 2001
From: JustNrik <35231903+JustNrik@users.noreply.github.com>
Date: Mon, 27 Aug 2018 17:39:00 -0400
Subject: [PATCH 04/59] Update CommandAttribute.cs

---
 src/Discord.Net.Commands/Attributes/CommandAttribute.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
index ac3ba599e..bfc04641a 100644
--- a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
@@ -7,7 +7,7 @@ namespace Discord.Commands
     {
         public string Text { get; }
         public RunMode RunMode { get; set; } = RunMode.Default;
-        public bool? IgnoreExtraArgs { get; private set; }
+        public bool? IgnoreExtraArgs { get; }
 
         public CommandAttribute()
         {

From efdb4f926698bbf6ef2d93779291f7f39d675b3f Mon Sep 17 00:00:00 2001
From: Finite Reality <FiniteReality@users.noreply.github.com>
Date: Wed, 29 Aug 2018 17:11:26 +0100
Subject: [PATCH 05/59] Pass our json serializer to ToObject calls (#1133)

Should fix issues in audit logs when deserializing overwrites and
similar types which we use a custom contract resolver for.
---
 .../API/Common/AuditLogOptions.cs             |  2 +-
 src/Discord.Net.Rest/DiscordRestApiClient.cs  | 22 +++++-----
 .../DataTypes/ChannelCreateAuditLogData.cs    |  8 ++--
 .../DataTypes/ChannelDeleteAuditLogData.cs    |  6 +--
 .../DataTypes/ChannelUpdateAuditLogData.cs    | 16 ++++----
 .../DataTypes/EmoteCreateAuditLogData.cs      |  2 +-
 .../DataTypes/EmoteDeleteAuditLogData.cs      |  2 +-
 .../DataTypes/EmoteUpdateAuditLogData.cs      |  4 +-
 .../DataTypes/GuildUpdateAuditLogData.cs      | 40 +++++++++----------
 .../DataTypes/InviteCreateAuditLogData.cs     | 14 +++----
 .../DataTypes/InviteDeleteAuditLogData.cs     | 14 +++----
 .../DataTypes/InviteUpdateAuditLogData.cs     | 20 +++++-----
 .../DataTypes/MemberRoleAuditLogData.cs       |  2 +-
 .../DataTypes/MemberUpdateAuditLogData.cs     | 16 ++++----
 .../DataTypes/OverwriteCreateAuditLogData.cs  |  8 ++--
 .../DataTypes/OverwriteDeleteAuditLogData.cs  | 12 +++---
 .../DataTypes/OverwriteUpdateAuditLogData.cs  | 12 +++---
 .../DataTypes/RoleCreateAuditLogData.cs       | 10 ++---
 .../DataTypes/RoleDeleteAuditLogData.cs       | 10 ++---
 .../DataTypes/RoleUpdateAuditLogData.cs       | 20 +++++-----
 .../DataTypes/WebhookCreateAuditLogData.cs    |  6 +--
 .../DataTypes/WebhookDeleteAuditLogData.cs    |  8 ++--
 .../DataTypes/WebhookUpdateAuditLogData.cs    | 14 +++----
 23 files changed, 132 insertions(+), 136 deletions(-)

diff --git a/src/Discord.Net.Rest/API/Common/AuditLogOptions.cs b/src/Discord.Net.Rest/API/Common/AuditLogOptions.cs
index 65b401cce..24141d90c 100644
--- a/src/Discord.Net.Rest/API/Common/AuditLogOptions.cs
+++ b/src/Discord.Net.Rest/API/Common/AuditLogOptions.cs
@@ -20,7 +20,7 @@ namespace Discord.API
         [JsonProperty("role_name")]
         public string OverwriteRoleName { get; set; }
         [JsonProperty("type")]
-        public string OverwriteType { get; set; }
+        public PermissionTarget OverwriteType { get; set; }
         [JsonProperty("id")]
         public ulong? OverwriteTargetId { get; set; }
     }
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 2236dbbf8..a9fc1ed74 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -43,9 +43,11 @@ namespace Discord.API
         public TokenType AuthTokenType { get; private set; }
         internal string AuthToken { get; private set; }
         internal IRestClient RestClient { get; private set; }
-        internal ulong? CurrentUserId { get; set;}
+        internal ulong? CurrentUserId { get; set; }
 
-        public DiscordRestApiClient(RestClientProvider restClientProvider, string userAgent, RetryMode defaultRetryMode = RetryMode.AlwaysRetry, 
+        internal JsonSerializer Serializer => _serializer;
+
+        public DiscordRestApiClient(RestClientProvider restClientProvider, string userAgent, RetryMode defaultRetryMode = RetryMode.AlwaysRetry,
             JsonSerializer serializer = null)
         {
             _restClientProvider = restClientProvider;
@@ -235,7 +237,7 @@ namespace Discord.API
         internal Task<TResponse> SendMultipartAsync<TResponse>(string method, Expression<Func<string>> endpointExpr, IReadOnlyDictionary<string, object> multipartArgs, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
             => SendMultipartAsync<TResponse>(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
-        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs, 
+        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
             options = options ?? new RequestOptions();
@@ -414,7 +416,7 @@ namespace Discord.API
             var ids = new BucketIds(guildId: guildId);
             await SendAsync("DELETE", () => $"guilds/{guildId}/members/{userId}/roles/{roleId}", ids, options: options);
         }
-        
+
         //Channel Messages
         public async Task<Message> GetChannelMessageAsync(ulong channelId, ulong messageId, RequestOptions options = null)
         {
@@ -490,7 +492,7 @@ namespace Discord.API
             if (args.Content?.Length > DiscordConfig.MaxMessageSize)
                 throw new ArgumentException($"Message content is too long, length must be less or equal to {DiscordConfig.MaxMessageSize}.", nameof(args.Content));
             options = RequestOptions.CreateOrClone(options);
-            
+
             return await SendJsonAsync<Message>("POST", () => $"webhooks/{webhookId}/{AuthToken}?wait=true", args, new BucketIds(), clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
         }
         public async Task<Message> UploadFileAsync(ulong channelId, UploadFileParams args, RequestOptions options = null)
@@ -737,7 +739,7 @@ namespace Discord.API
             Preconditions.NotNullOrWhitespace(args.Name, nameof(args.Name));
             Preconditions.NotNullOrWhitespace(args.RegionId, nameof(args.RegionId));
             options = RequestOptions.CreateOrClone(options);
-            
+
             return await SendJsonAsync<Guild>("POST", () => "guilds", args, new BucketIds(), options: options).ConfigureAwait(false);
         }
         public async Task<Guild> DeleteGuildAsync(ulong guildId, RequestOptions options = null)
@@ -964,7 +966,7 @@ namespace Discord.API
         {
             Preconditions.NotNullOrEmpty(inviteId, nameof(inviteId));
             options = RequestOptions.CreateOrClone(options);
-            
+
             return await SendAsync<Invite>("DELETE", () => $"invites/{inviteId}", new BucketIds(), options: options).ConfigureAwait(false);
         }
 
@@ -1163,7 +1165,7 @@ namespace Discord.API
 
             int limit = args.Limit.GetValueOrDefault(int.MaxValue);
             ulong afterGuildId = args.AfterGuildId.GetValueOrDefault(0);
-            
+
             return await SendAsync<IReadOnlyCollection<UserGuild>>("GET", () => $"users/@me/guilds?limit={limit}&after={afterGuildId}", new BucketIds(), options: options).ConfigureAwait(false);
         }
         public async Task<Application> GetMyApplicationAsync(RequestOptions options = null)
@@ -1263,7 +1265,7 @@ namespace Discord.API
             Preconditions.NotNull(args, nameof(args));
             Preconditions.NotNullOrEmpty(args.Name, nameof(args.Name));
             options = RequestOptions.CreateOrClone(options);
-            
+
             if (AuthTokenType == TokenType.Webhook)
                 return await SendJsonAsync<Webhook>("PATCH", () => $"webhooks/{webhookId}/{AuthToken}", args, new BucketIds(), options: options).ConfigureAwait(false);
             else
@@ -1393,7 +1395,7 @@ namespace Discord.API
                     int argId = int.Parse(format.Substring(leftIndex + 1, rightIndex - leftIndex - 1));
                     string fieldName = GetFieldName(methodArgs[argId + 1]);
                     int? mappedId;
-                    
+
                     mappedId = BucketIds.GetIndex(fieldName);
                     if(!mappedId.HasValue && rightIndex != endIndex && format.Length > rightIndex + 1 && format[rightIndex + 1] == '/') //Ignore the next slash
                         rightIndex++;
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
index ef4787295..51e72c414 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
@@ -26,18 +26,16 @@ namespace Discord.Rest
             var typeModel = changes.FirstOrDefault(x => x.ChangedProperty == "type");
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var type = typeModel.NewValue.ToObject<ChannelType>();
-            var name = nameModel.NewValue.ToObject<string>();
+            var type = typeModel.NewValue.ToObject<ChannelType>(discord.ApiClient.Serializer);
+            var name = nameModel.NewValue.ToObject<string>(discord.ApiClient.Serializer);
 
             foreach (var overwrite in overwritesModel.NewValue)
             {
                 var deny = overwrite.Value<ulong>("deny");
-                var _type = overwrite.Value<string>("type");
+                var permType = overwrite.Value<PermissionTarget>("type");
                 var id = overwrite.Value<ulong>("id");
                 var allow = overwrite.Value<ulong>("allow");
 
-                PermissionTarget permType = _type == "member" ? PermissionTarget.User : PermissionTarget.Role;
-
                 overwrites.Add(new Overwrite(id, permType, new OverwritePermissions(allow, deny)));
             }
 
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
index 4816ce770..7af5ca10c 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
@@ -27,11 +27,11 @@ namespace Discord.Rest
             var typeModel = changes.FirstOrDefault(x => x.ChangedProperty == "type");
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var overwrites = overwritesModel.OldValue.ToObject<API.Overwrite[]>()
+            var overwrites = overwritesModel.OldValue.ToObject<API.Overwrite[]>(discord.ApiClient.Serializer)
                 .Select(x => new Overwrite(x.TargetId, x.TargetType, new OverwritePermissions(x.Allow, x.Deny)))
                 .ToList();
-            var type = typeModel.OldValue.ToObject<ChannelType>();
-            var name = nameModel.OldValue.ToObject<string>();
+            var type = typeModel.OldValue.ToObject<ChannelType>(discord.ApiClient.Serializer);
+            var name = nameModel.OldValue.ToObject<string>(discord.ApiClient.Serializer);
             var id = entry.TargetId.Value;
 
             return new ChannelDeleteAuditLogData(id, name, type, overwrites.ToReadOnlyCollection());
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
index 491cb5717..36fe82084 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
@@ -23,14 +23,14 @@ namespace Discord.Rest
             var bitrateModel = changes.FirstOrDefault(x => x.ChangedProperty == "bitrate");
             var userLimitModel = changes.FirstOrDefault(x => x.ChangedProperty == "user_limit");
 
-            string oldName = nameModel?.OldValue?.ToObject<string>(),
-                newName = nameModel?.NewValue?.ToObject<string>();
-            string oldTopic = topicModel?.OldValue?.ToObject<string>(),
-                newTopic = topicModel?.NewValue?.ToObject<string>();
-            int? oldBitrate = bitrateModel?.OldValue?.ToObject<int>(),
-                newBitrate = bitrateModel?.NewValue?.ToObject<int>();
-            int? oldLimit = userLimitModel?.OldValue?.ToObject<int>(),
-                newLimit = userLimitModel?.NewValue?.ToObject<int>();
+            string oldName = nameModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newName = nameModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            string oldTopic = topicModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newTopic = topicModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            int? oldBitrate = bitrateModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newBitrate = bitrateModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
+            int? oldLimit = userLimitModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newLimit = userLimitModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
 
             var before = new ChannelInfo(oldName, oldTopic, oldBitrate, oldLimit);
             var after = new ChannelInfo(newName, newTopic, newBitrate, newLimit);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
index 5d1ef8463..dac2d90ef 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
@@ -21,7 +21,7 @@ namespace Discord.Rest
         {
             var change = entry.Changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var emoteName = change.NewValue?.ToObject<string>();
+            var emoteName = change.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
             return new EmoteCreateAuditLogData(entry.TargetId.Value, emoteName);
         }
 
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
index d0a11191f..73cb31af9 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
@@ -17,7 +17,7 @@ namespace Discord.Rest
         {
             var change = entry.Changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var emoteName = change.OldValue?.ToObject<string>();
+            var emoteName = change.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
 
             return new EmoteDeleteAuditLogData(entry.TargetId.Value, emoteName);
         }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
index 60020bcaa..84898013d 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
@@ -18,8 +18,8 @@ namespace Discord.Rest
         {
             var change = entry.Changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var newName = change.NewValue?.ToObject<string>();
-            var oldName = change.OldValue?.ToObject<string>();
+            var newName = change.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            var oldName = change.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
 
             return new EmoteUpdateAuditLogData(entry.TargetId.Value, oldName, newName);
         }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
index 08550ed7a..09c1eda18 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
@@ -28,26 +28,26 @@ namespace Discord.Rest
             var mfaLevelModel = changes.FirstOrDefault(x => x.ChangedProperty == "afk_timeout");
             var contentFilterModel = changes.FirstOrDefault(x => x.ChangedProperty == "afk_timeout");
 
-            int? oldAfkTimeout = afkTimeoutModel?.OldValue?.ToObject<int>(),
-                newAfkTimeout = afkTimeoutModel?.NewValue?.ToObject<int>();
-            DefaultMessageNotifications? oldDefaultMessageNotifications = defaultMessageNotificationsModel?.OldValue?.ToObject<DefaultMessageNotifications>(),
-                newDefaultMessageNotifications = defaultMessageNotificationsModel?.NewValue?.ToObject<DefaultMessageNotifications>();
-            ulong? oldAfkChannelId = afkChannelModel?.OldValue?.ToObject<ulong>(),
-                newAfkChannelId = afkChannelModel?.NewValue?.ToObject<ulong>();
-            string oldName = nameModel?.OldValue?.ToObject<string>(),
-                newName = nameModel?.NewValue?.ToObject<string>();
-            string oldRegionId = regionIdModel?.OldValue?.ToObject<string>(),
-                newRegionId = regionIdModel?.NewValue?.ToObject<string>();
-            string oldIconHash = iconHashModel?.OldValue?.ToObject<string>(),
-                newIconHash = iconHashModel?.NewValue?.ToObject<string>();
-            VerificationLevel? oldVerificationLevel = verificationLevelModel?.OldValue?.ToObject<VerificationLevel>(),
-                newVerificationLevel = verificationLevelModel?.NewValue?.ToObject<VerificationLevel>();
-            ulong? oldOwnerId = ownerIdModel?.OldValue?.ToObject<ulong>(),
-                newOwnerId = ownerIdModel?.NewValue?.ToObject<ulong>();
-            MfaLevel? oldMfaLevel = mfaLevelModel?.OldValue?.ToObject<MfaLevel>(),
-                newMfaLevel = mfaLevelModel?.NewValue?.ToObject<MfaLevel>();
-            int? oldContentFilter = contentFilterModel?.OldValue?.ToObject<int>(),
-                newContentFilter = contentFilterModel?.NewValue?.ToObject<int>();
+            int? oldAfkTimeout = afkTimeoutModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newAfkTimeout = afkTimeoutModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
+            DefaultMessageNotifications? oldDefaultMessageNotifications = defaultMessageNotificationsModel?.OldValue?.ToObject<DefaultMessageNotifications>(discord.ApiClient.Serializer),
+                newDefaultMessageNotifications = defaultMessageNotificationsModel?.NewValue?.ToObject<DefaultMessageNotifications>(discord.ApiClient.Serializer);
+            ulong? oldAfkChannelId = afkChannelModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer),
+                newAfkChannelId = afkChannelModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            string oldName = nameModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newName = nameModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            string oldRegionId = regionIdModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newRegionId = regionIdModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            string oldIconHash = iconHashModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newIconHash = iconHashModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            VerificationLevel? oldVerificationLevel = verificationLevelModel?.OldValue?.ToObject<VerificationLevel>(discord.ApiClient.Serializer),
+                newVerificationLevel = verificationLevelModel?.NewValue?.ToObject<VerificationLevel>(discord.ApiClient.Serializer);
+            ulong? oldOwnerId = ownerIdModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer),
+                newOwnerId = ownerIdModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            MfaLevel? oldMfaLevel = mfaLevelModel?.OldValue?.ToObject<MfaLevel>(discord.ApiClient.Serializer),
+                newMfaLevel = mfaLevelModel?.NewValue?.ToObject<MfaLevel>(discord.ApiClient.Serializer);
+            int? oldContentFilter = contentFilterModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newContentFilter = contentFilterModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
 
             IUser oldOwner = null;
             if (oldOwnerId != null)
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
index 292715420..1d7f48e93 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
@@ -30,13 +30,13 @@ namespace Discord.Rest
             var usesModel = changes.FirstOrDefault(x => x.ChangedProperty == "uses");
             var maxUsesModel = changes.FirstOrDefault(x => x.ChangedProperty == "max_uses");
 
-            var maxAge = maxAgeModel.NewValue.ToObject<int>();
-            var code = codeModel.NewValue.ToObject<string>();
-            var temporary = temporaryModel.NewValue.ToObject<bool>();
-            var inviterId = inviterIdModel.NewValue.ToObject<ulong>();
-            var channelId = channelIdModel.NewValue.ToObject<ulong>();
-            var uses = usesModel.NewValue.ToObject<int>();
-            var maxUses = maxUsesModel.NewValue.ToObject<int>();
+            var maxAge = maxAgeModel.NewValue.ToObject<int>(discord.ApiClient.Serializer);
+            var code = codeModel.NewValue.ToObject<string>(discord.ApiClient.Serializer);
+            var temporary = temporaryModel.NewValue.ToObject<bool>(discord.ApiClient.Serializer);
+            var inviterId = inviterIdModel.NewValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var channelId = channelIdModel.NewValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var uses = usesModel.NewValue.ToObject<int>(discord.ApiClient.Serializer);
+            var maxUses = maxUsesModel.NewValue.ToObject<int>(discord.ApiClient.Serializer);
 
             var inviterInfo = log.Users.FirstOrDefault(x => x.Id == inviterId);
             var inviter = RestUser.Create(discord, inviterInfo);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
index 1dc6d518b..091285532 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
@@ -30,13 +30,13 @@ namespace Discord.Rest
             var usesModel = changes.FirstOrDefault(x => x.ChangedProperty == "uses");
             var maxUsesModel = changes.FirstOrDefault(x => x.ChangedProperty == "max_uses");
 
-            var maxAge = maxAgeModel.OldValue.ToObject<int>();
-            var code = codeModel.OldValue.ToObject<string>();
-            var temporary = temporaryModel.OldValue.ToObject<bool>();
-            var inviterId = inviterIdModel.OldValue.ToObject<ulong>();
-            var channelId = channelIdModel.OldValue.ToObject<ulong>();
-            var uses = usesModel.OldValue.ToObject<int>();
-            var maxUses = maxUsesModel.OldValue.ToObject<int>();
+            var maxAge = maxAgeModel.OldValue.ToObject<int>(discord.ApiClient.Serializer);
+            var code = codeModel.OldValue.ToObject<string>(discord.ApiClient.Serializer);
+            var temporary = temporaryModel.OldValue.ToObject<bool>(discord.ApiClient.Serializer);
+            var inviterId = inviterIdModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var channelId = channelIdModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var uses = usesModel.OldValue.ToObject<int>(discord.ApiClient.Serializer);
+            var maxUses = maxUsesModel.OldValue.ToObject<int>(discord.ApiClient.Serializer);
 
             var inviterInfo = log.Users.FirstOrDefault(x => x.Id == inviterId);
             var inviter = RestUser.Create(discord, inviterInfo);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
index b932cfbfc..35088be98 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
@@ -23,16 +23,16 @@ namespace Discord.Rest
             var channelIdModel = changes.FirstOrDefault(x => x.ChangedProperty == "channel_id");
             var maxUsesModel = changes.FirstOrDefault(x => x.ChangedProperty == "max_uses");
 
-            int? oldMaxAge = maxAgeModel?.OldValue?.ToObject<int>(),
-                newMaxAge = maxAgeModel?.NewValue?.ToObject<int>();
-            string oldCode = codeModel?.OldValue?.ToObject<string>(),
-                newCode = codeModel?.NewValue?.ToObject<string>();
-            bool? oldTemporary = temporaryModel?.OldValue?.ToObject<bool>(),
-                newTemporary = temporaryModel?.NewValue?.ToObject<bool>();
-            ulong? oldChannelId = channelIdModel?.OldValue?.ToObject<ulong>(),
-                newChannelId = channelIdModel?.NewValue?.ToObject<ulong>();
-            int? oldMaxUses = maxUsesModel?.OldValue?.ToObject<int>(),
-                newMaxUses = maxUsesModel?.NewValue?.ToObject<int>();
+            int? oldMaxAge = maxAgeModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newMaxAge = maxAgeModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
+            string oldCode = codeModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newCode = codeModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            bool? oldTemporary = temporaryModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer),
+                newTemporary = temporaryModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            ulong? oldChannelId = channelIdModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer),
+                newChannelId = channelIdModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            int? oldMaxUses = maxUsesModel?.OldValue?.ToObject<int>(discord.ApiClient.Serializer),
+                newMaxUses = maxUsesModel?.NewValue?.ToObject<int>(discord.ApiClient.Serializer);
 
             var before = new InviteInfo(oldMaxAge, oldCode, oldTemporary, oldChannelId, oldMaxUses);
             var after = new InviteInfo(newMaxAge, newCode, newTemporary, newChannelId, newMaxUses);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
index 3bcbce440..48adb1833 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
@@ -19,7 +19,7 @@ namespace Discord.Rest
         {
             var changes = entry.Changes;
 
-            var roleInfos = changes.SelectMany(x => x.NewValue.ToObject<API.Role[]>(),
+            var roleInfos = changes.SelectMany(x => x.NewValue.ToObject<API.Role[]>(discord.ApiClient.Serializer),
                 (model, role) => new { model.ChangedProperty, Role = role })
                 .Select(x => new MemberRoleEditInfo(x.Role.Name, x.Role.Id, x.ChangedProperty == "$add"))
                 .ToList();
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
index 40a3ba681..96d34610e 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
@@ -24,14 +24,14 @@ namespace Discord.Rest
             var muteModel = changes.FirstOrDefault(x => x.ChangedProperty == "mute");
             var avatarModel = changes.FirstOrDefault(x => x.ChangedProperty == "avatar_hash");
 
-            string oldNick = nickModel?.OldValue?.ToObject<string>(),
-                newNick = nickModel?.NewValue?.ToObject<string>();
-            bool? oldDeaf = deafModel?.OldValue?.ToObject<bool>(),
-                newDeaf = deafModel?.NewValue?.ToObject<bool>();
-            bool? oldMute = muteModel?.OldValue?.ToObject<bool>(),
-                newMute = muteModel?.NewValue?.ToObject<bool>();
-            string oldAvatar = avatarModel?.OldValue?.ToObject<string>(),
-                newAvatar = avatarModel?.NewValue?.ToObject<string>();
+            string oldNick = nickModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newNick = nickModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            bool? oldDeaf = deafModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer),
+                newDeaf = deafModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            bool? oldMute = muteModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer),
+                newMute = muteModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            string oldAvatar = avatarModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newAvatar = avatarModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
 
             var targetInfo = log.Users.FirstOrDefault(x => x.Id == entry.TargetId);
             var user = RestUser.Create(discord, targetInfo);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
index d58488136..b13f4b8fd 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
@@ -19,17 +19,15 @@ namespace Discord.Rest
             var denyModel = changes.FirstOrDefault(x => x.ChangedProperty == "deny");
             var allowModel = changes.FirstOrDefault(x => x.ChangedProperty == "allow");
 
-            var deny = denyModel.NewValue.ToObject<ulong>();
-            var allow = allowModel.NewValue.ToObject<ulong>();
+            var deny = denyModel.NewValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var allow = allowModel.NewValue.ToObject<ulong>(discord.ApiClient.Serializer);
 
             var permissions = new OverwritePermissions(allow, deny);
 
             var id = entry.Options.OverwriteTargetId.Value;
             var type = entry.Options.OverwriteType;
 
-            PermissionTarget target = type == "member" ? PermissionTarget.User : PermissionTarget.Role;
-
-            return new OverwriteCreateAuditLogData(new Overwrite(id, target, permissions));
+            return new OverwriteCreateAuditLogData(new Overwrite(id, type, permissions));
         }
 
         public Overwrite Overwrite { get; }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
index 445c2e302..5d5177d9a 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
@@ -27,14 +27,12 @@ namespace Discord.Rest
             var idModel = changes.FirstOrDefault(x => x.ChangedProperty == "id");
             var allowModel = changes.FirstOrDefault(x => x.ChangedProperty == "allow");
 
-            var deny = denyModel.OldValue.ToObject<ulong>();
-            var type = typeModel.OldValue.ToObject<string>();
-            var id = idModel.OldValue.ToObject<ulong>();
-            var allow = allowModel.OldValue.ToObject<ulong>();
+            var deny = denyModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var type = typeModel.OldValue.ToObject<PermissionTarget>(discord.ApiClient.Serializer);
+            var id = idModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var allow = allowModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
 
-            PermissionTarget target = type == "member" ? PermissionTarget.User : PermissionTarget.Role;
-
-            return new OverwriteDeleteAuditLogData(new Overwrite(id, target, new OverwritePermissions(allow, deny)));
+            return new OverwriteDeleteAuditLogData(new Overwrite(id, type, new OverwritePermissions(allow, deny)));
         }
 
         public Overwrite Overwrite { get; }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
index d000146c3..d05e1feff 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
@@ -22,17 +22,17 @@ namespace Discord.Rest
             var denyModel = changes.FirstOrDefault(x => x.ChangedProperty == "deny");
             var allowModel = changes.FirstOrDefault(x => x.ChangedProperty == "allow");
 
-            var beforeAllow = allowModel?.OldValue?.ToObject<ulong>();
-            var afterAllow = allowModel?.NewValue?.ToObject<ulong>();
-            var beforeDeny = denyModel?.OldValue?.ToObject<ulong>();
-            var afterDeny = denyModel?.OldValue?.ToObject<ulong>();
+            var beforeAllow = allowModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            var afterAllow = allowModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            var beforeDeny = denyModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            var afterDeny = denyModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
 
             var beforePermissions = new OverwritePermissions(beforeAllow ?? 0, beforeDeny ?? 0);
             var afterPermissions = new OverwritePermissions(afterAllow ?? 0, afterDeny ?? 0);
 
-            PermissionTarget target = entry.Options.OverwriteType == "member" ? PermissionTarget.User : PermissionTarget.Role;
+            var type = entry.Options.OverwriteType;
 
-            return new OverwriteUpdateAuditLogData(beforePermissions, afterPermissions, entry.Options.OverwriteTargetId.Value, target);
+            return new OverwriteUpdateAuditLogData(beforePermissions, afterPermissions, entry.Options.OverwriteTargetId.Value, type);
         }
 
         public OverwritePermissions OldPermissions { get; }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
index dcc1c6ab6..69e72fdb0 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
@@ -23,11 +23,11 @@ namespace Discord.Rest
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
             var permissionsModel = changes.FirstOrDefault(x => x.ChangedProperty == "permissions");
 
-            uint? colorRaw = colorModel?.NewValue?.ToObject<uint>();
-            bool? mentionable = mentionableModel?.NewValue?.ToObject<bool>();
-            bool? hoist = hoistModel?.NewValue?.ToObject<bool>();
-            string name = nameModel?.NewValue?.ToObject<string>();
-            ulong? permissionsRaw = permissionsModel?.NewValue?.ToObject<ulong>();
+            uint? colorRaw = colorModel?.NewValue?.ToObject<uint>(discord.ApiClient.Serializer);
+            bool? mentionable = mentionableModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            bool? hoist = hoistModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            string name = nameModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            ulong? permissionsRaw = permissionsModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
 
             Color? color = null;
             GuildPermissions? permissions = null;
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
index 263909daf..f812567cb 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
@@ -23,11 +23,11 @@ namespace Discord.Rest
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
             var permissionsModel = changes.FirstOrDefault(x => x.ChangedProperty == "permissions");
 
-            uint? colorRaw = colorModel?.OldValue?.ToObject<uint>();
-            bool? mentionable = mentionableModel?.OldValue?.ToObject<bool>();
-            bool? hoist = hoistModel?.OldValue?.ToObject<bool>();
-            string name = nameModel?.OldValue?.ToObject<string>();
-            ulong? permissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>();
+            uint? colorRaw = colorModel?.OldValue?.ToObject<uint>(discord.ApiClient.Serializer);
+            bool? mentionable = mentionableModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            bool? hoist = hoistModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            string name = nameModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
+            ulong? permissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
 
             Color? color = null;
             GuildPermissions? permissions = null;
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
index b645ef7ae..5cea865f1 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
@@ -24,16 +24,16 @@ namespace Discord.Rest
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
             var permissionsModel = changes.FirstOrDefault(x => x.ChangedProperty == "permissions");
 
-            uint? oldColorRaw = colorModel?.OldValue?.ToObject<uint>(),
-                newColorRaw = colorModel?.NewValue?.ToObject<uint>();
-            bool? oldMentionable = mentionableModel?.OldValue?.ToObject<bool>(),
-                newMentionable = mentionableModel?.NewValue?.ToObject<bool>();
-            bool? oldHoist = hoistModel?.OldValue?.ToObject<bool>(),
-                newHoist = hoistModel?.NewValue?.ToObject<bool>();
-            string oldName = nameModel?.OldValue?.ToObject<string>(),
-                newName = nameModel?.NewValue?.ToObject<string>();
-            ulong? oldPermissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>(),
-                newPermissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>();
+            uint? oldColorRaw = colorModel?.OldValue?.ToObject<uint>(discord.ApiClient.Serializer),
+                newColorRaw = colorModel?.NewValue?.ToObject<uint>(discord.ApiClient.Serializer);
+            bool? oldMentionable = mentionableModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer),
+                newMentionable = mentionableModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            bool? oldHoist = hoistModel?.OldValue?.ToObject<bool>(discord.ApiClient.Serializer),
+                newHoist = hoistModel?.NewValue?.ToObject<bool>(discord.ApiClient.Serializer);
+            string oldName = nameModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer),
+                newName = nameModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            ulong? oldPermissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer),
+                newPermissionsRaw = permissionsModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
 
             Color? oldColor = null,
                 newColor = null;
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
index 1ae45fb8c..06932bfc4 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
@@ -23,9 +23,9 @@ namespace Discord.Rest
             var typeModel = changes.FirstOrDefault(x => x.ChangedProperty == "type");
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
 
-            var channelId = channelIdModel.NewValue.ToObject<ulong>();
-            var type = typeModel.NewValue.ToObject<WebhookType>();
-            var name = nameModel.NewValue.ToObject<string>();
+            var channelId = channelIdModel.NewValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var type = typeModel.NewValue.ToObject<WebhookType>(discord.ApiClient.Serializer);
+            var name = nameModel.NewValue.ToObject<string>(discord.ApiClient.Serializer);
 
             var webhookInfo = log.Webhooks?.FirstOrDefault(x => x.Id == entry.TargetId);
             var webhook = RestWebhook.Create(discord, (IGuild)null, webhookInfo);
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
index 4133d5dff..8fc4da578 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
@@ -29,10 +29,10 @@ namespace Discord.Rest
             var nameModel = changes.FirstOrDefault(x => x.ChangedProperty == "name");
             var avatarHashModel = changes.FirstOrDefault(x => x.ChangedProperty == "avatar_hash");
 
-            var channelId = channelIdModel.OldValue.ToObject<ulong>();
-            var type = typeModel.OldValue.ToObject<WebhookType>();
-            var name = nameModel.OldValue.ToObject<string>();
-            var avatarHash = avatarHashModel?.OldValue?.ToObject<string>();
+            var channelId = channelIdModel.OldValue.ToObject<ulong>(discord.ApiClient.Serializer);
+            var type = typeModel.OldValue.ToObject<WebhookType>(discord.ApiClient.Serializer);
+            var name = nameModel.OldValue.ToObject<string>(discord.ApiClient.Serializer);
+            var avatarHash = avatarHashModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
 
             return new WebhookDeleteAuditLogData(entry.TargetId.Value, channelId, type, name, avatarHash);
         }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
index 54da42a8b..ad7db53e2 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
@@ -26,18 +26,18 @@ namespace Discord.Rest
             var channelIdModel = changes.FirstOrDefault(x => x.ChangedProperty == "channel_id");
             var avatarHashModel = changes.FirstOrDefault(x => x.ChangedProperty == "avatar_hash");
 
-            var oldName = nameModel?.OldValue?.ToObject<string>();
-            var oldChannelId = channelIdModel?.OldValue?.ToObject<ulong>();
-            var oldAvatar = avatarHashModel?.OldValue?.ToObject<string>();
+            var oldName = nameModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
+            var oldChannelId = channelIdModel?.OldValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            var oldAvatar = avatarHashModel?.OldValue?.ToObject<string>(discord.ApiClient.Serializer);
             var before = new WebhookInfo(oldName, oldChannelId, oldAvatar);
 
-            var newName = nameModel?.NewValue?.ToObject<string>();
-            var newChannelId = channelIdModel?.NewValue?.ToObject<ulong>();
-            var newAvatar = avatarHashModel?.NewValue?.ToObject<string>();
+            var newName = nameModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
+            var newChannelId = channelIdModel?.NewValue?.ToObject<ulong>(discord.ApiClient.Serializer);
+            var newAvatar = avatarHashModel?.NewValue?.ToObject<string>(discord.ApiClient.Serializer);
             var after = new WebhookInfo(newName, newChannelId, newAvatar);
 
             var webhookInfo = log.Webhooks?.FirstOrDefault(x => x.Id == entry.TargetId);
-            var webhook = RestWebhook.Create(discord, (IGuild)null, webhookInfo);
+            var webhook = webhookInfo != null ? RestWebhook.Create(discord, (IGuild)null, webhookInfo) : null;
 
             return new WebhookUpdateAuditLogData(webhook, before, after);
         }

From 2de6cef18c495aaa0cb70b1496ea528b47337fd2 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Thu, 30 Aug 2018 14:27:37 -0700
Subject: [PATCH 06/59] Add validation to bot tokens based on string length
 (#1128)

* Add input validation for bot tokens based on their length

* Add token validation to BaseDiscordClient#LoginAsync

Adds a TokenUtils class which is used to validate that tokens are correct

* Revert changes to DiscordRestApiClient

* Add Unit tests to the TokenUtils class, fix a logic error that was caught by those tests

* Allow for API to throw exceptions

Moves the validation of tokens to be inside of LoginInternalAsync, and writes a Warning to the console when the supplied tokens are invalid
---
 src/Discord.Net.Core/Utils/TokenUtils.cs   |  46 ++++++++
 src/Discord.Net.Rest/BaseDiscordClient.cs  |  19 +++-
 test/Discord.Net.Tests/Tests.TokenUtils.cs | 124 +++++++++++++++++++++
 3 files changed, 187 insertions(+), 2 deletions(-)
 create mode 100644 src/Discord.Net.Core/Utils/TokenUtils.cs
 create mode 100644 test/Discord.Net.Tests/Tests.TokenUtils.cs

diff --git a/src/Discord.Net.Core/Utils/TokenUtils.cs b/src/Discord.Net.Core/Utils/TokenUtils.cs
new file mode 100644
index 000000000..2cc0f1041
--- /dev/null
+++ b/src/Discord.Net.Core/Utils/TokenUtils.cs
@@ -0,0 +1,46 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord
+{
+    public static class TokenUtils
+    {
+        /// <summary>
+        ///     Checks the validity of the supplied token of a specific type.
+        /// </summary>
+        /// <param name="tokenType"> The type of token to validate. </param>
+        /// <param name="token"> The token value to validate. </param>
+        /// <exception cref="ArgumentNullException"> Thrown when the supplied token string is null, empty, or contains only whitespace.</exception>
+        /// <exception cref="ArgumentException"> Thrown when the supplied TokenType or token value is invalid. </exception>
+        public static void ValidateToken(TokenType tokenType, string token)
+        {
+            // A Null or WhiteSpace token of any type is invalid.
+            if (string.IsNullOrWhiteSpace(token))
+                throw new ArgumentNullException("A token cannot be null, empty, or contain only whitespace.", nameof(token));
+
+            switch (tokenType)
+            {
+                case TokenType.Webhook:
+                    // no validation is performed on Webhook tokens
+                    break;
+                case TokenType.Bearer:
+                    // no validation is performed on Bearer tokens
+                    break;
+                case TokenType.Bot:
+                    // bot tokens are assumed to be at least 59 characters in length
+                    // this value was determined by referencing examples in the discord documentation, and by comparing with
+                    // pre-existing tokens
+                    if (token.Length < 59)
+                        throw new ArgumentException("A Bot token must be at least 59 characters in length.", nameof(token));
+                    break;
+                default:
+                    // All unrecognized TokenTypes (including User tokens) are considered to be invalid.
+                    throw new ArgumentException("Unrecognized TokenType.", nameof(token));
+            }
+        }
+
+    }
+}
diff --git a/src/Discord.Net.Rest/BaseDiscordClient.cs b/src/Discord.Net.Rest/BaseDiscordClient.cs
index f8642b96c..8ac4e9f98 100644
--- a/src/Discord.Net.Rest/BaseDiscordClient.cs
+++ b/src/Discord.Net.Rest/BaseDiscordClient.cs
@@ -55,11 +55,11 @@ namespace Discord.Rest
             await _stateLock.WaitAsync().ConfigureAwait(false);
             try
             {
-                await LoginInternalAsync(tokenType, token).ConfigureAwait(false);
+                await LoginInternalAsync(tokenType, token, validateToken).ConfigureAwait(false);
             }
             finally { _stateLock.Release(); }
         }
-        private async Task LoginInternalAsync(TokenType tokenType, string token)
+        private async Task LoginInternalAsync(TokenType tokenType, string token, bool validateToken)
         {
             if (_isFirstLogin)
             {
@@ -73,6 +73,21 @@ namespace Discord.Rest
 
             try
             {
+                // If token validation is enabled, validate the token and let it throw any ArgumentExceptions
+                // that result from invalid parameters
+                if (validateToken)
+                {
+                    try
+                    {
+                        TokenUtils.ValidateToken(tokenType, token);
+                    }
+                    catch (ArgumentException ex)
+                    {
+                        // log these ArgumentExceptions and allow for the client to attempt to log in anyways
+                        await LogManager.WarningAsync("Discord", "A supplied token was invalid", ex).ConfigureAwait(false);
+                    }
+                }
+
                 await ApiClient.LoginAsync(tokenType, token).ConfigureAwait(false);
                 await OnLoginAsync(tokenType, token).ConfigureAwait(false);
                 LoginState = LoginState.LoggedIn;
diff --git a/test/Discord.Net.Tests/Tests.TokenUtils.cs b/test/Discord.Net.Tests/Tests.TokenUtils.cs
new file mode 100644
index 000000000..dc5a93e34
--- /dev/null
+++ b/test/Discord.Net.Tests/Tests.TokenUtils.cs
@@ -0,0 +1,124 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Xunit;
+
+namespace Discord
+{
+    public class TokenUtilsTests
+    {
+        /// <summary>
+        ///     Tests the usage of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
+        ///     to see that when a null, empty or whitespace-only string is passed as the token,
+        ///     it will throw an ArgumentNullException.
+        /// </summary>
+        [Theory]
+        [InlineData(null)]
+        [InlineData("")] // string.Empty isn't a constant type
+        [InlineData(" ")]
+        [InlineData("    ")]
+        [InlineData("\t")]
+        public void TestNullOrWhitespaceToken(string token)
+        {
+            // an ArgumentNullException should be thrown, regardless of the TokenType
+            Assert.Throws<ArgumentNullException>(() => TokenUtils.ValidateToken(TokenType.Bearer, token));
+            Assert.Throws<ArgumentNullException>(() => TokenUtils.ValidateToken(TokenType.Bot, token));
+            Assert.Throws<ArgumentNullException>(() => TokenUtils.ValidateToken(TokenType.Webhook, token));
+        }
+        
+        /// <summary>
+        ///     Tests the behavior of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
+        ///     to see that valid Webhook tokens do not throw Exceptions.
+        /// </summary>
+        /// <param name="token"></param>
+        [Theory]
+        [InlineData("123123123")]
+        // bot token
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
+        // bearer token taken from discord docs
+        [InlineData("6qrZcUqja7812RVdnEKjpzOL4CvHBFG")]
+        // client secret
+        [InlineData("937it3ow87i4ery69876wqire")]
+        public void TestWebhookTokenDoesNotThrowExceptions(string token)
+        {
+            TokenUtils.ValidateToken(TokenType.Webhook, token);
+        }
+
+        // No tests for invalid webhook token behavior, because there is nothing there yet.
+
+        /// <summary>
+        ///     Tests the behavior of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
+        ///     to see that valid Webhook tokens do not throw Exceptions.
+        /// </summary>
+        /// <param name="token"></param>
+        [Theory]
+        [InlineData("123123123")]
+        // bot token
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
+        // bearer token taken from discord docs
+        [InlineData("6qrZcUqja7812RVdnEKjpzOL4CvHBFG")]
+        // client secret
+        [InlineData("937it3ow87i4ery69876wqire")]
+        public void TestBearerTokenDoesNotThrowExceptions(string token)
+        {
+            TokenUtils.ValidateToken(TokenType.Bearer, token);
+        }
+
+        // No tests for invalid bearer token behavior, because there is nothing there yet.
+
+        /// <summary>
+        ///     Tests the behavior of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
+        ///     to see that valid Bot tokens do not throw Exceptions.
+        ///     Valid Bot tokens can be strings of length 59 or above.
+        /// </summary>
+        [Theory]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
+        [InlineData("This appears to be completely invalid, however the current validation rules are not very strict.")]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWss")]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWsMTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
+        public void TestBotTokenDoesNotThrowExceptions(string token)
+        {
+            // This example token is pulled from the Discord Docs
+            // https://discordapp.com/developers/docs/reference#authentication-example-bot-token-authorization-header
+            // should not throw any exception
+            TokenUtils.ValidateToken(TokenType.Bot, token);
+        }
+
+        /// <summary>
+        ///     Tests the usage of <see cref="TokenUtils.ValidateToken(TokenType, string)"/> with
+        ///     a Bot token that is invalid.
+        /// </summary>
+        [Theory]
+        [InlineData("This is invalid")]
+        // missing a single character from the end
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKW")]
+        // bearer token
+        [InlineData("6qrZcUqja7812RVdnEKjpzOL4CvHBFG")]
+        // client secret
+        [InlineData("937it3ow87i4ery69876wqire")]
+        public void TestBotTokenInvalidThrowsArgumentException(string token)
+        {
+            Assert.Throws<ArgumentException>(() => TokenUtils.ValidateToken(TokenType.Bot, token));
+        }
+
+        /// <summary>
+        ///     Tests the behavior of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
+        ///     to see that an <see cref="ArgumentException"/> is thrown when an invalid
+        ///     <see cref="TokenType"/> is supplied as a parameter.
+        /// </summary>
+        /// <remarks>
+        ///     The <see cref="TokenType.User"/> type is treated as an invalid <see cref="TokenType"/>.
+        /// </remarks>
+        [Theory]
+        // TokenType.User
+        [InlineData(0)]
+        // out of range TokenType
+        [InlineData(4)]
+        [InlineData(7)]
+        public void TestUnrecognizedTokenType(int type)
+        {
+            Assert.Throws<ArgumentException>(() =>
+                TokenUtils.ValidateToken((TokenType)type, "MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs"));
+        }
+    }
+}

From a2d8800115c7cc41d82871a68cd08fcdecc747ab Mon Sep 17 00:00:00 2001
From: Joe4evr <jii.geugten@gmail.com>
Date: Thu, 30 Aug 2018 23:29:05 +0200
Subject: [PATCH 07/59] Add == support on Color (#1126)

---
 src/Discord.Net.Core/Entities/Roles/Color.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/Discord.Net.Core/Entities/Roles/Color.cs b/src/Discord.Net.Core/Entities/Roles/Color.cs
index 0bb04d339..727049dcc 100644
--- a/src/Discord.Net.Core/Entities/Roles/Color.cs
+++ b/src/Discord.Net.Core/Entities/Roles/Color.cs
@@ -100,6 +100,17 @@ namespace Discord
                 (uint)(b * 255.0f);
         }
 
+        public static bool operator ==(Color lhs, Color rhs)
+            => lhs.RawValue == rhs.RawValue;
+
+        public static bool operator !=(Color lhs, Color rhs)
+            => lhs.RawValue != rhs.RawValue;
+
+        public override bool Equals(object obj)
+            => (obj is Color c && RawValue == c.RawValue);
+
+        public override int GetHashCode() => RawValue.GetHashCode();
+
 #if NETSTANDARD2_0 || NET45
         public static implicit operator StandardColor(Color color) =>
             StandardColor.FromArgb((int)color.RawValue);

From 82cfdffc6516e17ea86013e550060bb6df59a016 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Fri, 31 Aug 2018 05:36:44 +0800
Subject: [PATCH 08/59] Add various optimizations and cleanups (#1114)

* Change all Select(... as ...) to OfType

* Add changes according to https://github.com/Still34/Discord.Net/commit/194a8aa4273caa4ea6723e6fab4d8b3f9efc0a00
---
 .../Attributes/OverrideTypeReaderAttribute.cs |  4 ++--
 .../Builders/ModuleClassBuilder.cs            |  6 ++---
 src/Discord.Net.Commands/CommandService.cs    |  4 ++--
 src/Discord.Net.Commands/Info/CommandInfo.cs  |  4 ++--
 src/Discord.Net.Commands/Map/CommandMap.cs    |  4 ++--
 .../Map/CommandMapNode.cs                     | 11 +++++-----
 src/Discord.Net.Commands/PrimitiveParsers.cs  |  8 +++----
 .../Readers/TimeSpanTypeReader.cs             |  5 ++---
 .../Readers/UserTypeReader.cs                 |  4 ++--
 .../Utilities/ReflectionUtils.cs              |  4 ++--
 .../Entities/Messages/EmbedBuilder.cs         |  4 ++--
 .../Entities/Messages/EmbedImage.cs           |  4 ++--
 .../Entities/Messages/EmbedThumbnail.cs       |  4 ++--
 .../Entities/Messages/EmbedVideo.cs           |  4 ++--
 .../Extensions/DiscordClientExtensions.cs     |  4 ++--
 src/Discord.Net.Core/Format.cs                |  4 ++--
 src/Discord.Net.Core/Utils/MentionUtils.cs    | 18 +++++++--------
 .../Utils/Paging/PagedEnumerator.cs           |  6 ++---
 src/Discord.Net.Core/Utils/Permissions.cs     | 10 ++++-----
 src/Discord.Net.Core/Utils/Preconditions.cs   |  4 ++--
 src/Discord.Net.Rest/BaseDiscordClient.cs     |  2 +-
 src/Discord.Net.Rest/ClientHelper.cs          |  2 +-
 src/Discord.Net.Rest/DiscordRestApiClient.cs  |  6 ++---
 .../Entities/Channels/RestDMChannel.cs        |  2 +-
 .../Entities/Channels/RestGroupChannel.cs     |  2 +-
 .../Entities/Channels/RestGuildChannel.cs     |  2 +-
 .../Entities/Guilds/RestGuild.cs              |  6 ++---
 .../Entities/Guilds/RestUserGuild.cs          |  4 ++--
 .../Entities/Users/RestGuildUser.cs           |  4 ++--
 src/Discord.Net.Rest/Net/DefaultRestClient.cs |  4 ++--
 .../Net/Queue/ClientBucket.cs                 | 14 ++++++------
 .../Net/Queue/RequestQueue.cs                 |  6 ++---
 src/Discord.Net.Rest/Net/RateLimitInfo.cs     |  2 +-
 .../Audio/AudioClient.cs                      | 18 +++++++--------
 .../Audio/Streams/BufferedWriteStream.cs      | 10 ++++-----
 src/Discord.Net.WebSocket/ClientState.cs      |  4 ++--
 .../DiscordShardedClient.cs                   |  8 +++----
 .../DiscordSocketApiClient.cs                 |  2 +-
 .../DiscordSocketClient.cs                    | 22 +++++++++----------
 .../DiscordVoiceApiClient.cs                  |  4 ++--
 .../Entities/Channels/SocketDMChannel.cs      |  2 +-
 .../Entities/Channels/SocketGroupChannel.cs   |  6 ++---
 .../Entities/Guilds/SocketGuild.cs            | 10 ++++-----
 .../Entities/Messages/MessageCache.cs         |  4 ++--
 .../Entities/Messages/SocketUserMessage.cs    |  2 +-
 .../Net/DefaultWebSocketClient.cs             |  2 +-
 46 files changed, 131 insertions(+), 135 deletions(-)

diff --git a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
index 44ab6d214..17e2310d4 100644
--- a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
@@ -7,13 +7,13 @@ namespace Discord.Commands
     [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class OverrideTypeReaderAttribute : Attribute
     {
-        private static readonly TypeInfo _typeReaderTypeInfo = typeof(TypeReader).GetTypeInfo();
+        private static readonly TypeInfo TypeReaderTypeInfo = typeof(TypeReader).GetTypeInfo();
 
         public Type TypeReader { get; }
 
         public OverrideTypeReaderAttribute(Type overridenTypeReader)
         {
-            if (!_typeReaderTypeInfo.IsAssignableFrom(overridenTypeReader.GetTypeInfo()))
+            if (!TypeReaderTypeInfo.IsAssignableFrom(overridenTypeReader.GetTypeInfo()))
                 throw new ArgumentException($"{nameof(overridenTypeReader)} must inherit from {nameof(TypeReader)}");
             
             TypeReader = overridenTypeReader;
diff --git a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
index cbe02aafb..307874ca6 100644
--- a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
+++ b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
@@ -10,7 +10,7 @@ namespace Discord.Commands
 {
     internal static class ModuleClassBuilder
     {
-        private static readonly TypeInfo _moduleTypeInfo = typeof(IModuleBase).GetTypeInfo();
+        private static readonly TypeInfo ModuleTypeInfo = typeof(IModuleBase).GetTypeInfo();
 
         public static async Task<IReadOnlyList<TypeInfo>> SearchAsync(Assembly assembly, CommandService service)
         {
@@ -135,7 +135,7 @@ namespace Discord.Commands
             if (builder.Name == null)
                 builder.Name = typeInfo.Name;
 
-            var validCommands = typeInfo.DeclaredMethods.Where(x => IsValidCommandDefinition(x));
+            var validCommands = typeInfo.DeclaredMethods.Where(IsValidCommandDefinition);
 
             foreach (var method in validCommands)
             {
@@ -299,7 +299,7 @@ namespace Discord.Commands
 
         private static bool IsValidModuleDefinition(TypeInfo typeInfo)
         {
-            return _moduleTypeInfo.IsAssignableFrom(typeInfo) &&
+            return ModuleTypeInfo.IsAssignableFrom(typeInfo) &&
                    !typeInfo.IsAbstract &&
                    !typeInfo.ContainsGenericParameters;
         }
diff --git a/src/Discord.Net.Commands/CommandService.cs b/src/Discord.Net.Commands/CommandService.cs
index 6fd5d38ad..7b7cffda2 100644
--- a/src/Discord.Net.Commands/CommandService.cs
+++ b/src/Discord.Net.Commands/CommandService.cs
@@ -118,7 +118,7 @@ namespace Discord.Commands
                 var typeInfo = type.GetTypeInfo();
 
                 if (_typedModuleDefs.ContainsKey(type))
-                    throw new ArgumentException($"This module has already been added.");
+                    throw new ArgumentException("This module has already been added.");
 
                 var module = (await ModuleClassBuilder.BuildAsync(this, services, typeInfo).ConfigureAwait(false)).FirstOrDefault();
 
@@ -241,7 +241,7 @@ namespace Discord.Commands
         {
             if (_defaultTypeReaders.ContainsKey(type))
                 _ = _cmdLogger.WarningAsync($"The default TypeReader for {type.FullName} was replaced by {reader.GetType().FullName}." +
-                    $"To suppress this message, use AddTypeReader<T>(reader, true).");
+                    "To suppress this message, use AddTypeReader<T>(reader, true).");
             AddTypeReader(type, reader, true);
         }
         /// <summary>
diff --git a/src/Discord.Net.Commands/Info/CommandInfo.cs b/src/Discord.Net.Commands/Info/CommandInfo.cs
index df0bb297b..604bfbc93 100644
--- a/src/Discord.Net.Commands/Info/CommandInfo.cs
+++ b/src/Discord.Net.Commands/Info/CommandInfo.cs
@@ -1,4 +1,4 @@
-using Discord.Commands.Builders;
+using Discord.Commands.Builders;
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -63,7 +63,7 @@ namespace Discord.Commands
             Attributes = builder.Attributes.ToImmutableArray();
 
             Parameters = builder.Parameters.Select(x => x.Build(this)).ToImmutableArray();
-            HasVarArgs = builder.Parameters.Count > 0 ? builder.Parameters[builder.Parameters.Count - 1].IsMultiple : false;
+            HasVarArgs = builder.Parameters.Count > 0 && builder.Parameters[builder.Parameters.Count - 1].IsMultiple;
             IgnoreExtraArgs = builder.IgnoreExtraArgs;
 
             _action = builder.Callback;
diff --git a/src/Discord.Net.Commands/Map/CommandMap.cs b/src/Discord.Net.Commands/Map/CommandMap.cs
index bcff800d3..141ec6fdf 100644
--- a/src/Discord.Net.Commands/Map/CommandMap.cs
+++ b/src/Discord.Net.Commands/Map/CommandMap.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord.Commands
 {
@@ -6,7 +6,7 @@ namespace Discord.Commands
     {
         private readonly CommandService _service;
         private readonly CommandMapNode _root;
-        private static readonly string[] _blankAliases = new[] { "" };
+        private static readonly string[] BlankAliases = { "" };
 
         public CommandMap(CommandService service)
         {
diff --git a/src/Discord.Net.Commands/Map/CommandMapNode.cs b/src/Discord.Net.Commands/Map/CommandMapNode.cs
index 863409207..bd3067718 100644
--- a/src/Discord.Net.Commands/Map/CommandMapNode.cs
+++ b/src/Discord.Net.Commands/Map/CommandMapNode.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -7,7 +7,7 @@ namespace Discord.Commands
 {
     internal class CommandMapNode
     {
-        private static readonly char[] _whitespaceChars = new[] { ' ', '\r', '\n' };
+        private static readonly char[] WhitespaceChars = { ' ', '\r', '\n' };
 
         private readonly ConcurrentDictionary<string, CommandMapNode> _nodes;
         private readonly string _name;
@@ -52,7 +52,6 @@ namespace Discord.Commands
         public void RemoveCommand(CommandService service, string text, int index, CommandInfo command)
         {
             int nextSegment = NextSegment(text, index, service._separatorChar);
-            string name;
 
             lock (_lockObj)
             {
@@ -60,13 +59,13 @@ namespace Discord.Commands
                     _commands = _commands.Remove(command);
                 else
                 {
+                    string name;
                     if (nextSegment == -1)
                         name = text.Substring(index);
                     else
                         name = text.Substring(index, nextSegment - index);
 
-                    CommandMapNode nextNode;
-                    if (_nodes.TryGetValue(name, out nextNode))
+                    if (_nodes.TryGetValue(name, out var nextNode))
                     {
                         nextNode.RemoveCommand(service, nextSegment == -1 ? "" : text, nextSegment + 1, command);
                         if (nextNode.IsEmpty)
@@ -100,7 +99,7 @@ namespace Discord.Commands
                 }
 
                 //Check if this is the last command segment before args
-                nextSegment = NextSegment(text, index, _whitespaceChars, service._separatorChar);
+                nextSegment = NextSegment(text, index, WhitespaceChars, service._separatorChar);
                 if (nextSegment != -1)
                 {
                     name = text.Substring(index, nextSegment - index);
diff --git a/src/Discord.Net.Commands/PrimitiveParsers.cs b/src/Discord.Net.Commands/PrimitiveParsers.cs
index bf0622c28..e9b6aac3f 100644
--- a/src/Discord.Net.Commands/PrimitiveParsers.cs
+++ b/src/Discord.Net.Commands/PrimitiveParsers.cs
@@ -8,9 +8,9 @@ namespace Discord.Commands
 
     internal static class PrimitiveParsers
     {
-        private static readonly Lazy<IReadOnlyDictionary<Type, Delegate>> _parsers = new Lazy<IReadOnlyDictionary<Type, Delegate>>(CreateParsers);
+        private static readonly Lazy<IReadOnlyDictionary<Type, Delegate>> Parsers = new Lazy<IReadOnlyDictionary<Type, Delegate>>(CreateParsers);
 
-        public static IEnumerable<Type> SupportedTypes = _parsers.Value.Keys;
+        public static IEnumerable<Type> SupportedTypes = Parsers.Value.Keys;
 
         static IReadOnlyDictionary<Type, Delegate> CreateParsers()
         {
@@ -34,7 +34,7 @@ namespace Discord.Commands
             return parserBuilder.ToImmutable();
         }
 
-        public static TryParseDelegate<T> Get<T>() => (TryParseDelegate<T>)_parsers.Value[typeof(T)];
-        public static Delegate Get(Type type) => _parsers.Value[type];
+        public static TryParseDelegate<T> Get<T>() => (TryParseDelegate<T>)Parsers.Value[typeof(T)];
+        public static Delegate Get(Type type) => Parsers.Value[type];
     }
 }
diff --git a/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs b/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
index 31ab9d821..314fbb322 100644
--- a/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
@@ -6,8 +6,7 @@ namespace Discord.Commands
 {
     internal class TimeSpanTypeReader : TypeReader
     {
-        private static readonly string[] _formats = new[]
-        {
+        private static readonly string[] Formats = {
             "%d'd'%h'h'%m'm'%s's'", //4d3h2m1s
             "%d'd'%h'h'%m'm'",      //4d3h2m
             "%d'd'%h'h'%s's'",      //4d3h  1s
@@ -27,7 +26,7 @@ namespace Discord.Commands
 
         public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
-            return (TimeSpan.TryParseExact(input.ToLowerInvariant(), _formats, CultureInfo.InvariantCulture, out var timeSpan))
+            return (TimeSpan.TryParseExact(input.ToLowerInvariant(), Formats, CultureInfo.InvariantCulture, out var timeSpan))
                 ? Task.FromResult(TypeReaderResult.FromSuccess(timeSpan))
                 : Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, "Failed to parse TimeSpan"));
         }
diff --git a/src/Discord.Net.Commands/Readers/UserTypeReader.cs b/src/Discord.Net.Commands/Readers/UserTypeReader.cs
index 425c2ccb7..498a214e4 100644
--- a/src/Discord.Net.Commands/Readers/UserTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/UserTypeReader.cs
@@ -71,8 +71,8 @@ namespace Discord.Commands
                     .Where(x => string.Equals(input, (x as IGuildUser)?.Nickname, StringComparison.OrdinalIgnoreCase))
                     .ForEachAsync(channelUser => AddResult(results, channelUser as T, (channelUser as IGuildUser).Nickname == input ? 0.65f : 0.55f));
 
-                foreach (var guildUser in guildUsers.Where(x => string.Equals(input, (x as IGuildUser).Nickname, StringComparison.OrdinalIgnoreCase)))
-                    AddResult(results, guildUser as T, (guildUser as IGuildUser).Nickname == input ? 0.60f : 0.50f);
+                foreach (var guildUser in guildUsers.Where(x => string.Equals(input, x.Nickname, StringComparison.OrdinalIgnoreCase)))
+                    AddResult(results, guildUser as T, guildUser.Nickname == input ? 0.60f : 0.50f);
             }
 
             if (results.Count > 0)
diff --git a/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs b/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
index 30dd7c36b..ec981cf52 100644
--- a/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
+++ b/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
@@ -8,7 +8,7 @@ namespace Discord.Commands
 {
     internal static class ReflectionUtils
     {
-        private static readonly TypeInfo _objectTypeInfo = typeof(object).GetTypeInfo();
+        private static readonly TypeInfo ObjectTypeInfo = typeof(object).GetTypeInfo();
 
         internal static T CreateObject<T>(TypeInfo typeInfo, CommandService commands, IServiceProvider services = null)
             => CreateBuilder<T>(typeInfo, commands)(services);
@@ -54,7 +54,7 @@ namespace Discord.Commands
         private static System.Reflection.PropertyInfo[] GetProperties(TypeInfo ownerType)
         {
             var result = new List<System.Reflection.PropertyInfo>();
-            while (ownerType != _objectTypeInfo)
+            while (ownerType != ObjectTypeInfo)
             {
                 foreach (var prop in ownerType.DeclaredProperties)
                 {
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
index 04f4f6884..7e288ef6b 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
@@ -239,7 +239,7 @@ namespace Discord
             get => _name;
             set
             {
-                if (string.IsNullOrWhiteSpace(value)) throw new ArgumentException($"Field name must not be null, empty or entirely whitespace.", nameof(Name));
+                if (string.IsNullOrWhiteSpace(value)) throw new ArgumentException("Field name must not be null, empty or entirely whitespace.", nameof(Name));
                 if (value.Length > MaxFieldNameLength) throw new ArgumentException($"Field name length must be less than or equal to {MaxFieldNameLength}.", nameof(Name));
                 _name = value;
             }
@@ -251,7 +251,7 @@ namespace Discord
             set
             {
                 var stringValue = value?.ToString();
-                if (string.IsNullOrEmpty(stringValue)) throw new ArgumentException($"Field value must not be null or empty.", nameof(Value));
+                if (string.IsNullOrEmpty(stringValue)) throw new ArgumentException("Field value must not be null or empty.", nameof(Value));
                 if (stringValue.Length > MaxFieldValueLength) throw new ArgumentException($"Field value length must be less than or equal to {MaxFieldValueLength}.", nameof(Value));
                 _value = stringValue;
             }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs b/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
index f21d42c0c..e12ffc53f 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Discord
@@ -20,6 +20,6 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
-        public override string ToString() => Url.ToString();
+        public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs b/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
index 209a93e37..9b3d6153a 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Discord
@@ -20,6 +20,6 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
-        public override string ToString() => Url.ToString();
+        public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs b/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
index f00681d89..5725e0e14 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Discord
@@ -18,6 +18,6 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
-        public override string ToString() => Url.ToString();
+        public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs b/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
index ff3c7caf7..81cd10b49 100644
--- a/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
@@ -12,12 +12,12 @@ namespace Discord
         public static async Task<IDMChannel> GetDMChannelAsync(this IDiscordClient client, ulong id)
             => await client.GetPrivateChannelAsync(id).ConfigureAwait(false) as IDMChannel;
         public static async Task<IEnumerable<IDMChannel>> GetDMChannelsAsync(this IDiscordClient client)
-            => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).Select(x => x as IDMChannel).Where(x => x != null);
+            => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).OfType<IDMChannel>();
 
         public static async Task<IGroupChannel> GetGroupChannelAsync(this IDiscordClient client, ulong id)
             => await client.GetPrivateChannelAsync(id).ConfigureAwait(false) as IGroupChannel;
         public static async Task<IEnumerable<IGroupChannel>> GetGroupChannelsAsync(this IDiscordClient client)
-            => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).Select(x => x as IGroupChannel).Where(x => x != null);
+            => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).OfType<IGroupChannel>();
 
         public static async Task<IVoiceRegion> GetOptimalVoiceRegionAsync(this IDiscordClient discord)
         {
diff --git a/src/Discord.Net.Core/Format.cs b/src/Discord.Net.Core/Format.cs
index aa822f99e..414e00a29 100644
--- a/src/Discord.Net.Core/Format.cs
+++ b/src/Discord.Net.Core/Format.cs
@@ -1,9 +1,9 @@
-namespace Discord
+namespace Discord
 {
     public static class Format
     {
         // Characters which need escaping
-        private static string[] SensitiveCharacters = { "\\", "*", "_", "~", "`" };
+        private static readonly string[] SensitiveCharacters = { "\\", "*", "_", "~", "`" };
 
         /// <summary> Returns a markdown-formatted string with bold formatting. </summary>
         public static string Bold(string text) => $"**{text}**";
diff --git a/src/Discord.Net.Core/Utils/MentionUtils.cs b/src/Discord.Net.Core/Utils/MentionUtils.cs
index 6c69827b4..f2afe497a 100644
--- a/src/Discord.Net.Core/Utils/MentionUtils.cs
+++ b/src/Discord.Net.Core/Utils/MentionUtils.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Globalization;
 using System.Text;
 
@@ -139,22 +139,22 @@ namespace Discord
                         if (user != null)
                             return $"@{guildUser?.Nickname ?? user?.Username}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.NameNoPrefix:
                         if (user != null)
                             return $"{guildUser?.Nickname ?? user?.Username}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.FullName:
                         if (user != null)
                             return $"@{user.Username}#{user.Discriminator}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.FullNameNoPrefix:
                         if (user != null)
                             return $"{user.Username}#{user.Discriminator}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.Sanitize:
                         if (guildUser != null && guildUser.Nickname == null)
                             return MentionUser($"{SanitizeChar}{tag.Key}", false);
@@ -176,13 +176,13 @@ namespace Discord
                         if (channel != null)
                             return $"#{channel.Name}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.NameNoPrefix:
                     case TagHandling.FullNameNoPrefix:
                         if (channel != null)
                             return $"{channel.Name}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.Sanitize:
                         return MentionChannel($"{SanitizeChar}{tag.Key}");
                 }
@@ -201,13 +201,13 @@ namespace Discord
                         if (role != null)
                             return $"@{role.Name}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.NameNoPrefix:
                     case TagHandling.FullNameNoPrefix:
                         if (role != null)
                             return $"{role.Name}";
                         else
-                            return $"";
+                            return "";
                     case TagHandling.Sanitize:
                         return MentionRole($"{SanitizeChar}{tag.Key}");
                 }
diff --git a/src/Discord.Net.Core/Utils/Paging/PagedEnumerator.cs b/src/Discord.Net.Core/Utils/Paging/PagedEnumerator.cs
index 96059bb4f..a31721875 100644
--- a/src/Discord.Net.Core/Utils/Paging/PagedEnumerator.cs
+++ b/src/Discord.Net.Core/Utils/Paging/PagedEnumerator.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
@@ -60,7 +60,7 @@ namespace Discord
                     if (Current.Count == 0)
                         _info.Remaining = 0;
                 }
-                _info.PageSize = _info.Remaining != null ? (int)Math.Min(_info.Remaining.Value, _source.PageSize) : _source.PageSize;
+                _info.PageSize = _info.Remaining != null ? Math.Min(_info.Remaining.Value, _source.PageSize) : _source.PageSize;
 
                 if (_info.Remaining != 0)
                 {
@@ -74,4 +74,4 @@ namespace Discord
             public void Dispose() { Current = null; }
         }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Utils/Permissions.cs b/src/Discord.Net.Core/Utils/Permissions.cs
index 04e6784c3..6e7125ab7 100644
--- a/src/Discord.Net.Core/Utils/Permissions.cs
+++ b/src/Discord.Net.Core/Utils/Permissions.cs
@@ -1,4 +1,4 @@
-using System.Runtime.CompilerServices;
+using System.Runtime.CompilerServices;
 
 namespace Discord
 {
@@ -119,13 +119,11 @@ namespace Discord
                 resolvedPermissions = mask; //Owners and administrators always have all permissions
             else
             {
-                OverwritePermissions? perms;
-
                 //Start with this user's guild permissions
                 resolvedPermissions = guildPermissions;
 
                 //Give/Take Everyone permissions
-                perms = channel.GetPermissionOverwrite(guild.EveryoneRole);
+                var perms = channel.GetPermissionOverwrite(guild.EveryoneRole);
                 if (perms != null)
                     resolvedPermissions = (resolvedPermissions & ~perms.Value.DenyValue) | perms.Value.AllowValue;
 
@@ -133,7 +131,7 @@ namespace Discord
                 ulong deniedPermissions = 0UL, allowedPermissions = 0UL;
                 foreach (var roleId in user.RoleIds)
                 {
-                    IRole role = null;
+                    IRole role;
                     if (roleId != guild.EveryoneRole.Id && (role = guild.GetRole(roleId)) != null)
                     {
                         perms = channel.GetPermissionOverwrite(role);
@@ -151,7 +149,7 @@ namespace Discord
                 if (perms != null)
                     resolvedPermissions = (resolvedPermissions  & ~perms.Value.DenyValue) | perms.Value.AllowValue;
 
-                if (channel is ITextChannel textChannel)
+                if (channel is ITextChannel)
                 {
                     if (!GetValue(resolvedPermissions, ChannelPermission.ViewChannel))
                     {
diff --git a/src/Discord.Net.Core/Utils/Preconditions.cs b/src/Discord.Net.Core/Utils/Preconditions.cs
index 300f584e4..1a297a6a1 100644
--- a/src/Discord.Net.Core/Utils/Preconditions.cs
+++ b/src/Discord.Net.Core/Utils/Preconditions.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 
 namespace Discord
 {
@@ -198,7 +198,7 @@ namespace Discord
             for (var i = 0; i < roles.Length; i++)
             {
                 if (roles[i] == guildId)
-                    throw new ArgumentException($"The everyone role cannot be assigned to a user", name);
+                    throw new ArgumentException("The everyone role cannot be assigned to a user", name);
             }
         }
     }
diff --git a/src/Discord.Net.Rest/BaseDiscordClient.cs b/src/Discord.Net.Rest/BaseDiscordClient.cs
index 8ac4e9f98..8a3db3e6a 100644
--- a/src/Discord.Net.Rest/BaseDiscordClient.cs
+++ b/src/Discord.Net.Rest/BaseDiscordClient.cs
@@ -92,7 +92,7 @@ namespace Discord.Rest
                 await OnLoginAsync(tokenType, token).ConfigureAwait(false);
                 LoginState = LoginState.LoggedIn;
             }
-            catch (Exception)
+            catch
             {
                 await LogoutInternalAsync().ConfigureAwait(false);
                 throw;
diff --git a/src/Discord.Net.Rest/ClientHelper.cs b/src/Discord.Net.Rest/ClientHelper.cs
index d8f481d15..aa99fe005 100644
--- a/src/Discord.Net.Rest/ClientHelper.cs
+++ b/src/Discord.Net.Rest/ClientHelper.cs
@@ -47,7 +47,7 @@ namespace Discord.Rest
         public static async Task<IReadOnlyCollection<RestConnection>> GetConnectionsAsync(BaseDiscordClient client, RequestOptions options)
         {
             var models = await client.ApiClient.GetMyConnectionsAsync(options).ConfigureAwait(false);
-            return models.Select(x => RestConnection.Create(x)).ToImmutableArray();
+            return models.Select(RestConnection.Create).ToImmutableArray();
         }
         
         public static async Task<RestInviteMetadata> GetInviteAsync(BaseDiscordClient client,
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index a9fc1ed74..f8e3e6f50 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -125,7 +125,7 @@ namespace Discord.API
 
                 LoginState = LoginState.LoggedIn;
             }
-            catch (Exception)
+            catch
             {
                 await LogoutInternalAsync().ConfigureAwait(false);
                 throw;
@@ -1394,9 +1394,9 @@ namespace Discord.API
 
                     int argId = int.Parse(format.Substring(leftIndex + 1, rightIndex - leftIndex - 1));
                     string fieldName = GetFieldName(methodArgs[argId + 1]);
-                    int? mappedId;
 
-                    mappedId = BucketIds.GetIndex(fieldName);
+                    var mappedId = BucketIds.GetIndex(fieldName);
+
                     if(!mappedId.HasValue && rightIndex != endIndex && format.Length > rightIndex + 1 && format[rightIndex + 1] == '/') //Ignore the next slash
                         rightIndex++;
 
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
index 64efcf24b..20a76aaf0 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
@@ -10,7 +10,7 @@ using Model = Discord.API.Channel;
 namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    public class RestDMChannel : RestChannel, IDMChannel, IRestPrivateChannel, IRestMessageChannel, IUpdateable
+    public class RestDMChannel : RestChannel, IDMChannel, IRestPrivateChannel, IRestMessageChannel
     {
         public RestUser CurrentUser { get; private set; }
         public RestUser Recipient { get; private set; }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
index 5ac0f2c40..c6b5d6ad0 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
@@ -11,7 +11,7 @@ using Model = Discord.API.Channel;
 namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    public class RestGroupChannel : RestChannel, IGroupChannel, IRestPrivateChannel, IRestMessageChannel, IRestAudioChannel, IUpdateable
+    public class RestGroupChannel : RestChannel, IGroupChannel, IRestPrivateChannel, IRestMessageChannel, IRestAudioChannel
     {
         private string _iconId;
         private ImmutableDictionary<ulong, RestGroupUser> _users;
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
index 7355e3673..1dbcf7e9a 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
@@ -7,7 +7,7 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
-    public class RestGuildChannel : RestChannel, IGuildChannel, IUpdateable
+    public class RestGuildChannel : RestChannel, IGuildChannel
     {
         private ImmutableArray<Overwrite> _overwrites;
 
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index 9bf13fa07..e6819e8a4 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -168,7 +168,7 @@ namespace Discord.Rest
         public async Task<IReadOnlyCollection<RestTextChannel>> GetTextChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
-            return channels.Select(x => x as RestTextChannel).Where(x => x != null).ToImmutableArray();
+            return channels.OfType<RestTextChannel>().ToImmutableArray();
         }
         public async Task<RestVoiceChannel> GetVoiceChannelAsync(ulong id, RequestOptions options = null)
         {
@@ -178,12 +178,12 @@ namespace Discord.Rest
         public async Task<IReadOnlyCollection<RestVoiceChannel>> GetVoiceChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
-            return channels.Select(x => x as RestVoiceChannel).Where(x => x != null).ToImmutableArray();
+            return channels.OfType<RestVoiceChannel>().ToImmutableArray();
         }
         public async Task<IReadOnlyCollection<RestCategoryChannel>> GetCategoryChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
-            return channels.Select(x => x as RestCategoryChannel).Where(x => x != null).ToImmutableArray();
+            return channels.OfType<RestCategoryChannel>().ToImmutableArray();
         }
 
         public async Task<RestVoiceChannel> GetAFKChannelAsync(RequestOptions options = null)
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
index 6bc9cea7a..de5a5f7d9 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.UserGuild;
@@ -6,7 +6,7 @@ using Model = Discord.API.UserGuild;
 namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    public class RestUserGuild : RestEntity<ulong>, ISnowflakeEntity, IUserGuild
+    public class RestUserGuild : RestEntity<ulong>, IUserGuild
     {
         private string _iconId;
                 
diff --git a/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs b/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
index e571f8f73..3c47587cb 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
@@ -9,7 +9,7 @@ using Model = Discord.API.GuildMember;
 namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    public class RestGuildUser : RestUser, IGuildUser, IUpdateable
+    public class RestGuildUser : RestUser, IGuildUser
     {
         private long? _joinedAtTicks;
         private ImmutableArray<ulong> _roleIds;
diff --git a/src/Discord.Net.Rest/Net/DefaultRestClient.cs b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
index ec789be59..54fe3b681 100644
--- a/src/Discord.Net.Rest/Net/DefaultRestClient.cs
+++ b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
@@ -131,14 +131,14 @@ namespace Discord.Net.Rest
             return new RestResponse(response.StatusCode, headers, stream);
         }
 
-        private static readonly HttpMethod _patch = new HttpMethod("PATCH");
+        private static readonly HttpMethod Patch = new HttpMethod("PATCH");
         private HttpMethod GetMethod(string method)
         {
             switch (method)
             {
                 case "DELETE": return HttpMethod.Delete;
                 case "GET": return HttpMethod.Get;
-                case "PATCH": return _patch;
+                case "PATCH": return Patch;
                 case "POST": return HttpMethod.Post;
                 case "PUT": return HttpMethod.Put;
                 default: throw new ArgumentOutOfRangeException(nameof(method), $"Unknown HttpMethod: {method}");
diff --git a/src/Discord.Net.Rest/Net/Queue/ClientBucket.cs b/src/Discord.Net.Rest/Net/Queue/ClientBucket.cs
index f32df1bcf..cd9d8aa54 100644
--- a/src/Discord.Net.Rest/Net/Queue/ClientBucket.cs
+++ b/src/Discord.Net.Rest/Net/Queue/ClientBucket.cs
@@ -1,4 +1,4 @@
-using System.Collections.Immutable;
+using System.Collections.Immutable;
 
 namespace Discord.Net.Queue
 {
@@ -9,8 +9,8 @@ namespace Discord.Net.Queue
     }
     internal struct ClientBucket
     {
-        private static readonly ImmutableDictionary<ClientBucketType, ClientBucket> _defsByType;
-        private static readonly ImmutableDictionary<string, ClientBucket> _defsById;
+        private static readonly ImmutableDictionary<ClientBucketType, ClientBucket> DefsByType;
+        private static readonly ImmutableDictionary<string, ClientBucket> DefsById;
 
         static ClientBucket()
         {
@@ -23,16 +23,16 @@ namespace Discord.Net.Queue
             var builder = ImmutableDictionary.CreateBuilder<ClientBucketType, ClientBucket>();
             foreach (var bucket in buckets)
                 builder.Add(bucket.Type, bucket);
-            _defsByType = builder.ToImmutable();
+            DefsByType = builder.ToImmutable();
 
             var builder2 = ImmutableDictionary.CreateBuilder<string, ClientBucket>();
             foreach (var bucket in buckets)
                 builder2.Add(bucket.Id, bucket);
-            _defsById = builder2.ToImmutable();
+            DefsById = builder2.ToImmutable();
         }
 
-        public static ClientBucket Get(ClientBucketType type) => _defsByType[type];
-        public static ClientBucket Get(string id) => _defsById[id];
+        public static ClientBucket Get(ClientBucketType type) => DefsByType[type];
+        public static ClientBucket Get(string id) => DefsById[id];
         
         public ClientBucketType Type { get; }
         public string Id { get; }
diff --git a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
index 943b76359..40b91e98e 100644
--- a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
+++ b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 #if DEBUG_LIMITS
 using System.Diagnostics;
@@ -16,10 +16,10 @@ namespace Discord.Net.Queue
 
         private readonly ConcurrentDictionary<string, RequestBucket> _buckets;
         private readonly SemaphoreSlim _tokenLock;
+        private readonly CancellationTokenSource _cancelToken; //Dispose token
         private CancellationTokenSource _clearToken;
         private CancellationToken _parentToken;
         private CancellationToken _requestCancelToken; //Parent token + Clear token
-        private CancellationTokenSource _cancelToken; //Dispose token
         private DateTimeOffset _waitUntil;
 
         private Task _cleanupTask;
@@ -115,7 +115,7 @@ namespace Discord.Net.Queue
                     foreach (var bucket in _buckets.Select(x => x.Value))
                     {
                         if ((now - bucket.LastAttemptAt).TotalMinutes > 1.0)
-                            _buckets.TryRemove(bucket.Id, out RequestBucket ignored);
+                            _buckets.TryRemove(bucket.Id, out _);
                     }
                     await Task.Delay(60000, _cancelToken.Token); //Runs each minute
                 }
diff --git a/src/Discord.Net.Rest/Net/RateLimitInfo.cs b/src/Discord.Net.Rest/Net/RateLimitInfo.cs
index a517f290c..d31cc5cdd 100644
--- a/src/Discord.Net.Rest/Net/RateLimitInfo.cs
+++ b/src/Discord.Net.Rest/Net/RateLimitInfo.cs
@@ -15,7 +15,7 @@ namespace Discord.Net
         internal RateLimitInfo(Dictionary<string, string> headers)
         {
             IsGlobal = headers.TryGetValue("X-RateLimit-Global", out string temp) &&
-    bool.TryParse(temp, out var isGlobal) ? isGlobal : false;
+                       bool.TryParse(temp, out var isGlobal) && isGlobal;
             Limit = headers.TryGetValue("X-RateLimit-Limit", out temp) && 
                 int.TryParse(temp, out var limit) ? limit : (int?)null;
             Remaining = headers.TryGetValue("X-RateLimit-Remaining", out temp) && 
diff --git a/src/Discord.Net.WebSocket/Audio/AudioClient.cs b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
index bbb65a298..9f197b5c5 100644
--- a/src/Discord.Net.WebSocket/Audio/AudioClient.cs
+++ b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
@@ -16,7 +16,7 @@ using System.Collections.Generic;
 namespace Discord.Audio
 {
     //TODO: Add audio reconnecting
-    internal partial class AudioClient : IAudioClient, IDisposable
+    internal partial class AudioClient : IAudioClient
     {
         internal struct StreamPair
         {
@@ -65,7 +65,7 @@ namespace Discord.Audio
 
             ApiClient = new DiscordVoiceAPIClient(guild.Id, Discord.WebSocketProvider, Discord.UdpSocketProvider);
             ApiClient.SentGatewayMessage += async opCode => await _audioLogger.DebugAsync($"Sent {opCode}").ConfigureAwait(false);
-            ApiClient.SentDiscovery += async () => await _audioLogger.DebugAsync($"Sent Discovery").ConfigureAwait(false);
+            ApiClient.SentDiscovery += async () => await _audioLogger.DebugAsync("Sent Discovery").ConfigureAwait(false);
             //ApiClient.SentData += async bytes => await _audioLogger.DebugAsync($"Sent {bytes} Bytes").ConfigureAwait(false);
             ApiClient.ReceivedEvent += ProcessMessageAsync;
             ApiClient.ReceivedPacket += ProcessPacketAsync;
@@ -131,7 +131,7 @@ namespace Discord.Audio
                 await keepaliveTask.ConfigureAwait(false);
             _keepaliveTask = null;
 
-            while (_heartbeatTimes.TryDequeue(out long time)) { }
+            while (_heartbeatTimes.TryDequeue(out _)) { }
             _lastMessageTime = 0;
 
             await ClearInputStreamsAsync().ConfigureAwait(false);
@@ -292,7 +292,7 @@ namespace Discord.Audio
                 {
                     if (packet.Length != 70)
                     {
-                        await _audioLogger.DebugAsync($"Malformed Packet").ConfigureAwait(false);
+                        await _audioLogger.DebugAsync("Malformed Packet").ConfigureAwait(false);
                         return;
                     }
                     string ip;
@@ -304,7 +304,7 @@ namespace Discord.Audio
                     }
                     catch (Exception ex)
                     {
-                        await _audioLogger.DebugAsync($"Malformed Packet", ex).ConfigureAwait(false);
+                        await _audioLogger.DebugAsync("Malformed Packet", ex).ConfigureAwait(false);
                         return; 
                     }
                     
@@ -331,7 +331,7 @@ namespace Discord.Audio
                         {
                             if (pair.Key == value)
                             {
-                                int latency = (int)(Environment.TickCount - pair.Value);
+                                int latency = Environment.TickCount - pair.Value;
                                 int before = UdpLatency;
                                 UdpLatency = latency;
 
@@ -344,7 +344,7 @@ namespace Discord.Audio
                     {                        
                         if (!RTPReadStream.TryReadSsrc(packet, 0, out var ssrc))
                         {
-                            await _audioLogger.DebugAsync($"Malformed Frame").ConfigureAwait(false);
+                            await _audioLogger.DebugAsync("Malformed Frame").ConfigureAwait(false);
                             return;
                         }
                         if (!_ssrcMap.TryGetValue(ssrc, out var userId))
@@ -363,7 +363,7 @@ namespace Discord.Audio
                         }
                         catch (Exception ex)
                         {
-                            await _audioLogger.DebugAsync($"Malformed Frame", ex).ConfigureAwait(false);
+                            await _audioLogger.DebugAsync("Malformed Frame", ex).ConfigureAwait(false);
                             return;
                         }
                         //await _audioLogger.DebugAsync($"Received {packet.Length} bytes from user {userId}").ConfigureAwait(false);
@@ -372,7 +372,7 @@ namespace Discord.Audio
             }
             catch (Exception ex)
             {
-                await _audioLogger.WarningAsync($"Failed to process UDP packet", ex).ConfigureAwait(false);
+                await _audioLogger.WarningAsync("Failed to process UDP packet", ex).ConfigureAwait(false);
                 return;
             }
         }
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
index fb302f132..47a7e2809 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
@@ -116,7 +116,7 @@ namespace Discord.Audio.Streams
                                     timestamp += OpusEncoder.FrameSamplesPerChannel;
                                 }
 #if DEBUG
-                                var _ = _logger?.DebugAsync($"Buffer underrun");
+                                var _ = _logger?.DebugAsync("Buffer underrun");
 #endif
                             }
                         }
@@ -140,7 +140,7 @@ namespace Discord.Audio.Streams
             if (!_bufferPool.TryDequeue(out byte[] buffer))
             {
 #if DEBUG
-                var _ = _logger?.DebugAsync($"Buffer overflow"); //Should never happen because of the queueLock
+                var _ = _logger?.DebugAsync("Buffer overflow"); //Should never happen because of the queueLock
 #endif
                 return;
             }
@@ -149,7 +149,7 @@ namespace Discord.Audio.Streams
             if (!_isPreloaded && _queuedFrames.Count == _queueLength)
             {
 #if DEBUG
-                var _ = _logger?.DebugAsync($"Preloaded");
+                var _ = _logger?.DebugAsync("Preloaded");
 #endif
                 _isPreloaded = true;
             }
@@ -169,8 +169,8 @@ namespace Discord.Audio.Streams
         {
             do
                 cancelToken.ThrowIfCancellationRequested();
-            while (_queuedFrames.TryDequeue(out Frame ignored));
+            while (_queuedFrames.TryDequeue(out _));
             return Task.Delay(0);
         }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.WebSocket/ClientState.cs b/src/Discord.Net.WebSocket/ClientState.cs
index f07976a0a..a119e5e28 100644
--- a/src/Discord.Net.WebSocket/ClientState.cs
+++ b/src/Discord.Net.WebSocket/ClientState.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Linq;
@@ -72,7 +72,7 @@ namespace Discord.WebSocket
                 switch (channel)
                 {
                     case SocketDMChannel dmChannel:
-                        _dmChannels.TryRemove(dmChannel.Recipient.Id, out var ignored);
+                        _dmChannels.TryRemove(dmChannel.Recipient.Id, out _);
                         break;
                     case SocketGroupChannel groupChannel:
                         _groupChannels.TryRemove(id);
diff --git a/src/Discord.Net.WebSocket/DiscordShardedClient.cs b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
index e29cc4057..881ce3909 100644
--- a/src/Discord.Net.WebSocket/DiscordShardedClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
@@ -13,11 +13,11 @@ namespace Discord.WebSocket
     {
         private readonly DiscordSocketConfig _baseConfig;
         private readonly SemaphoreSlim _connectionGroupLock;
+        private readonly Dictionary<int, int> _shardIdsToIndex;
+        private readonly bool _automaticShards;
         private int[] _shardIds;
-        private Dictionary<int, int> _shardIdsToIndex;
         private DiscordSocketClient[] _shards;
         private int _totalShards;
-        private bool _automaticShards;
         
         /// <summary> Gets the estimated round-trip latency, in milliseconds, to the gateway server. </summary>
         public override int Latency { get => GetLatency(); protected set { } }
@@ -25,8 +25,8 @@ namespace Discord.WebSocket
         public override IActivity Activity { get => _shards[0].Activity; protected set { } }
 
         internal new DiscordSocketApiClient ApiClient => base.ApiClient as DiscordSocketApiClient;
-        public override IReadOnlyCollection<SocketGuild> Guilds => GetGuilds().ToReadOnlyCollection(() => GetGuildCount());
-        public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels => GetPrivateChannels().ToReadOnlyCollection(() => GetPrivateChannelCount());
+        public override IReadOnlyCollection<SocketGuild> Guilds => GetGuilds().ToReadOnlyCollection(GetGuildCount);
+        public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels => GetPrivateChannels().ToReadOnlyCollection(GetPrivateChannelCount);
         public IReadOnlyCollection<DiscordSocketClient> Shards => _shards;
         public override IReadOnlyCollection<RestVoiceRegion> VoiceRegions => _shards[0].VoiceRegions;
 
diff --git a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
index 8ae41cc59..d42bd7132 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
@@ -26,9 +26,9 @@ namespace Discord.API
         public event Func<Exception, Task> Disconnected { add { _disconnectedEvent.Add(value); } remove { _disconnectedEvent.Remove(value); } }
         private readonly AsyncEvent<Func<Exception, Task>> _disconnectedEvent = new AsyncEvent<Func<Exception, Task>>();
 
+        private readonly bool _isExplicitUrl;
         private CancellationTokenSource _connectCancelToken;
         private string _gatewayUrl;
-        private bool _isExplicitUrl;
 
         //Store our decompression streams for zlib shared state
         private MemoryStream _compressed;
diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
index 9efc7d3fa..45d60b764 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
@@ -63,9 +63,9 @@ namespace Discord.WebSocket
         public override IReadOnlyCollection<SocketGuild> Guilds => State.Guilds;
         public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels => State.PrivateChannels;
         public IReadOnlyCollection<SocketDMChannel> DMChannels
-            => State.PrivateChannels.Select(x => x as SocketDMChannel).Where(x => x != null).ToImmutableArray();
+            => State.PrivateChannels.OfType<SocketDMChannel>().ToImmutableArray();
         public IReadOnlyCollection<SocketGroupChannel> GroupChannels
-            => State.PrivateChannels.Select(x => x as SocketGroupChannel).Where(x => x != null).ToImmutableArray();
+            => State.PrivateChannels.OfType<SocketGroupChannel>().ToImmutableArray();
         public override IReadOnlyCollection<RestVoiceRegion> VoiceRegions => _voiceRegions.ToReadOnlyCollection();
 
         /// <summary> Creates a new REST/WebSocket discord client. </summary>
@@ -207,7 +207,7 @@ namespace Discord.WebSocket
                 await heartbeatTask.ConfigureAwait(false);
             _heartbeatTask = null;
 
-            while (_heartbeatTimes.TryDequeue(out long time)) { }
+            while (_heartbeatTimes.TryDequeue(out _)) { }
             _lastMessageTime = 0;
 
             await _gatewayLogger.DebugAsync("Waiting for guild downloader").ConfigureAwait(false);
@@ -218,7 +218,7 @@ namespace Discord.WebSocket
 
             //Clear large guild queue
             await _gatewayLogger.DebugAsync("Clearing large guild queue").ConfigureAwait(false);
-            while (_largeGuilds.TryDequeue(out ulong guildId)) { }
+            while (_largeGuilds.TryDequeue(out _)) { }
 
             //Raise virtual GUILD_UNAVAILABLEs
             await _gatewayLogger.DebugAsync("Raising virtual GuildUnavailables").ConfigureAwait(false);
@@ -351,7 +351,7 @@ namespace Discord.WebSocket
 
             var gameModel = new GameModel();
             // Discord only accepts rich presence over RPC, don't even bother building a payload
-            if (Activity is RichGame game)
+            if (Activity is RichGame)
                 throw new NotSupportedException("Outgoing Rich Presences are not supported");
 
             if (Activity != null)
@@ -508,7 +508,7 @@ namespace Discord.WebSocket
                                     {
                                         type = "GUILD_AVAILABLE";
                                         _lastGuildAvailableTime = Environment.TickCount;
-                                        await _gatewayLogger.DebugAsync($"Received Dispatch (GUILD_AVAILABLE)").ConfigureAwait(false);
+                                        await _gatewayLogger.DebugAsync("Received Dispatch (GUILD_AVAILABLE)").ConfigureAwait(false);
 
                                         var guild = State.GetGuild(data.Id);
                                         if (guild != null)
@@ -533,7 +533,7 @@ namespace Discord.WebSocket
                                     }
                                     else
                                     {
-                                        await _gatewayLogger.DebugAsync($"Received Dispatch (GUILD_CREATE)").ConfigureAwait(false);
+                                        await _gatewayLogger.DebugAsync("Received Dispatch (GUILD_CREATE)").ConfigureAwait(false);
 
                                         var guild = AddGuild(data, State);
                                         if (guild != null)
@@ -614,7 +614,7 @@ namespace Discord.WebSocket
                                     if (data.Unavailable == true)
                                     {
                                         type = "GUILD_UNAVAILABLE";
-                                        await _gatewayLogger.DebugAsync($"Received Dispatch (GUILD_UNAVAILABLE)").ConfigureAwait(false);
+                                        await _gatewayLogger.DebugAsync("Received Dispatch (GUILD_UNAVAILABLE)").ConfigureAwait(false);
 
                                         var guild = State.GetGuild(data.Id);
                                         if (guild != null)
@@ -630,7 +630,7 @@ namespace Discord.WebSocket
                                     }
                                     else
                                     {
-                                        await _gatewayLogger.DebugAsync($"Received Dispatch (GUILD_DELETE)").ConfigureAwait(false);
+                                        await _gatewayLogger.DebugAsync("Received Dispatch (GUILD_DELETE)").ConfigureAwait(false);
 
                                         var guild = RemoveGuild(data.Id);
                                         if (guild != null)
@@ -1626,7 +1626,7 @@ namespace Discord.WebSocket
             var guild = State.RemoveGuild(id);
             if (guild != null)
             {
-                foreach (var channel in guild.Channels)
+                foreach (var _ in guild.Channels)
                     State.RemoveChannel(id);
                 foreach (var user in guild.Users)
                     user.GlobalUser.RemoveRef(this);
@@ -1679,7 +1679,7 @@ namespace Discord.WebSocket
             if (eventHandler.HasSubscribers)
             {
                 if (HandlerTimeout.HasValue)
-                    await TimeoutWrap(name, () => eventHandler.InvokeAsync()).ConfigureAwait(false);
+                    await TimeoutWrap(name, eventHandler.InvokeAsync).ConfigureAwait(false);
                 else
                     await eventHandler.InvokeAsync().ConfigureAwait(false);
             }
diff --git a/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs b/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
index 0eb92caed..80dec0fd4 100644
--- a/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
@@ -39,8 +39,8 @@ namespace Discord.Audio
         
         private readonly JsonSerializer _serializer;
         private readonly SemaphoreSlim _connectionLock;
+        private readonly IUdpSocket _udp;
         private CancellationTokenSource _connectCancelToken;
-        private IUdpSocket _udp;
         private bool _isDisposed;
         private ulong _nextKeepalive;
 
@@ -188,7 +188,7 @@ namespace Discord.Audio
 
                 ConnectionState = ConnectionState.Connected;
             }
-            catch (Exception)
+            catch
             {
                 await DisconnectInternalAsync().ConfigureAwait(false);
                 throw;
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
index 11b7ce25a..9a8be9703 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
@@ -97,7 +97,7 @@ namespace Discord.WebSocket
             if (id == Recipient.Id)
                 return Recipient;
             else if (id == Discord.CurrentUser.Id)
-                return Discord.CurrentUser as SocketSelfUser;
+                return Discord.CurrentUser;
             else
                 return null;
         }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
index 125625456..74a1e3725 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
@@ -18,10 +18,10 @@ namespace Discord.WebSocket
     public class SocketGroupChannel : SocketChannel, IGroupChannel, ISocketPrivateChannel, ISocketMessageChannel, ISocketAudioChannel
     {
         private readonly MessageCache _messages;
+        private readonly ConcurrentDictionary<ulong, SocketVoiceState> _voiceStates;
 
         private string _iconId;
         private ConcurrentDictionary<ulong, SocketGroupUser> _users;
-        private ConcurrentDictionary<ulong, SocketVoiceState> _voiceStates;
 
         public string Name { get; private set; }
 
@@ -129,7 +129,7 @@ namespace Discord.WebSocket
         internal SocketGroupUser GetOrAddUser(UserModel model)
         {
             if (_users.TryGetValue(model.Id, out SocketGroupUser user))
-                return user as SocketGroupUser;
+                return user;
             else
             {
                 var privateUser = SocketGroupUser.Create(this, Discord.State, model);
@@ -143,7 +143,7 @@ namespace Discord.WebSocket
             if (_users.TryRemove(id, out SocketGroupUser user))
             {
                 user.GlobalUser.RemoveRef(Discord);
-                return user as SocketGroupUser;
+                return user;
             }
             return null;
         }
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index bf33ef569..78ea4004a 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -91,11 +91,11 @@ namespace Discord.WebSocket
             }
         }
         public IReadOnlyCollection<SocketTextChannel> TextChannels
-            => Channels.Select(x => x as SocketTextChannel).Where(x => x != null).ToImmutableArray();
+            => Channels.OfType<SocketTextChannel>().ToImmutableArray();
         public IReadOnlyCollection<SocketVoiceChannel> VoiceChannels
-            => Channels.Select(x => x as SocketVoiceChannel).Where(x => x != null).ToImmutableArray();
+            => Channels.OfType<SocketVoiceChannel>().ToImmutableArray();
         public IReadOnlyCollection<SocketCategoryChannel> CategoryChannels
-            => Channels.Select(x => x as SocketCategoryChannel).Where(x => x != null).ToImmutableArray();
+            => Channels.OfType<SocketCategoryChannel>().ToImmutableArray();
         public SocketGuildUser CurrentUser => _members.TryGetValue(Discord.CurrentUser.Id, out SocketGuildUser member) ? member : null;
         public SocketRole EveryoneRole => GetRole(Id);
         public IReadOnlyCollection<SocketGuildChannel> Channels
@@ -563,7 +563,7 @@ namespace Discord.WebSocket
 
                 await Discord.ApiClient.SendVoiceStateUpdateAsync(Id, channelId, selfDeaf, selfMute).ConfigureAwait(false);
             }
-            catch (Exception)
+            catch
             {
                 await DisconnectAudioInternalAsync().ConfigureAwait(false);
                 throw;
@@ -580,7 +580,7 @@ namespace Discord.WebSocket
                     throw new TimeoutException();
                 return await promise.Task.ConfigureAwait(false);
             }
-            catch (Exception)
+            catch
             {
                 await DisconnectAudioAsync().ConfigureAwait(false);
                 throw;
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs b/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
index c2cad4d86..6ebd0fa1c 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -28,7 +28,7 @@ namespace Discord.WebSocket
                 _orderedMessages.Enqueue(message.Id);
 
                 while (_orderedMessages.Count > _size && _orderedMessages.TryDequeue(out ulong msgId))
-                    _messages.TryRemove(msgId, out SocketMessage msg);
+                    _messages.TryRemove(msgId, out _);
             }
         }
 
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
index f8c15a986..bf817e008 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
@@ -12,12 +12,12 @@ namespace Discord.WebSocket
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketUserMessage : SocketMessage, IUserMessage
     {
+        private readonly List<SocketReaction> _reactions = new List<SocketReaction>();
         private bool _isMentioningEveryone, _isTTS, _isPinned;
         private long? _editedTimestampTicks;
         private ImmutableArray<Attachment> _attachments;
         private ImmutableArray<Embed> _embeds;
         private ImmutableArray<ITag> _tags;
-        private List<SocketReaction> _reactions = new List<SocketReaction>();
         
         public override bool IsTTS => _isTTS;
         public override bool IsPinned => _isPinned;
diff --git a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
index c60368da0..dc5201ac1 100644
--- a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
+++ b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
@@ -22,8 +22,8 @@ namespace Discord.Net.WebSockets
 
         private readonly SemaphoreSlim _lock;
         private readonly Dictionary<string, string> _headers;
+        private readonly IWebProxy _proxy;
         private ClientWebSocket _client;
-        private IWebProxy _proxy;
         private Task _task;
         private CancellationTokenSource _cancelTokenSource;
         private CancellationToken _cancelToken, _parentToken;

From 272604f27578dba67de8039e4e88901a26299883 Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Thu, 30 Aug 2018 17:38:44 -0400
Subject: [PATCH 09/59] Make voice connection properties optional. (#1129)

---
 .../Entities/Channels/SocketVoiceChannel.cs                     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
index f967e6e6a..8e6e09a9f 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
@@ -43,7 +43,7 @@ namespace Discord.WebSocket
         public Task ModifyAsync(Action<VoiceChannelProperties> func, RequestOptions options = null)
             => ChannelHelper.ModifyAsync(this, Discord, func, options);
 
-        public async Task<IAudioClient> ConnectAsync(bool selfDeaf, bool selfMute, bool external)
+        public async Task<IAudioClient> ConnectAsync(bool selfDeaf = false, bool selfMute = false, bool external = false)
         {
             return await Guild.ConnectAudioAsync(Id, selfDeaf, selfMute, external).ConfigureAwait(false);
         }

From 9e9a11d4b09362aadac6d32be0ac83fdddc5e19e Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Thu, 6 Sep 2018 19:08:45 -0700
Subject: [PATCH 10/59] Fix swapped parameters in ArgumentException,
 ArgumentNullException cstrs (#1139)

* Fix swapped parameters in ArgumentException and ArgumentNullException cstrs

The constructors of ArgumentException and ArgumentNullException are inconsistent with each other, which results in their parameters being swapped here and there.

* Use named parameters for ArgumentException constructors

Cleans up some of the methods of EmbedBuilder to use simpler syntax as well
---
 src/Discord.Net.Core/Entities/Emotes/Emote.cs |  4 +-
 .../Entities/Messages/EmbedBuilder.cs         | 34 ++++++++---------
 .../Permissions/ChannelPermissions.cs         |  2 +-
 .../Utils/ConcurrentHashSet.cs                | 24 ++++++------
 src/Discord.Net.Core/Utils/MentionUtils.cs    |  6 +--
 src/Discord.Net.Core/Utils/Preconditions.cs   | 38 +++++--------------
 src/Discord.Net.Core/Utils/TokenUtils.cs      |  6 +--
 src/Discord.Net.Rest/DiscordRestApiClient.cs  |  6 +--
 .../Entities/Guilds/GuildHelper.cs            | 10 ++---
 9 files changed, 56 insertions(+), 74 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Emotes/Emote.cs b/src/Discord.Net.Core/Entities/Emotes/Emote.cs
index e3a228c83..a71a73327 100644
--- a/src/Discord.Net.Core/Entities/Emotes/Emote.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/Emote.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Globalization;
 
 namespace Discord
@@ -58,7 +58,7 @@ namespace Discord
         {
             if (TryParse(text, out Emote result))
                 return result;
-            throw new ArgumentException("Invalid emote format", nameof(text));
+            throw new ArgumentException(message: "Invalid emote format", paramName: nameof(text));
         }
 
         public static bool TryParse(string text, out Emote result)
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
index 7e288ef6b..82e94e39f 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
@@ -29,7 +29,7 @@ namespace Discord
             get => _title;
             set
             {
-                if (value?.Length > MaxTitleLength) throw new ArgumentException($"Title length must be less than or equal to {MaxTitleLength}.", nameof(Title));
+                if (value?.Length > MaxTitleLength) throw new ArgumentException(message: $"Title length must be less than or equal to {MaxTitleLength}.", paramName: nameof(Title));
                 _title = value;
             }
         }
@@ -38,7 +38,7 @@ namespace Discord
             get => _description;
             set
             {
-                if (value?.Length > MaxDescriptionLength) throw new ArgumentException($"Description length must be less than or equal to {MaxDescriptionLength}.", nameof(Description));
+                if (value?.Length > MaxDescriptionLength) throw new ArgumentException(message: $"Description length must be less than or equal to {MaxDescriptionLength}.", paramName: nameof(Description));
                 _description = value;
             }
         }
@@ -48,7 +48,7 @@ namespace Discord
             get => _url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(Url));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(Url));
                 _url = value;
             }
         }
@@ -57,7 +57,7 @@ namespace Discord
             get => _thumbnail?.Url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(ThumbnailUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(ThumbnailUrl));
                 _thumbnail = new EmbedThumbnail(value, null, null, null);
             }
         }
@@ -66,7 +66,7 @@ namespace Discord
             get => _image?.Url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(ImageUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(ImageUrl));
                 _image = new EmbedImage(value, null, null, null);
             }
         }
@@ -75,8 +75,8 @@ namespace Discord
             get => _fields;
             set
             {
-                if (value == null) throw new ArgumentNullException("Cannot set an embed builder's fields collection to null", nameof(Fields));
-                if (value.Count > MaxFieldCount) throw new ArgumentException($"Field count must be less than or equal to {MaxFieldCount}.", nameof(Fields));
+                if (value == null) throw new ArgumentNullException(paramName: nameof(Fields), message: "Cannot set an embed builder's fields collection to null");
+                if (value.Count > MaxFieldCount) throw new ArgumentException(message: $"Field count must be less than or equal to {MaxFieldCount}.", paramName: nameof(Fields));
                 _fields = value;
             }
         }
@@ -200,7 +200,7 @@ namespace Discord
         {
             if (Fields.Count >= MaxFieldCount)
             {
-                throw new ArgumentException($"Field count must be less than or equal to {MaxFieldCount}.", nameof(field));
+                throw new ArgumentException(message: $"Field count must be less than or equal to {MaxFieldCount}.", paramName: nameof(field));
             }
 
             Fields.Add(field);
@@ -239,8 +239,8 @@ namespace Discord
             get => _name;
             set
             {
-                if (string.IsNullOrWhiteSpace(value)) throw new ArgumentException("Field name must not be null, empty or entirely whitespace.", nameof(Name));
-                if (value.Length > MaxFieldNameLength) throw new ArgumentException($"Field name length must be less than or equal to {MaxFieldNameLength}.", nameof(Name));
+                if (string.IsNullOrWhiteSpace(value)) throw new ArgumentException(message: "Field name must not be null, empty or entirely whitespace.", paramName: nameof(Name));
+                if (value.Length > MaxFieldNameLength) throw new ArgumentException(message: $"Field name length must be less than or equal to {MaxFieldNameLength}.", paramName: nameof(Name));
                 _name = value;
             }
         }
@@ -251,8 +251,8 @@ namespace Discord
             set
             {
                 var stringValue = value?.ToString();
-                if (string.IsNullOrEmpty(stringValue)) throw new ArgumentException("Field value must not be null or empty.", nameof(Value));
-                if (stringValue.Length > MaxFieldValueLength) throw new ArgumentException($"Field value length must be less than or equal to {MaxFieldValueLength}.", nameof(Value));
+                if (string.IsNullOrEmpty(stringValue)) throw new ArgumentException(message: "Field value must not be null or empty.", paramName: nameof(Value));
+                if (stringValue.Length > MaxFieldValueLength) throw new ArgumentException(message: $"Field value length must be less than or equal to {MaxFieldValueLength}.", paramName: nameof(Value));
                 _value = stringValue;
             }
         }
@@ -290,7 +290,7 @@ namespace Discord
             get => _name;
             set
             {
-                if (value?.Length > MaxAuthorNameLength) throw new ArgumentException($"Author name length must be less than or equal to {MaxAuthorNameLength}.", nameof(Name));
+                if (value?.Length > MaxAuthorNameLength) throw new ArgumentException(message: $"Author name length must be less than or equal to {MaxAuthorNameLength}.", paramName: nameof(Name));
                 _name = value;
             }
         }
@@ -299,7 +299,7 @@ namespace Discord
             get => _url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(Url));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(Url));
                 _url = value;
             }
         }
@@ -308,7 +308,7 @@ namespace Discord
             get => _iconUrl;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(IconUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(IconUrl));
                 _iconUrl = value;
             }
         }
@@ -345,7 +345,7 @@ namespace Discord
             get => _text;
             set
             {
-                if (value?.Length > MaxFooterTextLength) throw new ArgumentException($"Footer text length must be less than or equal to {MaxFooterTextLength}.", nameof(Text));
+                if (value?.Length > MaxFooterTextLength) throw new ArgumentException(message: $"Footer text length must be less than or equal to {MaxFooterTextLength}.", paramName: nameof(Text));
                 _text = value;
             }
         }
@@ -354,7 +354,7 @@ namespace Discord
             get => _iconUrl;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException("Url must be a well-formed URI", nameof(IconUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(IconUrl));
                 _iconUrl = value;
             }
         }
diff --git a/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs b/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
index 61d588f8a..ea56734ff 100644
--- a/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
@@ -29,7 +29,7 @@ namespace Discord
                 case ICategoryChannel _: return Category;
                 case IDMChannel _: return DM;
                 case IGroupChannel _: return Group;
-                default: throw new ArgumentException("Unknown channel type", nameof(channel));
+                default: throw new ArgumentException(message: "Unknown channel type", paramName: nameof(channel));
             }
         }
 
diff --git a/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs b/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
index 1fc11587e..e9edfb772 100644
--- a/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
+++ b/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
@@ -160,23 +160,23 @@ namespace Discord
         public ConcurrentHashSet(IEnumerable<T> collection, IEqualityComparer<T> comparer) 
             : this(comparer)
         {
-            if (collection == null) throw new ArgumentNullException(nameof(collection));
+            if (collection == null) throw new ArgumentNullException(paramName: nameof(collection));
             InitializeFromCollection(collection);
         }
         public ConcurrentHashSet(int concurrencyLevel, IEnumerable<T> collection, IEqualityComparer<T> comparer)
             : this(concurrencyLevel, DefaultCapacity, false, comparer)
         {
-            if (collection == null) throw new ArgumentNullException(nameof(collection));
-            if (comparer == null) throw new ArgumentNullException(nameof(comparer));
+            if (collection == null) throw new ArgumentNullException(paramName: nameof(collection));
+            if (comparer == null) throw new ArgumentNullException(paramName: nameof(comparer));
             InitializeFromCollection(collection);
         }        
         public ConcurrentHashSet(int concurrencyLevel, int capacity, IEqualityComparer<T> comparer)
             : this(concurrencyLevel, capacity, false, comparer) { }
         internal ConcurrentHashSet(int concurrencyLevel, int capacity, bool growLockArray, IEqualityComparer<T> comparer)
         {
-            if (concurrencyLevel < 1) throw new ArgumentOutOfRangeException(nameof(concurrencyLevel));
-            if (capacity < 0) throw new ArgumentOutOfRangeException(nameof(capacity));
-            if (comparer == null) throw new ArgumentNullException(nameof(comparer));
+            if (concurrencyLevel < 1) throw new ArgumentOutOfRangeException(paramName: nameof(concurrencyLevel));
+            if (capacity < 0) throw new ArgumentOutOfRangeException(paramName: nameof(capacity));
+            if (comparer == null) throw new ArgumentNullException(paramName: nameof(comparer));
                         
             if (capacity < concurrencyLevel)
                 capacity = concurrencyLevel;
@@ -197,7 +197,7 @@ namespace Discord
         {
             foreach (var value in collection)
             {
-                if (value == null) throw new ArgumentNullException("key");
+                if (value == null) throw new ArgumentNullException(paramName: "key");
 
                 if (!TryAddInternal(value, _comparer.GetHashCode(value), false))
                     throw new ArgumentException();
@@ -209,7 +209,7 @@ namespace Discord
         
         public bool ContainsKey(T value)
         {
-            if (value == null) throw new ArgumentNullException("key");
+            if (value == null) throw new ArgumentNullException(paramName: "key");
             return ContainsKeyInternal(value, _comparer.GetHashCode(value));
         }
         private bool ContainsKeyInternal(T value, int hashcode)
@@ -232,7 +232,7 @@ namespace Discord
 
         public bool TryAdd(T value)
         {
-            if (value == null)  throw new ArgumentNullException("key");
+            if (value == null) throw new ArgumentNullException(paramName: "key");
             return TryAddInternal(value, _comparer.GetHashCode(value), true);
         }
         private bool TryAddInternal(T value, int hashcode, bool acquireLock)
@@ -281,7 +281,7 @@ namespace Discord
 
         public bool TryRemove(T value)
         {
-            if (value == null) throw new ArgumentNullException("key");
+            if (value == null) throw new ArgumentNullException(paramName: "key");
             return TryRemoveInternal(value);
         }        
         private bool TryRemoveInternal(T value)
@@ -467,4 +467,4 @@ namespace Discord
                 Monitor.Exit(_tables._locks[i]);
         }                
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Utils/MentionUtils.cs b/src/Discord.Net.Core/Utils/MentionUtils.cs
index f2afe497a..a081b5a5a 100644
--- a/src/Discord.Net.Core/Utils/MentionUtils.cs
+++ b/src/Discord.Net.Core/Utils/MentionUtils.cs
@@ -21,7 +21,7 @@ namespace Discord
         {
             if (TryParseUser(text, out ulong id))
                 return id;
-            throw new ArgumentException("Invalid mention format", nameof(text));
+            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
         }
         /// <summary> Tries to parse a provided user mention string. </summary>
         public static bool TryParseUser(string text, out ulong userId)
@@ -45,7 +45,7 @@ namespace Discord
         {
             if (TryParseChannel(text, out ulong id))
                 return id;
-            throw new ArgumentException("Invalid mention format", nameof(text));
+            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
         }
         /// <summary>Tries to parse a provided channel mention string. </summary>
         public static bool TryParseChannel(string text, out ulong channelId)
@@ -66,7 +66,7 @@ namespace Discord
         {
             if (TryParseRole(text, out ulong id))
                 return id;
-            throw new ArgumentException("Invalid mention format", nameof(text));
+            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
         }
         /// <summary>Tries to parse a provided role mention string. </summary>
         public static bool TryParseRole(string text, out ulong roleId)
diff --git a/src/Discord.Net.Core/Utils/Preconditions.cs b/src/Discord.Net.Core/Utils/Preconditions.cs
index 1a297a6a1..6cbf4a173 100644
--- a/src/Discord.Net.Core/Utils/Preconditions.cs
+++ b/src/Discord.Net.Core/Utils/Preconditions.cs
@@ -10,8 +10,8 @@ namespace Discord
 
         private static ArgumentNullException CreateNotNullException(string name, string msg)
         {
-            if (msg == null) return new ArgumentNullException(name);
-            else return new ArgumentNullException(name, msg);
+            if (msg == null) return new ArgumentNullException(paramName: name);
+            else return new ArgumentNullException(paramName: name, message: msg);
         }
 
         //Strings
@@ -45,10 +45,7 @@ namespace Discord
         }        
 
         private static ArgumentException CreateNotEmptyException(string name, string msg)
-        {
-            if (msg == null) return new ArgumentException("Argument cannot be blank", name);
-            else return new ArgumentException(name, msg);
-        }
+            => new ArgumentException(message: msg ?? "Argument cannot be blank.", paramName: name);
 
         //Numerics
         public static void NotEqual(sbyte obj, sbyte value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }
@@ -85,11 +82,8 @@ namespace Discord
         public static void NotEqual(Optional<ulong?> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }
 
         private static ArgumentException CreateNotEqualException<T>(string name, string msg, T value)
-        {
-            if (msg == null) return new ArgumentException($"Value may not be equal to {value}", name);
-            else return new ArgumentException(msg, name);
-        }
-
+            => new ArgumentException(message: msg ?? $"Value may not be equal to {value}", paramName: name);
+        
         public static void AtLeast(sbyte obj, sbyte value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }
         public static void AtLeast(byte obj, byte value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }
         public static void AtLeast(short obj, short value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }
@@ -108,10 +102,7 @@ namespace Discord
         public static void AtLeast(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }
 
         private static ArgumentException CreateAtLeastException<T>(string name, string msg, T value)
-        {
-            if (msg == null) return new ArgumentException($"Value must be at least {value}", name);
-            else return new ArgumentException(msg, name);
-        }
+            => new ArgumentException(message: msg ?? $"Value must be at least {value}", paramName: name);
 
         public static void GreaterThan(sbyte obj, sbyte value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }
         public static void GreaterThan(byte obj, byte value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }
@@ -131,10 +122,7 @@ namespace Discord
         public static void GreaterThan(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }
 
         private static ArgumentException CreateGreaterThanException<T>(string name, string msg, T value)
-        {
-            if (msg == null) return new ArgumentException($"Value must be greater than {value}", name);
-            else return new ArgumentException(msg, name);
-        }
+            => new ArgumentException(message: msg ?? $"Value must be greater than {value}", paramName: name);
 
         public static void AtMost(sbyte obj, sbyte value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }
         public static void AtMost(byte obj, byte value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }
@@ -154,10 +142,7 @@ namespace Discord
         public static void AtMost(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }
 
         private static ArgumentException CreateAtMostException<T>(string name, string msg, T value)
-        {
-            if (msg == null) return new ArgumentException($"Value must be at most {value}", name);
-            else return new ArgumentException(msg, name);
-        }
+            => new ArgumentException(message: msg ?? $"Value must be at most {value}", paramName: name);
 
         public static void LessThan(sbyte obj, sbyte value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }
         public static void LessThan(byte obj, byte value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }
@@ -177,10 +162,7 @@ namespace Discord
         public static void LessThan(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }
 
         private static ArgumentException CreateLessThanException<T>(string name, string msg, T value)
-        {
-            if (msg == null) return new ArgumentException($"Value must be less than {value}", name);
-            else return new ArgumentException(msg, name);
-        }
+            => new ArgumentException(message: msg ?? $"Value must be less than {value}", paramName: name);
 
         // Bulk Delete
         public static void YoungerThanTwoWeeks(ulong[] collection, string name)
@@ -198,7 +180,7 @@ namespace Discord
             for (var i = 0; i < roles.Length; i++)
             {
                 if (roles[i] == guildId)
-                    throw new ArgumentException("The everyone role cannot be assigned to a user", name);
+                    throw new ArgumentException(message: "The everyone role cannot be assigned to a user", paramName: name);
             }
         }
     }
diff --git a/src/Discord.Net.Core/Utils/TokenUtils.cs b/src/Discord.Net.Core/Utils/TokenUtils.cs
index 2cc0f1041..6decdc52f 100644
--- a/src/Discord.Net.Core/Utils/TokenUtils.cs
+++ b/src/Discord.Net.Core/Utils/TokenUtils.cs
@@ -19,7 +19,7 @@ namespace Discord
         {
             // A Null or WhiteSpace token of any type is invalid.
             if (string.IsNullOrWhiteSpace(token))
-                throw new ArgumentNullException("A token cannot be null, empty, or contain only whitespace.", nameof(token));
+                throw new ArgumentNullException(paramName: nameof(token), message: "A token cannot be null, empty, or contain only whitespace.");
 
             switch (tokenType)
             {
@@ -34,11 +34,11 @@ namespace Discord
                     // this value was determined by referencing examples in the discord documentation, and by comparing with
                     // pre-existing tokens
                     if (token.Length < 59)
-                        throw new ArgumentException("A Bot token must be at least 59 characters in length.", nameof(token));
+                        throw new ArgumentException(message: "A Bot token must be at least 59 characters in length.", paramName: nameof(token));
                     break;
                 default:
                     // All unrecognized TokenTypes (including User tokens) are considered to be invalid.
-                    throw new ArgumentException("Unrecognized TokenType.", nameof(token));
+                    throw new ArgumentException(message: "Unrecognized TokenType.", paramName: nameof(token));
             }
         }
 
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index f8e3e6f50..02529310f 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -78,7 +78,7 @@ namespace Discord.API
                 case TokenType.Bearer:
                     return $"Bearer {token}";
                 default:
-                    throw new ArgumentException("Unknown OAuth token type", nameof(tokenType));
+                    throw new ArgumentException(message: "Unknown OAuth token type", paramName: nameof(tokenType));
             }
         }
         internal virtual void Dispose(bool disposing)
@@ -473,7 +473,7 @@ namespace Discord.API
                 Preconditions.NotNullOrEmpty(args.Content, nameof(args.Content));
 
             if (args.Content?.Length > DiscordConfig.MaxMessageSize)
-                throw new ArgumentException($"Message content is too long, length must be less or equal to {DiscordConfig.MaxMessageSize}.", nameof(args.Content));
+                throw new ArgumentException(message: $"Message content is too long, length must be less or equal to {DiscordConfig.MaxMessageSize}.", paramName: nameof(args.Content));
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(channelId: channelId);
@@ -490,7 +490,7 @@ namespace Discord.API
                 Preconditions.NotNullOrEmpty(args.Content, nameof(args.Content));
 
             if (args.Content?.Length > DiscordConfig.MaxMessageSize)
-                throw new ArgumentException($"Message content is too long, length must be less or equal to {DiscordConfig.MaxMessageSize}.", nameof(args.Content));
+                throw new ArgumentException(message: $"Message content is too long, length must be less or equal to {DiscordConfig.MaxMessageSize}.", paramName: nameof(args.Content));
             options = RequestOptions.CreateOrClone(options);
 
             return await SendJsonAsync<Message>("POST", () => $"webhooks/{webhookId}/{AuthToken}?wait=true", args, new BucketIds(), clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index 4bd0e9972..3b2935149 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -147,7 +147,7 @@ namespace Discord.Rest
         public static async Task<RestTextChannel> CreateTextChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options, Action<TextChannelProperties> func = null)
         {
-            if (name == null) throw new ArgumentNullException(nameof(name));
+            if (name == null) throw new ArgumentNullException(paramName: nameof(name));
 
             var props = new TextChannelProperties();
             func?.Invoke(props);
@@ -164,7 +164,7 @@ namespace Discord.Rest
         public static async Task<RestVoiceChannel> CreateVoiceChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options, Action<VoiceChannelProperties> func = null)
         {
-            if (name == null) throw new ArgumentNullException(nameof(name));
+            if (name == null) throw new ArgumentNullException(paramName: nameof(name));
 
             var props = new VoiceChannelProperties();
             func?.Invoke(props);
@@ -181,7 +181,7 @@ namespace Discord.Rest
         public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options)
         {
-            if (name == null) throw new ArgumentNullException(nameof(name));
+            if (name == null) throw new ArgumentNullException(paramName: nameof(name));
 
             var args = new CreateGuildChannelParams(name, ChannelType.Category);
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
@@ -221,7 +221,7 @@ namespace Discord.Rest
         public static async Task<RestRole> CreateRoleAsync(IGuild guild, BaseDiscordClient client,
             string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options)
         {
-            if (name == null) throw new ArgumentNullException(nameof(name));
+            if (name == null) throw new ArgumentNullException(paramName: nameof(name));
 
             var model = await client.ApiClient.CreateGuildRoleAsync(guild.Id, options).ConfigureAwait(false);
             var role = RestRole.Create(client, guild, model);
@@ -356,7 +356,7 @@ namespace Discord.Rest
         public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, 
             RequestOptions options)
         {
-            if (func == null) throw new ArgumentNullException(nameof(func));
+            if (func == null) throw new ArgumentNullException(paramName: nameof(func));
 
             var props = new EmoteProperties();
             func(props);

From 97d17cfdda22a04173b63247c646acc7cd1122a7 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Tue, 11 Sep 2018 18:21:22 -0400
Subject: [PATCH 11/59] api: add slow mode

This adds the following property to ITextChannel
- SlowMode (int)

The SlowMode field defines the time in seconds users must wait between
sending messages; if zero, slow-mode is disabled.

Bots are not affected by slow-mode, and as such, no changes need to be
made to the REST client's internal ratelimiting. This is strictly a
read/write cosmetic property for bots.
---
 .../Entities/Channels/ITextChannel.cs              |  3 +++
 .../Entities/Channels/TextChannelProperties.cs     | 14 +++++++++++++-
 src/Discord.Net.Rest/API/Common/Channel.cs         |  4 +++-
 .../API/Rest/ModifyTextChannelParams.cs            |  4 +++-
 src/Discord.Net.Rest/DiscordRestApiClient.cs       |  2 ++
 .../Entities/Channels/ChannelHelper.cs             |  3 ++-
 .../Entities/Channels/RestTextChannel.cs           |  2 ++
 .../Entities/Channels/SocketTextChannel.cs         |  2 ++
 8 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
index 2aa070b03..e9350601d 100644
--- a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
@@ -13,6 +13,9 @@ namespace Discord
         /// <summary> Gets the current topic for this text channel. </summary>
         string Topic { get; }
 
+        ///<summary> Gets the current slow-mode delay for this channel. 0 if disabled. </summary>
+        int SlowMode { get; }
+
         /// <summary> Bulk deletes multiple messages. </summary>
         Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null);
         /// <summary> Bulk deletes multiple messages. </summary>
diff --git a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
index b7b568133..e3c0557dd 100644
--- a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
@@ -1,4 +1,6 @@
-namespace Discord
+using System;
+
+namespace Discord
 {
     /// <inheritdoc />
     public class TextChannelProperties : GuildChannelProperties
@@ -11,5 +13,15 @@
         /// Should this channel be flagged as NSFW?
         /// </summary>
         public Optional<bool> IsNsfw { get; set; }
+        /// <summary>
+        /// What the slow-mode ratelimit for this channel should be set to; 0 will disable slow-mode.
+        /// </summary>
+        /// <remarks>
+        /// This value must fall within [0, 120]
+        /// 
+        /// Users with <see cref="ChannelPermission.ManageMessages"/> will be exempt from slow-mode.
+        /// </remarks>
+        /// <exception cref="ArgumentOutOfRangeException">Throws ArgummentOutOfRange if the value does not fall within [0, 120]</exception>
+        public Optional<int> SlowMode { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/API/Common/Channel.cs b/src/Discord.Net.Rest/API/Common/Channel.cs
index 97c35a57b..57a5ce9ab 100644
--- a/src/Discord.Net.Rest/API/Common/Channel.cs
+++ b/src/Discord.Net.Rest/API/Common/Channel.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 using System;
 
@@ -33,6 +33,8 @@ namespace Discord.API
         public Optional<DateTimeOffset?> LastPinTimestamp { get; set; }
         [JsonProperty("nsfw")]
         public Optional<bool> Nsfw { get; set; }
+        [JsonProperty("rate_limit_per_user")]
+        public Optional<int> SlowMode { get; set; }
 
         //VoiceChannel
         [JsonProperty("bitrate")]
diff --git a/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs b/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
index 9cabc67c1..7cb1405c9 100644
--- a/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API.Rest
@@ -10,5 +10,7 @@ namespace Discord.API.Rest
         public Optional<string> Topic { get; set; }
         [JsonProperty("nsfw")]
         public Optional<bool> IsNsfw { get; set; }
+        [JsonProperty("rate_limit_per_user")]
+        public Optional<int> SlowMode { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 02529310f..f7e86a8f3 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -356,6 +356,8 @@ namespace Discord.API
             Preconditions.NotNull(args, nameof(args));
             Preconditions.AtLeast(args.Position, 0, nameof(args.Position));
             Preconditions.NotNullOrEmpty(args.Name, nameof(args.Name));
+            Preconditions.AtLeast(args.SlowMode, 0, nameof(args.SlowMode));
+            Preconditions.AtMost(args.SlowMode, 120, nameof(args.SlowMode));
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(channelId: channelId);
diff --git a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
index 50cb352a7..47f82f612 100644
--- a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
@@ -45,7 +45,8 @@ namespace Discord.Rest
                 Position = args.Position,
                 CategoryId = args.CategoryId,
                 Topic = args.Topic,
-                IsNsfw = args.IsNsfw
+                IsNsfw = args.IsNsfw,
+                SlowMode = args.SlowMode,
             };
             return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false);
         }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
index 7f57c96ff..8fe17ba2f 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
@@ -12,6 +12,7 @@ namespace Discord.Rest
     public class RestTextChannel : RestGuildChannel, IRestMessageChannel, ITextChannel
     {
         public string Topic { get; private set; }
+        public int SlowMode { get; private set; } 
         public ulong? CategoryId { get; private set; }
 
         public string Mention => MentionUtils.MentionChannel(Id);
@@ -34,6 +35,7 @@ namespace Discord.Rest
             base.Update(model);
             CategoryId = model.CategoryId;
             Topic = model.Topic.Value;
+            SlowMode = model.SlowMode.Value;
             _nsfw = model.Nsfw.GetValueOrDefault();
         }
 
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
index e41c2ba94..d6982bf6a 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
@@ -16,6 +16,7 @@ namespace Discord.WebSocket
         private readonly MessageCache _messages;
 
         public string Topic { get; private set; }
+        public int SlowMode { get; private set; }
         public ulong? CategoryId { get; private set; }
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
@@ -47,6 +48,7 @@ namespace Discord.WebSocket
             base.Update(state, model);
             CategoryId = model.CategoryId;
             Topic = model.Topic.Value;
+            SlowMode = model.SlowMode.GetValueOrDefault(); // some guilds haven't been patched to include this yet?
             _nsfw = model.Nsfw.GetValueOrDefault();
         }
 

From 232f525b59e801332ec9dca755366944c79afa1d Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Tue, 11 Sep 2018 18:28:31 -0400
Subject: [PATCH 12/59] lint: refactor SlowMode -> SlowModeInterval

this was the name change i always wanted
---
 src/Discord.Net.Core/Entities/Channels/ITextChannel.cs        | 2 +-
 .../Entities/Channels/TextChannelProperties.cs                | 2 +-
 src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs      | 2 +-
 src/Discord.Net.Rest/DiscordRestApiClient.cs                  | 4 ++--
 src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs       | 2 +-
 src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs     | 4 ++--
 src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs           | 2 +-
 .../Entities/Channels/SocketTextChannel.cs                    | 4 ++--
 8 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
index e9350601d..89e10e65e 100644
--- a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
@@ -14,7 +14,7 @@ namespace Discord
         string Topic { get; }
 
         ///<summary> Gets the current slow-mode delay for this channel. 0 if disabled. </summary>
-        int SlowMode { get; }
+        int SlowModeInterval { get; }
 
         /// <summary> Bulk deletes multiple messages. </summary>
         Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null);
diff --git a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
index e3c0557dd..87adccb85 100644
--- a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
@@ -22,6 +22,6 @@ namespace Discord
         /// Users with <see cref="ChannelPermission.ManageMessages"/> will be exempt from slow-mode.
         /// </remarks>
         /// <exception cref="ArgumentOutOfRangeException">Throws ArgummentOutOfRange if the value does not fall within [0, 120]</exception>
-        public Optional<int> SlowMode { get; set; }
+        public Optional<int> SlowModeInterval { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs b/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
index 7cb1405c9..94f149fc1 100644
--- a/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/ModifyTextChannelParams.cs
@@ -11,6 +11,6 @@ namespace Discord.API.Rest
         [JsonProperty("nsfw")]
         public Optional<bool> IsNsfw { get; set; }
         [JsonProperty("rate_limit_per_user")]
-        public Optional<int> SlowMode { get; set; }
+        public Optional<int> SlowModeInterval { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index f7e86a8f3..35fa0e989 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -356,8 +356,8 @@ namespace Discord.API
             Preconditions.NotNull(args, nameof(args));
             Preconditions.AtLeast(args.Position, 0, nameof(args.Position));
             Preconditions.NotNullOrEmpty(args.Name, nameof(args.Name));
-            Preconditions.AtLeast(args.SlowMode, 0, nameof(args.SlowMode));
-            Preconditions.AtMost(args.SlowMode, 120, nameof(args.SlowMode));
+            Preconditions.AtLeast(args.SlowModeInterval, 0, nameof(args.SlowModeInterval));
+            Preconditions.AtMost(args.SlowModeInterval, 120, nameof(args.SlowModeInterval));
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(channelId: channelId);
diff --git a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
index 47f82f612..74ce7870f 100644
--- a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
@@ -46,7 +46,7 @@ namespace Discord.Rest
                 CategoryId = args.CategoryId,
                 Topic = args.Topic,
                 IsNsfw = args.IsNsfw,
-                SlowMode = args.SlowMode,
+                SlowModeInterval = args.SlowModeInterval,
             };
             return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false);
         }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
index 8fe17ba2f..12437c969 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
@@ -12,7 +12,7 @@ namespace Discord.Rest
     public class RestTextChannel : RestGuildChannel, IRestMessageChannel, ITextChannel
     {
         public string Topic { get; private set; }
-        public int SlowMode { get; private set; } 
+        public int SlowModeInterval { get; private set; } 
         public ulong? CategoryId { get; private set; }
 
         public string Mention => MentionUtils.MentionChannel(Id);
@@ -35,7 +35,7 @@ namespace Discord.Rest
             base.Update(model);
             CategoryId = model.CategoryId;
             Topic = model.Topic.Value;
-            SlowMode = model.SlowMode.Value;
+            SlowModeInterval = model.SlowMode.Value;
             _nsfw = model.Nsfw.GetValueOrDefault();
         }
 
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index 3b2935149..bde36922a 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -156,7 +156,7 @@ namespace Discord.Rest
             {
                 CategoryId = props.CategoryId,
                 Topic = props.Topic,
-                IsNsfw = props.IsNsfw
+                IsNsfw = props.IsNsfw,
             };
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestTextChannel.Create(client, guild, model);
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
index d6982bf6a..2e9cd90be 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
@@ -16,7 +16,7 @@ namespace Discord.WebSocket
         private readonly MessageCache _messages;
 
         public string Topic { get; private set; }
-        public int SlowMode { get; private set; }
+        public int SlowModeInterval { get; private set; }
         public ulong? CategoryId { get; private set; }
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
@@ -48,7 +48,7 @@ namespace Discord.WebSocket
             base.Update(state, model);
             CategoryId = model.CategoryId;
             Topic = model.Topic.Value;
-            SlowMode = model.SlowMode.GetValueOrDefault(); // some guilds haven't been patched to include this yet?
+            SlowModeInterval = model.SlowMode.GetValueOrDefault(); // some guilds haven't been patched to include this yet?
             _nsfw = model.Nsfw.GetValueOrDefault();
         }
 

From 674a0fc5dd5181e05e32125f63117b2a1a197344 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Fri, 28 Sep 2018 15:19:00 -0700
Subject: [PATCH 13/59] Add Ubuntu target to AppVeyor CI build (#1149)

* Target Ubuntu in Appveyor CI build

AppVeyor has released support for targetting Ubuntu 18.04 environments.
This adds Ubuntu to the list of build images for Appveyor to use.

* Set clone folder to use appveyor defaults

* Check if appveyor provides appveyor-retry by trying to run it

* Minor syntax change

* Minor syntax change

* Skip using appveyor-retry (for now)

* Use forward slash for paths so that it works on both windows and linux

* Implement replacement for appveyor-retry

* Script cleanup

* Remove commented out line

* Only package releases on Windows

* Add the isWindows condition to the deploy stage
---
 appveyor.yml | 65 +++++++++++++++++++++++++++++++++++++++-------------
 1 file changed, 49 insertions(+), 16 deletions(-)

diff --git a/appveyor.yml b/appveyor.yml
index 54b9a1251..0c0c7b102 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -2,13 +2,17 @@ version: build-{build}
 branches:
   only:
   - dev
-image: Visual Studio 2017
+image:
+- Visual Studio 2017
+- Ubuntu
 
 nuget:
   disable_publish_on_pr: true
 pull_requests:
   do_not_increment_build_number: true
-clone_folder: C:\Projects\Discord.Net
+# Use the default clone_folder
+# Windows: C:\Projects\discord-net
+# Ubuntu: /home/appveyor/projects/discord-net
 cache: test/Discord.Net.Tests/cache.db
 
 environment:
@@ -20,23 +24,50 @@ init:
 - ps: $Env:BUILD = "$($Env:APPVEYOR_BUILD_NUMBER.PadLeft(5, "0"))"
 
 build_script:
-- ps: appveyor-retry dotnet restore Discord.Net.sln -v Minimal /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
+- ps: >-
+    if ($isLinux)
+    {
+      # AppVeyor Linux images do not have appveyor-retry, which retries the commands a few times
+      # until the command exits with code 0.
+      # So, this is done with a short script.
+      $code = 0
+      $counter = 0
+      do
+      {
+        dotnet restore Discord.Net.sln -v Minimal /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
+        $code = $LASTEXITCODE
+        $counter++
+        if ($code -ne 0)
+        {
+          # Wait 5s before attempting to run again
+          Start-sleep -Seconds 5
+        }
+      }
+      until ($counter -eq 5 -or $code -eq 0)
+    }
+    else
+    {
+      appveyor-retry dotnet restore Discord.Net.sln -v Minimal /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
+    }
 - ps: dotnet build Discord.Net.sln -c "Release" /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
 after_build:
-- ps: dotnet pack "src\Discord.Net.Core\Discord.Net.Core.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.Rest\Discord.Net.Rest.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.WebSocket\Discord.Net.WebSocket.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.Commands\Discord.Net.Commands.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.Webhook\Discord.Net.Webhook.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.Providers.WS4Net\Discord.Net.Providers.WS4Net.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-- ps: dotnet pack "src\Discord.Net.Analyzers\Discord.Net.Analyzers.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Core\Discord.Net.Core.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Rest\Discord.Net.Rest.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.WebSocket\Discord.Net.WebSocket.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Commands\Discord.Net.Commands.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Webhook\Discord.Net.Webhook.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Providers.WS4Net\Discord.Net.Providers.WS4Net.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
+- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Analyzers\Discord.Net.Analyzers.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
 - ps: >-
-    if ($Env:APPVEYOR_REPO_TAG -eq "true") {
-      nuget pack src\Discord.Net\Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix=""
-    } else {
-      nuget pack src\Discord.Net\Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix="-$Env:BUILD"
+    if ($isWindows)
+    {
+      if ($Env:APPVEYOR_REPO_TAG -eq "true") {
+        nuget pack src/Discord.Net/Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix=""
+      } else {
+        nuget pack src/Discord.Net/Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix="-$Env:BUILD"
+      }
     }
-- ps: Get-ChildItem artifacts\*.nupkg | % { Push-AppveyorArtifact $_.FullName -FileName $_.Name }
+- ps: if ($isWindows) { Get-ChildItem artifacts/*.nupkg | % { Push-AppveyorArtifact $_.FullName -FileName $_.Name } }
 
 test_script:
 - ps: >-
@@ -52,10 +83,12 @@ deploy:
   symbol_server: https://www.myget.org/F/discord-net/symbols/api/v2/package
   on:
     branch: dev
+    isWindows: True
 - provider: NuGet
   server: https://www.myget.org/F/rogueexception/api/v2/package
   api_key:
     secure: D+vW2O2LBf/iJb4f+q8fkyIW2VdIYIGxSYLWNrOD4BHlDBZQlJipDbNarWjUr2Kn
   symbol_server: https://www.myget.org/F/rogueexception/symbols/api/v2/package
   on:
-    branch: dev
\ No newline at end of file
+    branch: dev
+    isWindows: True

From efaedac98f306e1d855f6dc6f9efb5dd99eeb554 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sat, 29 Sep 2018 06:20:38 +0800
Subject: [PATCH 14/59] docs: Fix for incomplete structure sample (#1145)

---
 docs/guides/getting_started/samples/intro/structure.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/guides/getting_started/samples/intro/structure.cs b/docs/guides/getting_started/samples/intro/structure.cs
index a9a018c3a..5165e2fdb 100644
--- a/docs/guides/getting_started/samples/intro/structure.cs
+++ b/docs/guides/getting_started/samples/intro/structure.cs
@@ -36,7 +36,7 @@ class Program
             // you must set the MessageCacheSize. You may adjust the number as needed.
             //MessageCacheSize = 50,
 
-            // If your platform doesn't have native websockets,
+            // If your platform doesn't have native WebSockets,
             // add Discord.Net.Providers.WS4Net from NuGet,
             // add the `using` at the top, and uncomment this line:
             //WebSocketProvider = WS4NetProvider.Instance
@@ -57,7 +57,7 @@ class Program
         _commands.Log += Log;
         
         // Setup your DI container.
-        _services = ConfigureServices(),
+        _services = ConfigureServices();
         
     }
     
@@ -116,7 +116,9 @@ class Program
         await InitCommands();
 
         // Login and connect.
-        await _client.LoginAsync(TokenType.Bot, /* <DON'T HARDCODE YOUR TOKEN> */);
+        await _client.LoginAsync(TokenType.Bot,
+            // < DO NOT HARDCODE YOUR TOKEN >
+            Environment.GetEnvironmentVariable("DiscordToken"));
         await _client.StartAsync();
 
         // Wait infinitely so your bot actually stays connected.
@@ -160,7 +162,7 @@ class Program
             
             // Execute the command. (result does not indicate a return value, 
             // rather an object stating if the command executed successfully).
-            var result = await _commands.ExecuteAsync(context, pos);
+            var result = await _commands.ExecuteAsync(context, pos, _services);
 
             // Uncomment the following lines if you want the bot
             // to send a message if it failed.

From c898325e4594c7b0ea6455c715903c775ec42a2a Mon Sep 17 00:00:00 2001
From: Paulo <pnmanjos@hotmail.com>
Date: Fri, 28 Sep 2018 19:22:48 -0300
Subject: [PATCH 15/59] Fix GetReactionUsersAsync (#1151)

---
 src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs b/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
index 3dc3e74e9..30ee75c47 100644
--- a/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
@@ -71,7 +71,7 @@ namespace Discord.Rest
                 },
                 nextPage: (info, lastPage) =>
                 {
-                    if (lastPage.Count != DiscordConfig.MaxUsersPerBatch)
+                    if (lastPage.Count != DiscordConfig.MaxUserReactionsPerBatch)
                         return false;
 
                     info.Position = lastPage.Max(x => x.Id);

From de4d4150533327d29bfb1200835fff6fcff8f50a Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Fri, 28 Sep 2018 18:46:05 -0700
Subject: [PATCH 16/59] Fix deploy conditions in CI script (#1157)

* Fix deploy conditions in CI script

The deploy conditions had been using a powershell-only variable, and not a environment variable. This meant that the deployment failed on both Windows and Linux (expected only on Linux).

* Remove an extra newline

* Remove Debug statements from appveyor build script
---
 appveyor.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/appveyor.yml b/appveyor.yml
index 0c0c7b102..ef5f1667e 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -83,7 +83,7 @@ deploy:
   symbol_server: https://www.myget.org/F/discord-net/symbols/api/v2/package
   on:
     branch: dev
-    isWindows: True
+    CI_WINDOWS: true
 - provider: NuGet
   server: https://www.myget.org/F/rogueexception/api/v2/package
   api_key:
@@ -91,4 +91,4 @@ deploy:
   symbol_server: https://www.myget.org/F/rogueexception/symbols/api/v2/package
   on:
     branch: dev
-    isWindows: True
+    CI_WINDOWS: true

From c9ba79ec80c055b0ccb05e3f9260aa6a0963bdbd Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Mon, 1 Oct 2018 05:09:32 +0800
Subject: [PATCH 17/59] Initial fix (#1160)

---
 src/Discord.Net.Rest/API/Common/InviteVanity.cs     | 10 ++++++++++
 src/Discord.Net.Rest/DiscordRestApiClient.cs        |  4 ++--
 src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs |  6 ++++--
 3 files changed, 16 insertions(+), 4 deletions(-)
 create mode 100644 src/Discord.Net.Rest/API/Common/InviteVanity.cs

diff --git a/src/Discord.Net.Rest/API/Common/InviteVanity.cs b/src/Discord.Net.Rest/API/Common/InviteVanity.cs
new file mode 100644
index 000000000..d39792674
--- /dev/null
+++ b/src/Discord.Net.Rest/API/Common/InviteVanity.cs
@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Discord.API
+{
+    public class InviteVanity
+    {
+        [JsonProperty("code")]
+        public string Code { get; set; }
+    }
+}
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 35fa0e989..249e8e946 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -929,13 +929,13 @@ namespace Discord.API
             }
             catch (HttpException ex) when (ex.HttpCode == HttpStatusCode.NotFound) { return null; }
         }
-        public async Task<InviteMetadata> GetVanityInviteAsync(ulong guildId, RequestOptions options = null)
+        public async Task<InviteVanity> GetVanityInviteAsync(ulong guildId, RequestOptions options = null)
         {
             Preconditions.NotEqual(guildId, 0, nameof(guildId));
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            return await SendAsync<InviteMetadata>("GET", () => $"guilds/{guildId}/vanity-url", ids, options: options).ConfigureAwait(false);
+            return await SendAsync<InviteVanity>("GET", () => $"guilds/{guildId}/vanity-url", ids, options: options).ConfigureAwait(false);
         }
         public async Task<IReadOnlyCollection<InviteMetadata>> GetGuildInvitesAsync(ulong guildId, RequestOptions options = null)
         {
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index bde36922a..2b7900154 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -213,8 +213,10 @@ namespace Discord.Rest
         public static async Task<RestInviteMetadata> GetVanityInviteAsync(IGuild guild, BaseDiscordClient client,
             RequestOptions options)
         {
-            var model = await client.ApiClient.GetVanityInviteAsync(guild.Id, options).ConfigureAwait(false);
-            return RestInviteMetadata.Create(client, guild, null, model);
+            var vanityModel = await client.ApiClient.GetVanityInviteAsync(guild.Id, options).ConfigureAwait(false);
+            if (vanityModel == null) throw new InvalidOperationException("This guild does not have a vanity URL.");
+            var inviteModel = await client.ApiClient.GetInviteAsync(vanityModel.Code, options).ConfigureAwait(false);
+            return RestInviteMetadata.Create(client, guild, null, inviteModel);
         }
 
         //Roles

From 6b21b11f7d2fe4ffb93ae6c394d78bc7c7dcb75b Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sun, 30 Sep 2018 17:10:10 -0400
Subject: [PATCH 18/59] feature: adjust the ratelimit for reactions (#1108)

* feature: adjust the ratelimit for reactions

allows users to add reactions quickly

* fix: don't force DEBUG_LIMITS

* fix: undefined behavior using DateTime on intel architerctures

it's fine

* fix: ensure add/del rxn ends up in the same bucket
---
 src/Discord.Net.Core/RequestOptions.cs               |  3 ++-
 src/Discord.Net.Rest/DiscordRestApiClient.cs         | 10 ++++++++--
 src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs |  4 ++++
 3 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/Discord.Net.Core/RequestOptions.cs b/src/Discord.Net.Core/RequestOptions.cs
index 5f3a8814b..40f0ebaa4 100644
--- a/src/Discord.Net.Core/RequestOptions.cs
+++ b/src/Discord.Net.Core/RequestOptions.cs
@@ -1,4 +1,4 @@
-using System.Threading;
+using System.Threading;
 
 namespace Discord
 {
@@ -22,6 +22,7 @@ namespace Discord
         internal bool IgnoreState { get; set; }
         internal string BucketId { get; set; }
         internal bool IsClientBucket { get; set; }
+        internal bool IsReactionBucket { get; set; }
 
         internal static RequestOptions CreateOrClone(RequestOptions options)
         {            
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 249e8e946..1679579b2 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -580,6 +580,7 @@ namespace Discord.API
             var ids = new BucketIds(channelId: channelId);
             return await SendJsonAsync<Message>("PATCH", () => $"channels/{channelId}/messages/{messageId}", args, ids, clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
         }
+
         public async Task AddReactionAsync(ulong channelId, ulong messageId, string emoji, RequestOptions options = null)
         {
             Preconditions.NotEqual(channelId, 0, nameof(channelId));
@@ -587,10 +588,13 @@ namespace Discord.API
             Preconditions.NotNullOrWhitespace(emoji, nameof(emoji));
 
             options = RequestOptions.CreateOrClone(options);
+            options.IsReactionBucket = true;
 
             var ids = new BucketIds(channelId: channelId);
 
-            await SendAsync("PUT", () => $"channels/{channelId}/messages/{messageId}/reactions/{emoji}/@me", ids, options: options).ConfigureAwait(false);
+            // @me is non-const to fool the ratelimiter, otherwise it will put add/remove in separate buckets
+            var me = "@me";
+            await SendAsync("PUT", () => $"channels/{channelId}/messages/{messageId}/reactions/{emoji}/{me}", ids, options: options).ConfigureAwait(false);
         }
         public async Task RemoveReactionAsync(ulong channelId, ulong messageId, ulong userId, string emoji, RequestOptions options = null)
         {
@@ -599,10 +603,12 @@ namespace Discord.API
             Preconditions.NotNullOrWhitespace(emoji, nameof(emoji));
 
             options = RequestOptions.CreateOrClone(options);
+            options.IsReactionBucket = true;
 
             var ids = new BucketIds(channelId: channelId);
 
-            await SendAsync("DELETE", () => $"channels/{channelId}/messages/{messageId}/reactions/{emoji}/{userId}", ids, options: options).ConfigureAwait(false);
+            var user = CurrentUserId.HasValue ? (userId == CurrentUserId.Value ? "@me" : userId.ToString()) : userId.ToString();
+            await SendAsync("DELETE", () => $"channels/{channelId}/messages/{messageId}/reactions/{emoji}/{user}", ids, options: options).ConfigureAwait(false);
         }
         public async Task RemoveAllReactionsAsync(ulong channelId, ulong messageId, RequestOptions options = null)
         {
diff --git a/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs b/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
index c4f5996c5..d7f9779a4 100644
--- a/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
+++ b/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
@@ -250,6 +250,10 @@ namespace Discord.Net.Queue
                 else if (info.Reset.HasValue)
                 {
                     resetTick = info.Reset.Value.AddSeconds(info.Lag?.TotalSeconds ?? 1.0);
+
+                    if (request.Options.IsReactionBucket)
+                        resetTick = DateTimeOffset.Now.AddMilliseconds(250);
+
                     int diff = (int)(resetTick.Value - DateTimeOffset.UtcNow).TotalMilliseconds;
 #if DEBUG_LIMITS
                     Debug.WriteLine($"[{id}] X-RateLimit-Reset: {info.Reset.Value.ToUnixTimeSeconds()} ({diff} ms, {info.Lag?.TotalMilliseconds} ms lag)");

From ff0fea98a65d907fbce07856f1a9ef4aebb9108b Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Mon, 1 Oct 2018 05:44:33 +0800
Subject: [PATCH 19/59] Documentation Overhaul (#1161)

* Add XML docs

* Clean up style switcher

* Squash commits on branch docs/faq-n-patches

* Fix broken theme selector

* Add local image embed instruction

* Add a bunch of XML docs

* Add a bunch of XML docs

* Fix broken search
+ DocFX by default ships with an older version of jQuery, switching to a newer version confuses parts of the DocFX Javascript.

* Minor fixes for CONTRIBUTING.md and README.md

* Clean up filterConfig.yml

+ New config exposes Discord.Net namespace since it has several common public exceptions that may be helpful to users

* Add XML docs

* Read token from Environment Variable instead of hardcode

* Add XMLDocs

* Compress some assets & add OAuth2 URL generator

* Fix sample link & add missing pictures

* Add tag examples

* Fix embed docs consistency

* Add details regarding userbot support

* Add XML Docs

* Add XML Docs

* Add XML Docs

* Minor fixes in documentations
+ Fix unescaped '<'
+ Fix typo

* Fix seealso for preconditions and add missing descriptions

* Add missing exceptions

* Document exposed TypeReaders

* Fix letter-casing for files

* Add 'last modified' plugin

Source: https://github.com/Still34/DocFx.Plugin.LastModified
Licensed under MIT License

* XML Docs

* Fix minor consistencies & redundant impl

* Add properties examples to overwrite

* Fix missing Username prop

* Add warning for bulk-delete endpoint

* Replace note block

* Add BaseSocketClient docs

* Add XML docs

* Replace langword null to code block null instead

- Because DocFX sucks at rendering langword

* Replace all langword placements with code block

* Add more IGuild docs

* Add details to SpotifyGame

* Initial proofread of the articles

* Add explanation for RunMode

* Add event docs

- MessageReceived
- ChannelUpdated/Destroyed/Created

* Fix light theme link color

* Fix xml docs error

* Add partial documentation for audit log impl

* Add documentation for some REST-based objects

* Add partial documentation for audit log objects

* Add more XML comments to quotation mark alias map stuff, including an example

* Add reference to CommandServiceConfig from the util docs'

* Add explanation that if " is removed then it wont work

* Fix missing service provider in example

* Add documentation for new INestedChannel

* Add documentation

* Add documentation for new API version & few events

* Revise guide paragraphs/samples

+ Fix various formatting.
+ Provide a more detailed walkthrough for dependency injection.
+ Add C# note at intro.

* Fix typos & formatting

* Improve group module example

* Small amount to see if I'm doing it right

* Remove/cleanup redundant variables

* Fix EnterTypingState impl for doc inheritance

* Fix Test to resolve changes made in 15b58e

* Improve precondition documentation

+ Add precondition usage sample
+ Add precondition group usage sample
+ Move precondition samples to its own sample folder

* Move samples to individual folders

* Clarify token source

* Cleanup styling of README.md for docs

* Replace InvalidPathChars for NS1.3

* InvalidPathChars does not exist in NS1.3; replaced with GetInvalidPathChars instead.

* Add a missing change for 2c7cc738

* Update LastModified to v1.1.0 & add license

* Rewrite installation page for Core 2.1

* Fix anchor link

* Bump post-processor to v1.1.1

* Add fixes to partial file & add license

* Moved theme-switcher code to scripts partial file
+ Add author's MIT license to featherlight javascript

* Remove unused bootstrap plugin

* Bump LastModified plugin

* Changed the path from 'lastmodified' to 'last-modified' for consistency

* Cleanup README & Contribution guide

* Changes to last pr

* Fix GetCategoryAsync docs

* Proofread and cleanup articles

* Change passive voice in "Get Started" to active
* Fix improper preposition in Commands Introduction page
* Fix minor grammar mistakes in "Your First Bot" (future tense -> present tense/subjunctive mood -> indicative mood/proper noun casing/incorrect noun/add missing article)
* Fix minor grammar mistakes in "Installation" (missing article)

* no hablo ingles

* Try try try again

* I'm sure you're having as much fun as I am

* Cleanup TOC & fix titles

* Improve styling

+ Change title font to Noto Sans
+ Add materialized design for commit message box

* Add DescriptionGenerator plugin

* Add nightly section for clarification

* Fix typos in Nightlies & Post-execution

* Bump DescriptionGenerator to v1.1.0

+ This build adds the functionality of generating managed references' summary into the description tag.

* Initial emoji article draft

* Add 'additional information' section for emoji article

* Add cosmetic changes to the master css

* Alter info box color
+ Add transition to article content

* Add clarification in the emoji article

* Emphasize that normal emoji string will not translate to its Unicode representation.
* Clean up or add some of the samples featured in the article.
+ Add emoji/emote declaration section for clarification.
+ Add WebSocket emote sample.
- Remove inconsistent styling ('wacky memes' proves to be too out of place).

* Improve readability for nightlies article

* Move 'Bundled Preconditions' section

* Bump LastModified to fix UTC DateTime parsing

* Add langwordMapping.yml

* Add XML docs

* Add VSC workspace rule

* The root workspace limits the ruler to 120 characters for member documentations and excludes folders such as 'samples' and 'docs'.
* The docs workspace limits the ruler to 70 characters for standard conceptual article to comply with documentation's CONTRIBUTING.md rule, and excludes temprorary folders created by DocFX.

* Update CONTRIBUTING.md

* Add documentation style rule

* Fix styling of several member documentation

* Fix ' />' caused by Agent Smith oddities
* Fix styling to be more specific about the mention of IDs

* Fix exception summary to comply with official Microsoft Docs style

* References
https://docs.microsoft.com/en-us/dotnet/api/system.argumentnullexception?view=netframework-4.7.2
https://docs.microsoft.com/en-us/dotnet/api/system.platformnotsupportedexception?view=netframework-4.7.2
https://docs.microsoft.com/en-us/dotnet/api/system.badimageformatexception?view=netframework-4.7.2

* Add XML documentations

* Shift color return docs

* Fix minor docs

* Added documentation for SocketDMChannel, SocketGuildChannel, and SocketTextChannel

* Add XML docs

* Corrections to SocketGuildChannel

* Corrections to SocketTextChannel

* Corrections to SocketDMChannel

* Swapped out 'id' for 'snowflake identifier

* Swapped out 'id' for 'snowflake identifier'

* SocketDMChannel amendments

* SocketGuildChannel amendments

* SocketTextChannel amendments

* Add XML docs & patch return types
+ Starting from this commit, all return types for tasks will use style similar to most documentations featured on docs.microsoft.com

References:
https://docs.microsoft.com/en-us/dotnet/api/microsoft.entityframeworkcore.dbcontext.-ctor?view=efcore-2.1
https://docs.microsoft.com/en-us/dotnet/api/system.io.filestream.readasync?view=netcore-2.1
https://docs.microsoft.com/en-us/dotnet/api/system.io.textwriter.writelineasync?view=netcore-2.1#System_IO_TextWriter_WriteLineAsync_System_Char___
And many more other asynchronous method documentations featured in the latest BCL.

* Added documentation for many audit log data types, fixed vowel indefinite articles

* Change audit log data types to start with 'Contains' (verb) instead of an article

* Fix some documentation issues and document some more audit log data types

* Fix English posession

* Add XML doc

* Documented two more types

* Documented RoleCreateAuditLogData

* Document remaining audit log data types

* Added RestDMChannel documentation

* Added RestGuildChannel documentation

* Added RestTextChannel documentation

* Added RestVoiceChannel documentation

* Added RestUser documentation

* Added RestRole documentation

* Added RestMessage documentation

* Slightly better wording

* Contains -> Contains a piece of (describe article)

* [EN] Present perf. -> past perf.

* Add XML docs

* Fix arrow alignment

* Clarify supported nullable type

* Fixed a typo in ISnowflakeEntity

* Added RestUser Documentation

* Added RestInvite documentation

* Add XML docs & minor optimizations

* Minor optimization for doc rendering

* Rollback font optimization changes

* Amendments to RestUser

* Added SocketDMChannel documentation

* Added RestDMChannel documentation

* Added RestGuild documentation

* Adjustment to SocketDMChannel

* Added minimal descriptions from the API documentation for Integration types

* Added obsolete mention to the ReadMessages flag.

* Added remarks about 2FA requirement for guild permissions

* Added xmldoc for GuildPermission methods

* Added xml doc for ToAllowList and ToDenyList

* Added specification of how the bits of the color raw value are packed

* Added discord API documentation to IConnection interface

* I can spell :^)

* Fix whitespace in ChannelPermission

* fix spacing of values in guildpermission

* Made changes to get field descriptions from feedback, added returns tag to IConnection

* Added property get standard for IntegrationAccount

* Added property get pattern to xml docs and identical returns tag.

* Change all color class references to struct
...because it isn't a class.

* Add XML docs

* Rewrote the returns tags in IGuildIntegration, removed the ones I was unsure about.

* Rewrote the rest of the returns tags

* Amendments

* Cleanup doc for c1d78189

* Added types to <returns> tags where missing

* Added second sample for adding reactions

* Added some class summaries

* Missed a period

* Amendments

* restored the removed line break

* Removed unnecessary see tag

* Use consistent quotation marks around subscribers, the name for these users are dependant on the source of where they are integrated from (youtube or twitch), so we should not use a name that is specific to one platform

* Add <remarks> tag to the IGuildIntegration xmldocs

* Fix grammar issue

* Update DescriptionGenerator

* Cleanup of https://github.com/Still34/Discord.Net/pull/8

* Cleanup previous PR

* Fix for misleading behaviour in the emoji guide
+ Original lines stated that sending a emoji wrapped in colon will not be parsed, but that was incorrect; replaced with reactions instead of sending messages as the example

* Add strings for dictionary in DotSettings

* Add XML docs

* Fix lots of typos in comments
+ Geez, I didn't know there were so many.

* Add XML docs & rewrite GetMessagesAsync docs

This commit rewrites the remarks section of GetMessagesAsync, as well as adding examples to several methods.

* Update 'Your First Bot'
+ This commit reflects the new changes made to the Discord Application Developer Portal after its major update

* Initial optimization for DocFX render & add missing files

* Add examples in message methods

* Cleanup https://github.com/RogueException/Discord.Net/pull/1128

* Fix first bot note

* Cleanup FAQ structure

* Add XML docs

* Update docfx plugins

* Fix navbar collapsing issue

* Fix broken xref

* Cleanup FAQ section
+ Add introductory paragraphs to each FAQ section.
+ Add 'missing dependency' entry to commands FAQ.
* Split commands FAQ to 'General' and 'DI' sections.

* Cleanup https://github.com/RogueException/Discord.Net/pull/1139

* Fix missing namespace

* Add missing highlighting css for the light theme

* Add additional clarification for installing packages

* Add indentation to example for clarity

* Cleanup several articles to be more human-friendly and easier to read

* Remove RPC-related notes

* Cleanup slow-mode-related documentation strings

* Add an additional note about cross-guild emote usage

* Add CreateTextChannel sample

* Add XMLDocs
---
 .gitignore                                    |    3 +
 CONTRIBUTING.md                               |   20 +-
 Discord.Net.code-workspace                    |   23 +
 Discord.Net.sln.DotSettings                   |   16 +
 docs/CONTRIBUTING.md                          |   39 +-
 docs/Discord.Net.Docs.code-workspace          |   21 +
 docs/README.md                                |   19 +-
 .../Commands/CommandException.Overwrite.md    |   31 +
 .../DontAutoLoadAttribute.Overwrite.md        |   22 +
 .../Commands/DontInjectAttribute.Overwrite.md |   27 +
 .../Commands/ICommandContext.Inclusion.md     |    5 +
 .../Commands/ICommandContext.Overwrite.md     |   27 +
 .../PreconditionAttribute.Overwrites.md       |  103 ++
 ...PreconditionAttribute.Remarks.Inclusion.md |    6 +
 .../Common/EmbedBuilder.Overwrites.md         |   68 ++
 .../Common/EmbedObjectBuilder.Inclusion.md    |   25 +
 .../Common/EmbedObjectBuilder.Overwrites.md   |   20 +
 docs/_overwrites/Common/IEmote.Inclusion.md   |   26 +
 docs/_overwrites/Common/IEmote.Overwrites.md  |   81 ++
 .../Common/ObjectProperties.Overwrites.md     |  174 +++
 .../OverrideTypeReaderAttribute.Overwrites.md |   24 +
 .../Common/images/embed-example.png           |  Bin 0 -> 15290 bytes
 .../Common/images/react-example.png           |  Bin 0 -> 8994 bytes
 .../DocFX.Plugin.DescriptionGenerator.dll     |  Bin 0 -> 9216 bytes
 .../description-generator/plugins/LICENSE     |   21 +
 docs/_template/last-modified/plugins/LICENSE  |   21 +
 .../plugins/LastModifiedPostProcessor.dll     |  Bin 0 -> 11776 bytes
 .../partials/affix.tmpl.partial               |   33 +
 .../partials/head.tmpl.partial                |   27 +
 .../partials/scripts.tmpl.partial             |   10 +
 .../light-dark-theme/styles/cornerify.js      |    3 +
 .../light-dark-theme/styles/dark.css          |  304 +++++
 .../styles/docfx.vendor.minify.css            | 1022 +++++++++++++++++
 .../light-dark-theme/styles/gray.css          |  311 +++++
 .../light-dark-theme/styles/light.css         |  113 ++
 .../light-dark-theme/styles/master.css        |  156 +++
 .../styles/plugin-featherlight.js             |   37 +
 .../light-dark-theme/styles/styleswitcher.js  |   26 +
 .../styles/theme-switcher.css                 |    9 +
 .../light-dark-theme/styles/tomorrow.css      |   72 ++
 .../light-dark-theme/styles/vs2015.css        |  115 ++
 docs/api/index.md                             |   19 +-
 docs/docfx.json                               |   96 +-
 docs/faq/basics/basic-operations.md           |  123 ++
 docs/faq/basics/client-basics.md              |   66 ++
 docs/faq/basics/getting-started.md            |   79 ++
 docs/faq/basics/images/dev-mode.png           |  Bin 0 -> 80742 bytes
 docs/faq/basics/images/mention-escape.png     |  Bin 0 -> 19611 bytes
 docs/faq/basics/images/snowflake.png          |  Bin 0 -> 73062 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                  |  142 +++
 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/filterConfig.yml                         |   12 +-
 docs/guides/commands/commands.md              |  343 ------
 docs/guides/commands/dependency-injection.md  |   47 +
 docs/guides/commands/intro.md                 |  221 ++++
 docs/guides/commands/post-execution.md        |  122 ++
 docs/guides/commands/preconditions.md         |   83 ++
 .../commands/samples/command_handler.cs       |   63 -
 .../dependency_map_setup.cs                   |   62 +
 .../dependency-injection/dependency_module.cs |   37 +
 .../dependency_module_noinject.cs             |   29 +
 .../commands/samples/dependency_map_setup.cs  |   18 -
 .../commands/samples/dependency_module.cs     |   40 -
 docs/guides/commands/samples/empty-module.cs  |    6 -
 .../commands/samples/intro/command_handler.cs |   63 +
 .../commands/samples/intro/empty-module.cs    |    8 +
 .../commands/samples/{ => intro}/groups.cs    |   15 +-
 .../commands/samples/{ => intro}/module.cs    |   26 +-
 .../post-execution/command_exception_log.cs   |   13 +
 .../command_executed_adv_demo.cs              |   13 +
 .../post-execution/command_executed_demo.cs   |   38 +
 .../post-execution/customresult_base.cs       |    6 +
 .../post-execution/customresult_extended.cs   |   10 +
 .../post-execution/customresult_usage.cs      |   10 +
 .../post-execution/post-execution_basic.cs    |   11 +
 .../preconditions/group_precondition.cs       |    9 +
 .../preconditions/precondition_usage.cs       |    3 +
 .../{ => preconditions}/require_owner.cs      |   10 +-
 .../typereaders/typereader-register.cs        |   29 +
 .../samples/{ => typereaders}/typereader.cs   |    5 +-
 docs/guides/commands/typereaders.md           |   70 ++
 docs/guides/concepts/connections.md           |   43 +-
 docs/guides/concepts/entities.md              |   53 +-
 docs/guides/concepts/events.md                |   36 +-
 docs/guides/concepts/logging.md               |   39 +-
 docs/guides/concepts/samples/connections.cs   |    2 +-
 docs/guides/concepts/samples/entities.cs      |    8 +-
 docs/guides/concepts/samples/events.cs        |    2 +-
 docs/guides/concepts/samples/logging.cs       |    2 +-
 docs/guides/deployment/deployment.md          |   86 ++
 docs/guides/emoji/emoji.md                    |  100 ++
 docs/guides/emoji/images/emojipedia.png       |  Bin 0 -> 15043 bytes
 docs/guides/emoji/images/emote-format.png     |  Bin 0 -> 14696 bytes
 .../emoji/images/fileformat-emoji-src.png     |  Bin 0 -> 23541 bytes
 docs/guides/emoji/samples/emoji-sample.cs     |    6 +
 docs/guides/emoji/samples/emote-sample.cs     |    7 +
 .../emoji/samples/socket-emote-sample.cs      |   11 +
 docs/guides/getting_started/first-bot.md      |  263 +++++
 .../images/appveyor-artifacts.png             |  Bin 0 -> 7002 bytes
 .../getting_started/images/appveyor-nupkg.png |  Bin 0 -> 9412 bytes
 .../images/install-vs-nuget.png               |  Bin 119670 -> 49542 bytes
 .../getting_started/images/intro-add-bot.png  |  Bin 26232 -> 6417 bytes
 .../images/intro-authorize.png                |  Bin 0 -> 19052 bytes
 .../images/intro-bot-settings.png             |  Bin 0 -> 5704 bytes
 .../images/intro-client-id.png                |  Bin 5109 -> 0 bytes
 .../images/intro-create-app.png               |  Bin 52035 -> 0 bytes
 .../images/intro-create-bot.png               |  Bin 45743 -> 0 bytes
 .../images/intro-oauth-settings.png           |  Bin 0 -> 5655 bytes
 .../images/intro-public-bot.png               |  Bin 0 -> 11135 bytes
 .../images/intro-scopes-bot.png               |  Bin 0 -> 17423 bytes
 .../getting_started/images/intro-token.png    |  Bin 26594 -> 18552 bytes
 .../images/nightlies-vs-note.png              |  Bin 0 -> 10162 bytes
 .../images/nightlies-vs-step1.png             |  Bin 0 -> 13372 bytes
 .../images/nightlies-vs-step2.png             |  Bin 0 -> 13713 bytes
 .../images/nightlies-vs-step4.png             |  Bin 0 -> 8214 bytes
 docs/guides/getting_started/installing.md     |  156 ++-
 docs/guides/getting_started/intro.md          |  237 ----
 docs/guides/getting_started/nightlies.md      |   86 ++
 .../samples/first-bot/async-context.cs        |    9 +
 .../samples/first-bot/client.cs               |   21 +
 .../samples/first-bot/complete.cs             |   34 +
 .../samples/first-bot/logging.cs              |    5 +
 .../samples/{intro => first-bot}/message.cs   |    2 +-
 .../samples/{intro => first-bot}/structure.cs |    0
 .../samples/intro/async-context.cs            |   15 -
 .../getting_started/samples/intro/client.cs   |   17 -
 .../getting_started/samples/intro/complete.cs |   44 -
 .../getting_started/samples/intro/logging.cs  |   22 -
 .../getting_started/samples/project.csproj    |   13 -
 .../getting_started/samples/project.xml       |   17 +
 docs/guides/getting_started/terminology.md    |   40 +-
 docs/guides/introduction/intro.md             |   54 +
 docs/guides/migrating/migrating.md            |   61 -
 docs/guides/migrating/samples/event.cs        |    4 -
 docs/guides/migrating/samples/sync_event.cs   |    5 -
 docs/guides/toc.yml                           |   42 +-
 docs/guides/voice/sending-voice.md            |    5 +-
 docs/index.md                                 |   31 +-
 docs/langwordMapping.yml                      |   61 +
 docs/toc.yml                                  |    7 +-
 .../Discord.Net.Rpc/DiscordRpcApiClient.cs    |    2 +-
 .../Discord.Net.Rpc/DiscordRpcConfig.cs       |    4 +-
 .../Entities/Channels/RpcDMChannel.cs         |    1 +
 .../Entities/Channels/RpcGroupChannel.cs      |    1 +
 samples/01_basic_ping_bot/Program.cs          |    6 +-
 samples/02_commands_framework/Program.cs      |    2 +-
 .../Attributes/AliasAttribute.cs              |   29 +-
 .../Attributes/CommandAttribute.cs            |   15 +
 .../Attributes/DontAutoLoadAttribute.cs       |    8 +
 .../Attributes/DontInjectAttribute.cs         |   34 +-
 .../Attributes/GroupAttribute.cs              |   11 +
 .../Attributes/NameAttribute.cs               |   10 +
 .../Attributes/OverrideTypeReaderAttribute.cs |   31 +-
 .../ParameterPreconditionAttribute.cs         |   11 +
 .../Attributes/PreconditionAttribute.cs       |   21 +-
 .../RequireBotPermissionAttribute.cs          |   44 +-
 .../Preconditions/RequireContextAttribute.cs  |   34 +-
 .../Preconditions/RequireNsfwAttribute.cs     |   24 +-
 .../Preconditions/RequireOwnerAttribute.cs    |   33 +-
 .../RequireUserPermissionAttribute.cs         |   47 +-
 .../Attributes/PriorityAttribute.cs           |   12 +-
 .../Attributes/RemainderAttribute.cs          |    3 +
 .../Attributes/RemarksAttribute.cs            |    3 +
 .../Attributes/SummaryAttribute.cs            |    3 +
 .../Builders/CommandBuilder.cs                |    1 +
 .../Builders/ModuleClassBuilder.cs            |    2 +-
 src/Discord.Net.Commands/CommandContext.cs    |   16 +-
 src/Discord.Net.Commands/CommandError.cs      |   27 +-
 src/Discord.Net.Commands/CommandException.cs  |   13 +
 src/Discord.Net.Commands/CommandMatch.cs      |    5 +-
 src/Discord.Net.Commands/CommandParser.cs     |    2 +-
 src/Discord.Net.Commands/CommandService.cs    |  212 +++-
 .../CommandServiceConfig.cs                   |   49 +-
 .../Extensions/MessageExtensions.cs           |   18 +
 src/Discord.Net.Commands/Info/CommandInfo.cs  |   63 +-
 src/Discord.Net.Commands/Info/ModuleInfo.cs   |   39 +
 .../Info/ParameterInfo.cs                     |   35 +-
 .../Map/CommandMapNode.cs                     |    1 +
 src/Discord.Net.Commands/ModuleBase.cs        |   39 +-
 .../MultiMatchHandling.cs                     |    7 +-
 .../Readers/ChannelTypeReader.cs              |   14 +-
 .../Readers/EnumTypeReader.cs                 |    7 +-
 .../Readers/MessageTypeReader.cs              |    9 +-
 .../Readers/NullableTypeReader.cs             |    5 +-
 .../Readers/PrimitiveTypeReader.cs            |    8 +-
 .../Readers/RoleTypeReader.cs                 |    9 +-
 .../Readers/TimeSpanTypeReader.cs             |    1 +
 .../Readers/TypeReader.cs                     |   14 +-
 .../Readers/UserTypeReader.cs                 |   16 +-
 .../Results/ExecuteResult.cs                  |   54 +-
 src/Discord.Net.Commands/Results/IResult.cs   |   24 +-
 .../Results/ParseResult.cs                    |    8 +-
 .../Results/PreconditionGroupResult.cs        |    2 +-
 .../Results/PreconditionResult.cs             |   27 +
 .../Results/RuntimeResult.cs                  |   12 +-
 .../Results/SearchResult.cs                   |    3 +
 .../Results/TypeReaderResult.cs               |    5 +
 src/Discord.Net.Commands/RunMode.cs           |   16 +-
 .../Utilities/QuotationAliasUtils.cs          |   11 +-
 .../Utilities/ReflectionUtils.cs              |   11 +-
 src/Discord.Net.Core/Audio/AudioOutStream.cs  |   17 +-
 src/Discord.Net.Core/Audio/AudioStream.cs     |   34 +-
 src/Discord.Net.Core/Audio/IAudioClient.cs    |    2 +-
 src/Discord.Net.Core/CDN.cs                   |   85 ++
 .../Commands/ICommandContext.cs               |   20 +-
 src/Discord.Net.Core/ConnectionState.cs       |    7 +-
 src/Discord.Net.Core/DiscordConfig.cs         |  118 +-
 .../Entities/Activities/ActivityType.cs       |   17 +-
 .../Entities/Activities/Game.cs               |   11 +
 .../Entities/Activities/GameAsset.cs          |   27 +-
 .../Entities/Activities/GameParty.cs          |   15 +
 .../Entities/Activities/GameSecrets.cs        |   16 +-
 .../Entities/Activities/GameTimestamps.cs     |   13 +-
 .../Entities/Activities/IActivity.cs          |   17 +-
 .../Entities/Activities/RichGame.cs           |   32 +-
 .../Entities/Activities/SpotifyGame.cs        |   63 +
 .../Entities/Activities/StreamingGame.cs      |   18 +-
 .../Entities/AuditLogs/ActionType.cs          |   86 +-
 .../Entities/AuditLogs/IAuditLogData.cs       |    8 +-
 .../Entities/AuditLogs/IAuditLogEntry.cs      |   22 +-
 src/Discord.Net.Core/Entities/CacheMode.cs    |   11 +-
 .../Entities/Channels/ChannelType.cs          |    8 +-
 .../Entities/Channels/Direction.cs            |   14 +-
 .../Channels/GuildChannelProperties.cs        |   27 +-
 .../Entities/Channels/IAudioChannel.cs        |   22 +-
 .../Entities/Channels/ICategoryChannel.cs     |    9 +-
 .../Entities/Channels/IChannel.cs             |   38 +-
 .../Entities/Channels/IDMChannel.cs           |   22 +-
 .../Entities/Channels/IGroupChannel.cs        |   15 +-
 .../Entities/Channels/IGuildChannel.cs        |  163 ++-
 .../Entities/Channels/IMessageChannel.cs      |  262 ++++-
 .../Entities/Channels/INestedChannel.cs       |   21 +-
 .../Entities/Channels/IPrivateChannel.cs      |   11 +-
 .../Entities/Channels/ITextChannel.cs         |  104 +-
 .../Entities/Channels/IVoiceChannel.cs        |   29 +-
 .../Channels/ReorderChannelProperties.cs      |   22 +-
 .../Channels/TextChannelProperties.cs         |   22 +-
 .../Channels/VoiceChannelProperties.cs        |   10 +-
 src/Discord.Net.Core/Entities/Emotes/Emoji.cs |   24 +-
 src/Discord.Net.Core/Entities/Emotes/Emote.cs |   49 +-
 .../Entities/Emotes/EmoteProperties.cs        |   12 +-
 .../Entities/Emotes/GuildEmote.cs             |   28 +-
 .../Entities/Emotes/IEmote.cs                 |    9 +-
 .../Guilds/DefaultMessageNotifications.cs     |   13 +-
 .../Entities/Guilds/GuildEmbedProperties.cs   |   10 +-
 .../Guilds/GuildIntegrationProperties.cs      |   14 +-
 .../Entities/Guilds/GuildProperties.cs        |   47 +-
 src/Discord.Net.Core/Entities/Guilds/IBan.cs  |   17 +-
 .../Entities/Guilds/IGuild.cs                 |  629 +++++++++-
 .../Entities/Guilds/IGuildIntegration.cs      |   54 +-
 .../Entities/Guilds/IUserGuild.cs             |   18 +-
 .../Entities/Guilds/IVoiceRegion.cs           |   45 +-
 .../Entities/Guilds/IntegrationAccount.cs     |    6 +-
 .../Entities/Guilds/MfaLevel.cs               |   13 +-
 .../Entities/Guilds/PermissionTarget.cs       |   11 +-
 .../Entities/Guilds/VerificationLevel.cs      |   25 +-
 src/Discord.Net.Core/Entities/IApplication.cs |   20 +-
 src/Discord.Net.Core/Entities/IDeletable.cs   |   10 +-
 src/Discord.Net.Core/Entities/IEntity.cs      |    4 +-
 src/Discord.Net.Core/Entities/IMentionable.cs |   12 +-
 .../Entities/ISnowflakeEntity.cs              |    7 +
 src/Discord.Net.Core/Entities/IUpdateable.cs  |    9 +-
 src/Discord.Net.Core/Entities/Image.cs        |   37 +-
 src/Discord.Net.Core/Entities/ImageFormat.cs  |   20 +-
 .../Entities/Invites/IInvite.cs               |   75 +-
 .../Entities/Invites/IInviteMetadata.cs       |   55 +-
 .../Entities/Messages/Embed.cs                |   22 +
 .../Entities/Messages/EmbedAuthor.cs          |   22 +-
 .../Entities/Messages/EmbedBuilder.cs         |  396 ++++++-
 .../Entities/Messages/EmbedField.cs           |   20 +-
 .../Entities/Messages/EmbedFooter.cs          |   32 +-
 .../Entities/Messages/EmbedImage.cs           |   34 +-
 .../Entities/Messages/EmbedProvider.cs        |   20 +-
 .../Entities/Messages/EmbedThumbnail.cs       |   34 +-
 .../Entities/Messages/EmbedType.cs            |   30 +
 .../Entities/Messages/EmbedVideo.cs           |   30 +-
 .../Entities/Messages/IAttachment.cs          |   47 +-
 .../Entities/Messages/IEmbed.cs               |   84 +-
 .../Entities/Messages/IMessage.cs             |   95 +-
 .../Entities/Messages/IReaction.cs            |    8 +-
 .../Entities/Messages/ISystemMessage.cs       |    5 +-
 .../Entities/Messages/IUserMessage.cs         |  104 +-
 .../Entities/Messages/MessageProperties.cs    |   27 +-
 .../Entities/Messages/MessageSource.cs        |   15 +
 .../Entities/Messages/MessageType.cs          |   26 +-
 .../Entities/Messages/ReactionMetadata.cs     |   19 +-
 .../Entities/Messages/TagHandling.cs          |   42 +-
 .../Entities/Messages/TagType.cs              |    9 +-
 .../Entities/Permissions/ChannelPermission.cs |   99 +-
 .../Permissions/ChannelPermissions.cs         |   70 +-
 .../Entities/Permissions/GuildPermission.cs   |  135 ++-
 .../Entities/Permissions/GuildPermissions.cs  |   77 +-
 .../Entities/Permissions/Overwrite.cs         |   21 +-
 .../Permissions/OverwritePermissions.cs       |   45 +-
 .../Entities/Permissions/PermValue.cs         |    6 +-
 src/Discord.Net.Core/Entities/Roles/Color.cs  |  137 ++-
 src/Discord.Net.Core/Entities/Roles/IRole.cs  |   80 +-
 .../Entities/Roles/ReorderRoleProperties.cs   |   24 +-
 .../Entities/Roles/RoleProperties.cs          |   37 +-
 .../Entities/Users/GuildUserProperties.cs     |   59 +-
 .../Entities/Users/IConnection.cs             |   15 +-
 .../Entities/Users/IGroupUser.cs              |    5 +-
 .../Entities/Users/IGuildUser.cs              |  115 +-
 .../Entities/Users/IPresence.cs               |   15 +-
 .../Entities/Users/ISelfUser.cs               |   26 +-
 src/Discord.Net.Core/Entities/Users/IUser.cs  |   54 +-
 .../Entities/Users/IVoiceState.cs             |   33 +-
 .../Entities/Users/IWebhookUser.cs            |    4 +-
 .../Entities/Users/SelfUserProperties.cs      |   18 +-
 .../Entities/Users/UserStatus.cs              |   23 +-
 .../Entities/Webhooks/IWebhook.cs             |   43 +-
 .../Entities/Webhooks/WebhookProperties.cs    |   27 +-
 .../Extensions/AsyncEnumerableExtensions.cs   |   10 +-
 .../Extensions/DiscordClientExtensions.cs     |    9 +-
 .../Extensions/EmbedBuilderExtensions.cs      |   11 +
 .../Extensions/MessageExtensions.cs           |   10 +
 .../Extensions/UserExtensions.cs              |  119 +-
 src/Discord.Net.Core/Format.cs                |    1 +
 src/Discord.Net.Core/IDiscordClient.cs        |  238 +++-
 src/Discord.Net.Core/Logging/LogManager.cs    |   10 +-
 src/Discord.Net.Core/Logging/LogMessage.cs    |   41 +-
 src/Discord.Net.Core/Logging/LogSeverity.cs   |   24 +-
 src/Discord.Net.Core/LoginState.cs            |    7 +-
 src/Discord.Net.Core/Net/HttpException.cs     |   32 +
 src/Discord.Net.Core/Net/IRequest.cs          |    3 +
 .../Net/RateLimitedException.cs               |   10 +
 src/Discord.Net.Core/Net/Rest/IRestClient.cs  |   21 +
 .../Net/WebSocketClosedException.cs           |   20 +-
 src/Discord.Net.Core/RequestOptions.cs        |   40 +-
 src/Discord.Net.Core/RetryMode.cs             |    4 +-
 src/Discord.Net.Core/TokenType.cs             |   10 +
 src/Discord.Net.Core/Utils/Cacheable.cs       |   37 +-
 src/Discord.Net.Core/Utils/Comparers.cs       |   18 +
 .../Utils/ConcurrentHashSet.cs                |    8 +-
 src/Discord.Net.Core/Utils/DateTimeUtils.cs   |    3 +-
 src/Discord.Net.Core/Utils/MentionUtils.cs    |   56 +-
 src/Discord.Net.Core/Utils/Optional.cs        |    3 +-
 src/Discord.Net.Core/Utils/Permissions.cs     |    2 +-
 src/Discord.Net.Core/Utils/Preconditions.cs   |    2 +
 src/Discord.Net.Core/Utils/SnowflakeUtils.cs  |   17 +
 src/Discord.Net.Core/Utils/TokenUtils.cs      |   11 +-
 .../WS4NetClient.cs                           |    4 +-
 .../API/Common/EmbedAuthor.cs                 |    1 -
 .../API/Common/EmbedFooter.cs                 |    1 -
 src/Discord.Net.Rest/API/Common/EmbedImage.cs |    3 +-
 .../API/Common/EmbedProvider.cs               |    3 +-
 .../API/Common/EmbedThumbnail.cs              |    3 +-
 src/Discord.Net.Rest/API/Common/EmbedVideo.cs |    3 +-
 .../API/Rest/UploadFileParams.cs              |    1 -
 src/Discord.Net.Rest/BaseDiscordClient.cs     |   35 +-
 src/Discord.Net.Rest/ClientHelper.cs          |    4 +-
 src/Discord.Net.Rest/DiscordRestApiClient.cs  |   47 +-
 src/Discord.Net.Rest/DiscordRestClient.cs     |   54 +-
 src/Discord.Net.Rest/DiscordRestConfig.cs     |    5 +-
 .../AuditLogs/DataTypes/BanAuditLogData.cs    |   11 +-
 .../DataTypes/ChannelCreateAuditLogData.cs    |   29 +-
 .../DataTypes/ChannelDeleteAuditLogData.cs    |   30 +-
 .../AuditLogs/DataTypes/ChannelInfo.cs        |   29 +
 .../DataTypes/ChannelUpdateAuditLogData.cs    |   23 +-
 .../DataTypes/EmoteCreateAuditLogData.cs      |   19 +-
 .../DataTypes/EmoteDeleteAuditLogData.cs      |   17 +-
 .../DataTypes/EmoteUpdateAuditLogData.cs      |   23 +-
 .../Entities/AuditLogs/DataTypes/GuildInfo.cs |   55 +
 .../DataTypes/GuildUpdateAuditLogData.cs      |   17 +-
 .../DataTypes/InviteCreateAuditLogData.cs     |   49 +-
 .../DataTypes/InviteDeleteAuditLogData.cs     |   49 +-
 .../AuditLogs/DataTypes/InviteInfo.cs         |   37 +
 .../DataTypes/InviteUpdateAuditLogData.cs     |   15 +
 .../AuditLogs/DataTypes/KickAuditLogData.cs   |    9 +
 .../DataTypes/MemberRoleAuditLogData.cs       |   17 +-
 .../AuditLogs/DataTypes/MemberRoleEditInfo.cs |   21 +
 .../DataTypes/MemberUpdateAuditLogData.cs     |   12 +-
 .../DataTypes/MessageDeleteAuditLogData.cs    |   16 +
 .../DataTypes/OverwriteCreateAuditLogData.cs  |    9 +
 .../DataTypes/OverwriteDeleteAuditLogData.cs  |   15 +-
 .../DataTypes/OverwriteUpdateAuditLogData.cs  |   30 +-
 .../AuditLogs/DataTypes/PruneAuditLogData.cs  |   18 +
 .../DataTypes/RoleCreateAuditLogData.cs       |   15 +
 .../DataTypes/RoleDeleteAuditLogData.cs       |   15 +
 .../AuditLogs/DataTypes/RoleEditInfo.cs       |   38 +
 .../DataTypes/RoleUpdateAuditLogData.cs       |   21 +
 .../AuditLogs/DataTypes/UnbanAuditLogData.cs  |    9 +
 .../DataTypes/WebhookCreateAuditLogData.cs    |   35 +-
 .../DataTypes/WebhookDeleteAuditLogData.cs    |   38 +-
 .../AuditLogs/DataTypes/WebhookInfo.cs        |   22 +
 .../DataTypes/WebhookUpdateAuditLogData.cs    |   28 +-
 .../Entities/AuditLogs/RestAuditLogEntry.cs   |    3 +
 .../Entities/Channels/ChannelHelper.cs        |   41 +-
 .../Entities/Channels/IRestMessageChannel.cs  |  186 ++-
 .../Entities/Channels/IRestPrivateChannel.cs  |    8 +-
 .../Entities/Channels/RestCategoryChannel.cs  |   13 +-
 .../Entities/Channels/RestChannel.cs          |   10 +
 .../Entities/Channels/RestDMChannel.cs        |   94 +-
 .../Entities/Channels/RestGroupChannel.cs     |   50 +-
 .../Entities/Channels/RestGuildChannel.cs     |  113 +-
 .../Entities/Channels/RestTextChannel.cs      |  133 ++-
 .../Entities/Channels/RestVoiceChannel.cs     |   20 +
 .../Channels/RpcVirtualMessageChannel.cs      |   27 +-
 .../Entities/Guilds/GuildHelper.cs            |   24 +-
 .../Entities/Guilds/RestBan.cs                |   19 +-
 .../Entities/Guilds/RestGuild.cs              |  387 ++++++-
 .../Entities/Guilds/RestGuildEmbed.cs         |    4 +-
 .../Entities/Guilds/RestGuildIntegration.cs   |   14 +-
 .../Entities/Guilds/RestUserGuild.cs          |    8 +-
 .../Entities/Guilds/RestVoiceRegion.cs        |    3 +
 .../Entities/Invites/RestInvite.cs            |   22 +-
 .../Entities/Invites/RestInviteMetadata.cs    |   11 +
 .../Entities/Messages/Attachment.cs           |   18 +-
 .../Entities/Messages/MessageHelper.cs        |    6 +-
 .../Entities/Messages/RestMessage.cs          |   40 +-
 .../Entities/Messages/RestReaction.cs         |   12 +-
 .../Entities/Messages/RestSystemMessage.cs    |    6 +-
 .../Entities/Messages/RestUserMessage.cs      |   26 +-
 .../Entities/RestApplication.cs               |   21 +-
 .../Entities/Roles/RestRole.cs                |   27 +-
 .../Entities/Users/RestConnection.cs          |   13 +-
 .../Entities/Users/RestGroupUser.cs           |   14 +-
 .../Entities/Users/RestGuildUser.cs           |   23 +
 .../Entities/Users/RestSelfUser.cs            |   13 +-
 .../Entities/Users/RestUser.cs                |   32 +-
 .../Entities/Users/RestWebhookUser.cs         |   54 +-
 .../Entities/Users/UserHelper.cs              |    4 +-
 .../Entities/Webhooks/RestWebhook.cs          |   15 +-
 .../Net/Converters/ImageConverter.cs          |    3 +-
 .../Converters/PermissionTargetConverter.cs   |    8 +-
 src/Discord.Net.Rest/Net/DefaultRestClient.cs |    4 +-
 .../Net/DefaultRestClientProvider.cs          |    1 +
 .../Net/Queue/RequestQueue.cs                 |    2 +-
 .../Net/Queue/RequestQueueBucket.cs           |    2 +-
 src/Discord.Net.Rest/Utils/TypingNotifier.cs  |   16 +-
 .../Audio/AudioClient.cs                      |    1 -
 .../Audio/Streams/OpusDecodeStream.cs         |    9 +-
 .../Audio/Streams/OpusEncodeStream.cs         |    2 +-
 .../Audio/Streams/RTPReadStream.cs            |    5 +-
 .../Audio/Streams/SodiumDecryptStream.cs      |    4 +-
 .../Audio/Streams/SodiumEncryptStream.cs      |   14 +-
 .../BaseSocketClient.Events.cs                |   88 ++
 src/Discord.Net.WebSocket/BaseSocketClient.cs |  228 +++-
 src/Discord.Net.WebSocket/ClientState.cs      |    2 +-
 .../Commands/ShardedCommandContext.cs         |    6 +-
 .../Commands/SocketCommandContext.cs          |   33 +-
 .../DiscordShardedClient.cs                   |   40 +-
 .../DiscordSocketApiClient.cs                 |   10 +-
 .../DiscordSocketClient.Events.cs             |    9 +-
 .../DiscordSocketClient.cs                    |  114 +-
 .../DiscordSocketConfig.cs                    |   55 +-
 .../Entities/Channels/ISocketAudioChannel.cs  |    5 +-
 .../Channels/ISocketMessageChannel.cs         |  111 +-
 .../Channels/ISocketPrivateChannel.cs         |    5 +-
 .../Channels/SocketCategoryChannel.cs         |   24 +-
 .../Entities/Channels/SocketChannel.cs        |   23 +-
 .../Entities/Channels/SocketChannelHelper.cs  |    9 +-
 .../Entities/Channels/SocketDMChannel.cs      |  174 ++-
 .../Entities/Channels/SocketGroupChannel.cs   |   52 +-
 .../Entities/Channels/SocketGuildChannel.cs   |  126 +-
 .../Entities/Channels/SocketTextChannel.cs    |  196 +++-
 .../Entities/Channels/SocketVoiceChannel.cs   |   21 +
 .../Entities/Guilds/SocketGuild.cs            |  368 +++++-
 .../Entities/Messages/MessageCache.cs         |    4 +-
 .../Entities/Messages/SocketMessage.cs        |   72 +-
 .../Entities/Messages/SocketReaction.cs       |   40 +-
 .../Entities/Messages/SocketSystemMessage.cs  |    6 +-
 .../Entities/Messages/SocketUserMessage.cs    |   27 +-
 .../Entities/Roles/SocketRole.cs              |   36 +-
 .../Entities/SocketEntity.cs                  |    3 +-
 .../Entities/Users/SocketGlobalUser.cs        |    5 +-
 .../Entities/Users/SocketGroupUser.cs         |   23 +-
 .../Entities/Users/SocketGuildUser.cs         |   57 +-
 .../Entities/Users/SocketPresence.cs          |   14 +-
 .../Entities/Users/SocketSelfUser.cs          |   18 +-
 .../Entities/Users/SocketUnknownUser.cs       |   21 +-
 .../Entities/Users/SocketUser.cs              |   26 +-
 .../Entities/Users/SocketVoiceState.cs        |   27 +-
 .../Entities/Users/SocketWebhookUser.cs       |   70 +-
 .../Entities/Voice/SocketVoiceServer.cs       |   27 +-
 .../Net/DefaultWebSocketClientProvider.cs     |    1 +
 .../DiscordWebhookClient.cs                   |   20 +-
 .../Entities/Webhooks/RestInternalWebhook.cs  |    2 +-
 .../WebhookClientHelper.cs                    |    5 +-
 .../AnalyzerTests/GuildAccessTests.cs         |    6 +-
 .../Helpers/DiagnosticVerifier.Helper.cs      |    3 +-
 .../Verifiers/DiagnosticVerifier.cs           |    5 +-
 test/Discord.Net.Tests/Net/HttpMixin.cs       |    3 +-
 test/Discord.Net.Tests/Tests.Channels.cs      |   13 +-
 .../Tests.GuildPermissions.cs                 |    4 +-
 test/Discord.Net.Tests/Tests.Migrations.cs    |    2 +-
 test/Discord.Net.Tests/Tests.Permissions.cs   |    1 -
 498 files changed, 16061 insertions(+), 2630 deletions(-)
 create mode 100644 Discord.Net.code-workspace
 create mode 100644 Discord.Net.sln.DotSettings
 create mode 100644 docs/Discord.Net.Docs.code-workspace
 create mode 100644 docs/_overwrites/Commands/CommandException.Overwrite.md
 create mode 100644 docs/_overwrites/Commands/DontAutoLoadAttribute.Overwrite.md
 create mode 100644 docs/_overwrites/Commands/DontInjectAttribute.Overwrite.md
 create mode 100644 docs/_overwrites/Commands/ICommandContext.Inclusion.md
 create mode 100644 docs/_overwrites/Commands/ICommandContext.Overwrite.md
 create mode 100644 docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
 create mode 100644 docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
 create mode 100644 docs/_overwrites/Common/EmbedBuilder.Overwrites.md
 create mode 100644 docs/_overwrites/Common/EmbedObjectBuilder.Inclusion.md
 create mode 100644 docs/_overwrites/Common/EmbedObjectBuilder.Overwrites.md
 create mode 100644 docs/_overwrites/Common/IEmote.Inclusion.md
 create mode 100644 docs/_overwrites/Common/IEmote.Overwrites.md
 create mode 100644 docs/_overwrites/Common/ObjectProperties.Overwrites.md
 create mode 100644 docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md
 create mode 100644 docs/_overwrites/Common/images/embed-example.png
 create mode 100644 docs/_overwrites/Common/images/react-example.png
 create mode 100644 docs/_template/description-generator/plugins/DocFX.Plugin.DescriptionGenerator.dll
 create mode 100644 docs/_template/description-generator/plugins/LICENSE
 create mode 100644 docs/_template/last-modified/plugins/LICENSE
 create mode 100644 docs/_template/last-modified/plugins/LastModifiedPostProcessor.dll
 create mode 100644 docs/_template/light-dark-theme/partials/affix.tmpl.partial
 create mode 100644 docs/_template/light-dark-theme/partials/head.tmpl.partial
 create mode 100644 docs/_template/light-dark-theme/partials/scripts.tmpl.partial
 create mode 100644 docs/_template/light-dark-theme/styles/cornerify.js
 create mode 100644 docs/_template/light-dark-theme/styles/dark.css
 create mode 100644 docs/_template/light-dark-theme/styles/docfx.vendor.minify.css
 create mode 100644 docs/_template/light-dark-theme/styles/gray.css
 create mode 100644 docs/_template/light-dark-theme/styles/light.css
 create mode 100644 docs/_template/light-dark-theme/styles/master.css
 create mode 100644 docs/_template/light-dark-theme/styles/plugin-featherlight.js
 create mode 100644 docs/_template/light-dark-theme/styles/styleswitcher.js
 create mode 100644 docs/_template/light-dark-theme/styles/theme-switcher.css
 create mode 100644 docs/_template/light-dark-theme/styles/tomorrow.css
 create mode 100644 docs/_template/light-dark-theme/styles/vs2015.css
 create mode 100644 docs/faq/basics/basic-operations.md
 create mode 100644 docs/faq/basics/client-basics.md
 create mode 100644 docs/faq/basics/getting-started.md
 create mode 100644 docs/faq/basics/images/dev-mode.png
 create mode 100644 docs/faq/basics/images/mention-escape.png
 create mode 100644 docs/faq/basics/images/snowflake.png
 create mode 100644 docs/faq/basics/samples/cast.cs
 create mode 100644 docs/faq/basics/samples/emoji-others.cs
 create mode 100644 docs/faq/basics/samples/emoji-self.cs
 create mode 100644 docs/faq/commands/dependency-injection.md
 create mode 100644 docs/faq/commands/general.md
 create mode 100644 docs/faq/commands/samples/DI.cs
 create mode 100644 docs/faq/commands/samples/Remainder.cs
 create mode 100644 docs/faq/commands/samples/missing-dep.cs
 create mode 100644 docs/faq/commands/samples/runmode-cmdattrib.cs
 create mode 100644 docs/faq/commands/samples/runmode-cmdconfig.cs
 create mode 100644 docs/faq/misc/glossary.md
 create mode 100644 docs/faq/misc/legacy.md
 create mode 100644 docs/faq/toc.yml
 delete mode 100644 docs/guides/commands/commands.md
 create mode 100644 docs/guides/commands/dependency-injection.md
 create mode 100644 docs/guides/commands/intro.md
 create mode 100644 docs/guides/commands/post-execution.md
 create mode 100644 docs/guides/commands/preconditions.md
 delete mode 100644 docs/guides/commands/samples/command_handler.cs
 create mode 100644 docs/guides/commands/samples/dependency-injection/dependency_map_setup.cs
 create mode 100644 docs/guides/commands/samples/dependency-injection/dependency_module.cs
 create mode 100644 docs/guides/commands/samples/dependency-injection/dependency_module_noinject.cs
 delete mode 100644 docs/guides/commands/samples/dependency_map_setup.cs
 delete mode 100644 docs/guides/commands/samples/dependency_module.cs
 delete mode 100644 docs/guides/commands/samples/empty-module.cs
 create mode 100644 docs/guides/commands/samples/intro/command_handler.cs
 create mode 100644 docs/guides/commands/samples/intro/empty-module.cs
 rename docs/guides/commands/samples/{ => intro}/groups.cs (52%)
 rename docs/guides/commands/samples/{ => intro}/module.cs (58%)
 create mode 100644 docs/guides/commands/samples/post-execution/command_exception_log.cs
 create mode 100644 docs/guides/commands/samples/post-execution/command_executed_adv_demo.cs
 create mode 100644 docs/guides/commands/samples/post-execution/command_executed_demo.cs
 create mode 100644 docs/guides/commands/samples/post-execution/customresult_base.cs
 create mode 100644 docs/guides/commands/samples/post-execution/customresult_extended.cs
 create mode 100644 docs/guides/commands/samples/post-execution/customresult_usage.cs
 create mode 100644 docs/guides/commands/samples/post-execution/post-execution_basic.cs
 create mode 100644 docs/guides/commands/samples/preconditions/group_precondition.cs
 create mode 100644 docs/guides/commands/samples/preconditions/precondition_usage.cs
 rename docs/guides/commands/samples/{ => preconditions}/require_owner.cs (66%)
 create mode 100644 docs/guides/commands/samples/typereaders/typereader-register.cs
 rename docs/guides/commands/samples/{ => typereaders}/typereader.cs (74%)
 create mode 100644 docs/guides/commands/typereaders.md
 create mode 100644 docs/guides/deployment/deployment.md
 create mode 100644 docs/guides/emoji/emoji.md
 create mode 100644 docs/guides/emoji/images/emojipedia.png
 create mode 100644 docs/guides/emoji/images/emote-format.png
 create mode 100644 docs/guides/emoji/images/fileformat-emoji-src.png
 create mode 100644 docs/guides/emoji/samples/emoji-sample.cs
 create mode 100644 docs/guides/emoji/samples/emote-sample.cs
 create mode 100644 docs/guides/emoji/samples/socket-emote-sample.cs
 create mode 100644 docs/guides/getting_started/first-bot.md
 create mode 100644 docs/guides/getting_started/images/appveyor-artifacts.png
 create mode 100644 docs/guides/getting_started/images/appveyor-nupkg.png
 create mode 100644 docs/guides/getting_started/images/intro-authorize.png
 create mode 100644 docs/guides/getting_started/images/intro-bot-settings.png
 delete mode 100644 docs/guides/getting_started/images/intro-client-id.png
 delete mode 100644 docs/guides/getting_started/images/intro-create-app.png
 delete mode 100644 docs/guides/getting_started/images/intro-create-bot.png
 create mode 100644 docs/guides/getting_started/images/intro-oauth-settings.png
 create mode 100644 docs/guides/getting_started/images/intro-public-bot.png
 create mode 100644 docs/guides/getting_started/images/intro-scopes-bot.png
 create mode 100644 docs/guides/getting_started/images/nightlies-vs-note.png
 create mode 100644 docs/guides/getting_started/images/nightlies-vs-step1.png
 create mode 100644 docs/guides/getting_started/images/nightlies-vs-step2.png
 create mode 100644 docs/guides/getting_started/images/nightlies-vs-step4.png
 delete mode 100644 docs/guides/getting_started/intro.md
 create mode 100644 docs/guides/getting_started/nightlies.md
 create mode 100644 docs/guides/getting_started/samples/first-bot/async-context.cs
 create mode 100644 docs/guides/getting_started/samples/first-bot/client.cs
 create mode 100644 docs/guides/getting_started/samples/first-bot/complete.cs
 create mode 100644 docs/guides/getting_started/samples/first-bot/logging.cs
 rename docs/guides/getting_started/samples/{intro => first-bot}/message.cs (92%)
 rename docs/guides/getting_started/samples/{intro => first-bot}/structure.cs (100%)
 delete mode 100644 docs/guides/getting_started/samples/intro/async-context.cs
 delete mode 100644 docs/guides/getting_started/samples/intro/client.cs
 delete mode 100644 docs/guides/getting_started/samples/intro/complete.cs
 delete mode 100644 docs/guides/getting_started/samples/intro/logging.cs
 delete mode 100644 docs/guides/getting_started/samples/project.csproj
 create mode 100644 docs/guides/getting_started/samples/project.xml
 create mode 100644 docs/guides/introduction/intro.md
 delete mode 100644 docs/guides/migrating/migrating.md
 delete mode 100644 docs/guides/migrating/samples/event.cs
 delete mode 100644 docs/guides/migrating/samples/sync_event.cs
 create mode 100644 docs/langwordMapping.yml

diff --git a/.gitignore b/.gitignore
index 45e5e009d..954362408 100644
--- a/.gitignore
+++ b/.gitignore
@@ -206,3 +206,6 @@ project.lock.json
 docs/api/\.manifest
 
 \.idea/
+
+# Codealike UID
+codealike.json
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8248291e8..752b40931 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,4 +41,22 @@ We attempt to conform to the .NET Foundation's [Coding Style](https://github.com
 where possible.
 
 As a general rule, follow the coding style already set in the file you
-are editing, or look at a similar file if you are adding a new one.
\ No newline at end of file
+are editing, or look at a similar file if you are adding a new one.
+
+### Documentation Style for Members
+
+When creating a new public member, the member must be annotated with sufficient documentation. This should include the
+following, but not limited to:
+
+* `<summary>` summarizing the purpose of the method.
+* `<param>` or `<typeparam>` explaining the parameter.
+* `<return>` explaining the type of the returned member and what it is.
+* `<exception>` if the method directly throws an exception.
+
+The length of the documentation should also follow the ruler as suggested by our
+[Visual Studio Code workspace](Discord.Net.code-workspace).
+
+#### Recommended Reads
+
+* [Official Microsoft Documentation](https://docs.microsoft.com)
+* [Sandcastle User Manual](https://ewsoftware.github.io/XMLCommentsGuide/html/4268757F-CE8D-4E6D-8502-4F7F2E22DDA3.htm)
\ No newline at end of file
diff --git a/Discord.Net.code-workspace b/Discord.Net.code-workspace
new file mode 100644
index 000000000..709eb0e95
--- /dev/null
+++ b/Discord.Net.code-workspace
@@ -0,0 +1,23 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+	],
+	"settings": {
+		"editor.rulers": [
+			120
+		],
+		"files.exclude": {
+			"**/.git": true,
+			"**/.svn": true,
+			"**/.hg": true,
+			"**/CVS": true,
+			"**/.DS_Store": true,
+			"docs/": true,
+			"**/obj": true,
+			"**/bin": true,
+			"samples/": true,
+		}
+	}
+}
\ No newline at end of file
diff --git a/Discord.Net.sln.DotSettings b/Discord.Net.sln.DotSettings
new file mode 100644
index 000000000..ca75a7f1b
--- /dev/null
+++ b/Discord.Net.sln.DotSettings
@@ -0,0 +1,16 @@
+<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Cacheable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Downloader/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Emoji/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=libsodium/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=NSFW/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Ratelimit/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=sharded/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spotify/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=unban/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Uncache/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhook/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhooks/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhook_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=ZWSP/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 296b6d1cb..8641d377e 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -1,27 +1,21 @@
 # Contributing to Docs
 
-I don't really have any strict conditions for writing documentation, 
-but just keep these few guidelines in mind:
+## General Guidelines
+
+We do not have any strict conditions for writing documentation,
+but keep these guidelines in mind:
 
 * Keep code samples in the `guides/samples` folder
-* When referencing an object in the API, link to it's page in the 
-API documentation.
+* When referencing an object in the API, link to its page in the
+ API documentation
+* Documentation should be written in an FAQ/Wiki-style format
 * Documentation should be written in clear and proper English*
 
-\* If anyone is interested in translating documentation into other 
-languages, please open an issue or contact me on 
+\* If anyone is interested in translating documentation into other
+languages, please open an issue or contact me on
 Discord (`foxbot#0282`).
 
-### Layout
-
-Documentation should be written in a FAQ/Wiki style format.
-
-Recommended reads:
-
-* http://docs.microsoft.com
-* http://flask.pocoo.org/docs/0.12/
-
-Style consistencies:
+## Style Consistencies
 
 * Use a ruler set at 70 characters
 * Links should use long syntax
@@ -29,18 +23,13 @@ Style consistencies:
 
 Example of long link syntax:
 
-```
+```md
 Please consult the [API Documentation] for more information.
 
 [API Documentation]: xref:System.String
 ```
 
-### Compiling
-
-Documentation is compiled into a static site using [DocFx]. 
-We currently use the most recent build off the dev branch.
+## Recommended Reads
 
-After making changes, compile your changes into the static site with 
-`docfx`. You can also view your changes live with `docfx --serve`.
-
-[DocFx]: https://dotnet.github.io/docfx/
\ No newline at end of file
+* http://docs.microsoft.com
+* http://flask.pocoo.org/docs/0.12/
\ No newline at end of file
diff --git a/docs/Discord.Net.Docs.code-workspace b/docs/Discord.Net.Docs.code-workspace
new file mode 100644
index 000000000..d9f442869
--- /dev/null
+++ b/docs/Discord.Net.Docs.code-workspace
@@ -0,0 +1,21 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+	],
+	"settings": {
+		"editor.rulers": [
+			70
+		],
+		"files.exclude": {
+			"**/.git": true,
+			"**/.svn": true,
+			"**/.hg": true,
+			"**/CVS": true,
+			"**/.DS_Store": true,
+			"obj/": true,
+			"_site/": true,
+		}
+	}
+}
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index a672330d4..4a06dccab 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,16 +1,15 @@
 # Instructions for Building Documentation
 
-The documentation for the Discord.NET library uses [DocFX][docfx-main]. [Instructions for installing this tool can be found here.][docfx-installing]
+The documentation for the Discord.Net library uses [DocFX][docfx-main].
+Instructions for installing this tool can be found [here][docfx-installing].
 
 1. Navigate to the root of the repository.
-2. (Optional) If you intend to target a specific version, ensure that you
-have the correct version checked out.
-3. Build the library. Run `dotnet build` in the root of this repository.
- Ensure that the build passes without errors.
-4. Build the docs using `docfx .\docs\docfx.json`. Add the `--serve` parameter
-to preview the site locally. Some elements of the page may appear incorrect
-when not hosted by a server.
-      - Remarks: According to the docfx website, this tool does work on Linux under mono.
+2. Build the docs using `docfx docs/docfx.json`. Add the `--serve`
+ parameter to preview the site locally. Some elements of the page
+ may appear incorrectly when hosted offline.
+
+Please note that if you intend to target a specific version, ensure
+that you have the correct version checked out.
 
 [docfx-main]: https://dotnet.github.io/docfx/
-[docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
+[docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/CommandException.Overwrite.md b/docs/_overwrites/Commands/CommandException.Overwrite.md
new file mode 100644
index 000000000..166a011de
--- /dev/null
+++ b/docs/_overwrites/Commands/CommandException.Overwrite.md
@@ -0,0 +1,31 @@
+---
+uid: Discord.Commands.CommandException
+remarks: *content
+---
+
+This @System.Exception class is typically used when diagnosing
+an error thrown during the execution of a command. You will find the
+thrown exception passed into
+[LogMessage.Exception](xref:Discord.LogMessage.Exception), which is
+sent to your [CommandService.Log](xref:Discord.Commands.CommandService.Log)
+event handler.
+
+---
+uid: Discord.Commands.CommandException
+example: [*content]
+---
+
+You may use this information to handle runtime exceptions after
+execution. Below is an example of how you may use this:
+
+```cs
+public Task LogHandlerAsync(LogMessage logMessage)
+{
+    // Note that this casting method requires C#7 and up.
+    if (logMessage?.Exception is CommandException cmdEx)
+    {
+        Console.WriteLine($"{cmdEx.GetBaseException().GetType()} was thrown while executing {cmdEx.Command.Aliases.First()} in {cmdEx.Context.Channel} by {cmdEx.Context.User}.");
+    }
+    return Task.CompletedTask;
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/DontAutoLoadAttribute.Overwrite.md b/docs/_overwrites/Commands/DontAutoLoadAttribute.Overwrite.md
new file mode 100644
index 000000000..d47980df7
--- /dev/null
+++ b/docs/_overwrites/Commands/DontAutoLoadAttribute.Overwrite.md
@@ -0,0 +1,22 @@
+---
+uid: Discord.Commands.DontAutoLoadAttribute
+remarks: *content
+---
+
+The attribute can be applied to a public class that inherits
+@Discord.Commands.ModuleBase. By applying this attribute,
+@Discord.Commands.CommandService.AddModulesAsync* will not discover and
+add the marked module to the CommandService.
+
+---
+uid: Discord.Commands.DontAutoLoadAttribute
+example: [*content]
+---
+
+```cs
+[DontAutoLoad]
+public class MyModule : ModuleBase<SocketCommandContext>
+{
+    // ...
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/DontInjectAttribute.Overwrite.md b/docs/_overwrites/Commands/DontInjectAttribute.Overwrite.md
new file mode 100644
index 000000000..950d2990c
--- /dev/null
+++ b/docs/_overwrites/Commands/DontInjectAttribute.Overwrite.md
@@ -0,0 +1,27 @@
+---
+uid: Discord.Commands.DontInjectAttribute
+remarks: *content
+---
+
+The attribute can be applied to a public settable property inside a
+@Discord.Commands.ModuleBase based class. By applying this attribute,
+the marked property will not be automatically injected of the
+dependency. See @Guides.Commands.DI to learn more.
+
+---
+uid: Discord.Commands.DontInjectAttribute
+example: [*content]
+---
+
+```cs
+public class MyModule : ModuleBase<SocketCommandContext>
+{
+    [DontInject]
+    public MyService MyService { get; set; }
+
+    public MyModule()
+    {
+        MyService = new MyService();
+    }
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/ICommandContext.Inclusion.md b/docs/_overwrites/Commands/ICommandContext.Inclusion.md
new file mode 100644
index 000000000..4c1257b23
--- /dev/null
+++ b/docs/_overwrites/Commands/ICommandContext.Inclusion.md
@@ -0,0 +1,5 @@
+An example of how this class is used the command system can be seen 
+below:
+
+[!code[Sample module](../../guides/commands/samples/intro/empty-module.cs)]
+[!code[Command handler](../../guides/commands/samples/intro/command_handler.cs)]
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/ICommandContext.Overwrite.md b/docs/_overwrites/Commands/ICommandContext.Overwrite.md
new file mode 100644
index 000000000..d9e50b46d
--- /dev/null
+++ b/docs/_overwrites/Commands/ICommandContext.Overwrite.md
@@ -0,0 +1,27 @@
+---
+uid: Discord.Commands.ICommandContext
+example: [*content]
+---
+
+[!include[Example Section](ICommandContext.Inclusion.md)]
+
+---
+uid: Discord.Commands.CommandContext
+example: [*content]
+---
+
+[!include[Example Section](ICommandContext.Inclusion.md)]
+
+---
+uid: Discord.Commands.SocketCommandContext
+example: [*content]
+---
+
+[!include[Example Section](ICommandContext.Inclusion.md)]
+
+---
+uid: Discord.Commands.ShardCommandContext
+example: [*content]
+---
+
+[!include[Example Section](ICommandContext.Inclusion.md)]
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md b/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
new file mode 100644
index 000000000..75b9f93a5
--- /dev/null
+++ b/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
@@ -0,0 +1,103 @@
+---
+uid: Discord.Commands.PreconditionAttribute
+remarks: *content
+---
+
+This precondition attribute can be applied on module-level or
+method-level for a command.
+
+[!include[Additional Remarks](PreconditionAttribute.Remarks.Inclusion.md)]
+
+---
+uid: Discord.Commands.ParameterPreconditionAttribute
+remarks: *content
+---
+
+This precondition attribute can be applied on parameter-level for a
+command.
+
+[!include[Additional Remarks](PreconditionAttribute.Remarks.Inclusion.md)]
+
+---
+uid: Discord.Commands.PreconditionAttribute
+example: [*content]
+---
+
+The following example creates a precondition to see if the user has
+sufficient role required to access the command.
+
+```cs
+public class RequireRoleAttribute : PreconditionAttribute
+{
+    private readonly ulong _roleId;
+
+    public RequireRoleAttribute(ulong roleId)
+    {
+        _roleId = roleId;
+    }
+
+    public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context,
+        CommandInfo command, IServiceProvider services)
+    {
+        var guildUser = context.User as IGuildUser;
+        if (guildUser == null)
+            return PreconditionResult.FromError("This command cannot be executed outside of a guild.");
+
+        var guild = guildUser.Guild;
+        if (guild.Roles.All(r => r.Id != _roleId))
+            return PreconditionResult.FromError(
+                $"The guild does not have the role ({_roleId}) required to access this command.");
+
+        return guildUser.RoleIds.Any(rId => rId == _roleId)
+            ? PreconditionResult.FromSuccess()
+            : PreconditionResult.FromError("You do not have the sufficient role required to access this command.");
+    }
+}
+```
+
+---
+uid: Discord.Commands.ParameterPreconditionAttribute
+example: [*content]
+---
+
+The following example creates a precondition on a parameter-level to
+see if the targeted user has a lower hierarchy than the user who
+executed the command.
+
+```cs
+public class RequireHierarchyAttribute : ParameterPreconditionAttribute
+{
+    public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context,
+        ParameterInfo parameter, object value, IServiceProvider services)
+    {
+        // Hierarchy is only available under the socket variant of the user.
+        if (!(context.User is SocketGuildUser guildUser))
+            return PreconditionResult.FromError("This command cannot be used outside of a guild.");
+
+        SocketGuildUser targetUser;
+        switch (value)
+        {
+            case SocketGuildUser targetGuildUser:
+                targetUser = targetGuildUser;
+                break;
+            case ulong userId:
+                targetUser = await context.Guild.GetUserAsync(userId).ConfigureAwait(false) as SocketGuildUser;
+                break;
+            default:
+                throw new ArgumentOutOfRangeException();
+        }
+
+        if (targetUser == null)
+            return PreconditionResult.FromError("Target user not found.");
+
+        if (guildUser.Hierarchy < targetUser.Hierarchy)
+            return PreconditionResult.FromError("You cannot target anyone else whose roles are higher than yours.");
+
+        var currentUser = await context.Guild.GetCurrentUserAsync().ConfigureAwait(false) as SocketGuildUser;
+        if (currentUser?.Hierarchy < targetUser.Hierarchy)
+            return PreconditionResult.FromError("The bot's role is lower than the targeted user.");
+
+        return PreconditionResult.FromSuccess();
+    }
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md b/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
new file mode 100644
index 000000000..499cdb0ad
--- /dev/null
+++ b/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
@@ -0,0 +1,6 @@
+A "precondidtion" in the command system is used to determine if a
+condition is met before entering the command task. Using a
+precondidtion may aid in keeping a well-organized command logic.
+
+The most common use case being whether a user has sufficient
+permission to execute the command.
\ No newline at end of file
diff --git a/docs/_overwrites/Common/EmbedBuilder.Overwrites.md b/docs/_overwrites/Common/EmbedBuilder.Overwrites.md
new file mode 100644
index 000000000..2dcb1e004
--- /dev/null
+++ b/docs/_overwrites/Common/EmbedBuilder.Overwrites.md
@@ -0,0 +1,68 @@
+---
+uid: Discord.EmbedBuilder
+seealso:
+    - linkId: Discord.EmbedFooterBuilder
+    - linkId: Discord.EmbedAuthorBuilder
+    - linkId: Discord.EmbedFieldBuilder
+remarks: *content
+---
+
+This builder class is used to build an @Discord.Embed (rich embed)
+object that will be ready to be sent via @Discord.IMessageChannel.SendMessageAsync*
+after @Discord.EmbedBuilder.Build* is called.
+
+---
+uid: Discord.EmbedBuilder
+example: [*content]
+---
+
+#### Basic Usage
+
+The example below builds an embed and sends it to the chat using the
+command system.
+
+```cs
+[Command("embed")]
+public async Task SendRichEmbedAsync()
+{
+    var embed = new EmbedBuilder
+        {
+            // Embed property can be set within object initializer
+            Title = "Hello world!"
+            Description = "I am a description set by initializer."
+        };
+        // Or with methods
+    embed.AddField("Field title",
+        "Field value. I also support [hyperlink markdown](https://example.com)!")
+        .WithAuthor(Context.Client.CurrentUser)
+        .WithFooter(footer => footer.Text = "I am a footer.")
+        .WithColor(Color.Blue)
+        .WithTitle("I overwrote \"Hello world!\"")
+        .WithDescription("I am a description.")
+        .WithUrl("https://example.com")
+        .WithCurrentTimestamp()
+        .Build();
+    await ReplyAsync(embed: embed);
+}
+```
+
+![Embed Example](images/embed-example.png)
+
+#### Usage with Local Images
+
+The example below sends an image and has the image embedded in the rich
+embed. See @Discord.IMessageChannel.SendFileAsync* for more information
+about uploading a file or image.
+
+```cs
+[Command("embedimage")]
+public async Task SendEmbedWithImageAsync()
+{
+    var fileName = "image.png";
+    var embed = new EmbedBuilder()
+        {
+            ImageUrl = $"attachment://{fileName}"
+        }.Build();
+    await Context.Channel.SendFileAsync(fileName, embed: embed);
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Common/EmbedObjectBuilder.Inclusion.md b/docs/_overwrites/Common/EmbedObjectBuilder.Inclusion.md
new file mode 100644
index 000000000..eac0d9ca5
--- /dev/null
+++ b/docs/_overwrites/Common/EmbedObjectBuilder.Inclusion.md
@@ -0,0 +1,25 @@
+The example will build a rich embed with an author field, a footer
+field, and 2 normal fields using an @Discord.EmbedBuilder:
+
+```cs
+var exampleAuthor = new EmbedAuthorBuilder()
+        .WithName("I am a bot")
+        .WithIconUrl("https://discordapp.com/assets/e05ead6e6ebc08df9291738d0aa6986d.png");
+var exampleFooter = new EmbedFooterBuilder()
+        .WithText("I am a nice footer")
+        .WithIconUrl("https://discordapp.com/assets/28174a34e77bb5e5310ced9f95cb480b.png");
+var exampleField = new EmbedFieldBuilder()
+        .WithName("Title of Another Field")
+        .WithValue("I am an [example](https://example.com).")
+        .WithInline(true);
+var otherField = new EmbedFieldBuilder()
+        .WithName("Title of a Field")
+        .WithValue("Notice how I'm inline with that other field next to me.")
+        .WithInline(true);
+var embed = new EmbedBuilder()
+        .AddField(exampleField)
+        .AddField(otherField)
+        .WithAuthor(exampleAuthor)
+        .WithFooter(exampleFooter)
+        .Build();
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Common/EmbedObjectBuilder.Overwrites.md b/docs/_overwrites/Common/EmbedObjectBuilder.Overwrites.md
new file mode 100644
index 000000000..c633c29b1
--- /dev/null
+++ b/docs/_overwrites/Common/EmbedObjectBuilder.Overwrites.md
@@ -0,0 +1,20 @@
+---
+uid: Discord.EmbedAuthorBuilder
+example: [*content]
+---
+
+[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]
+
+---
+uid: Discord.EmbedFooterBuilder
+example: [*content]
+---
+
+[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]
+
+---
+uid: Discord.EmbedFieldBuilder
+example: [*content]
+---
+
+[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]
\ No newline at end of file
diff --git a/docs/_overwrites/Common/IEmote.Inclusion.md b/docs/_overwrites/Common/IEmote.Inclusion.md
new file mode 100644
index 000000000..cf93c7eb5
--- /dev/null
+++ b/docs/_overwrites/Common/IEmote.Inclusion.md
@@ -0,0 +1,26 @@
+The sample below sends a message and adds an @Discord.Emoji and a custom
+@Discord.Emote to the message.
+
+```cs
+public async Task SendAndReactAsync(ISocketMessageChannel channel)
+{
+    var message = await channel.SendMessageAsync("I am a message.");
+
+    // Creates a Unicode-based emoji based on the Unicode string.
+    // This is effectively the same as new Emoji("💕").
+    var heartEmoji = new Emoji("\U0001f495");
+    // Reacts to the message with the Emoji.
+    await message.AddReactionAsync(heartEmoji);
+
+    // Parses a custom emote based on the provided Discord emote format.
+    // Please note that this does not guarantee the existence of
+    // the emote.
+    var emote = Emote.Parse("<:thonkang:282745590985523200>");
+    // Reacts to the message with the Emote.
+    await message.AddReactionAsync(emote);
+}
+```
+
+#### Result
+
+![React Example](images/react-example.png)
\ No newline at end of file
diff --git a/docs/_overwrites/Common/IEmote.Overwrites.md b/docs/_overwrites/Common/IEmote.Overwrites.md
new file mode 100644
index 000000000..034533d1d
--- /dev/null
+++ b/docs/_overwrites/Common/IEmote.Overwrites.md
@@ -0,0 +1,81 @@
+---
+uid: Discord.IEmote
+seealso:
+    - linkId: Discord.Emote
+    - linkId: Discord.Emoji
+    - linkId: Discord.GuildEmote
+    - linkId: Discord.IUserMessage
+remarks: *content
+---
+
+This interface is often used with reactions. It can represent an
+unicode-based @Discord.Emoji, or a custom @Discord.Emote.
+
+---
+uid: Discord.Emote
+seealso:
+    - linkId: Discord.IEmote
+    - linkId: Discord.GuildEmote
+    - linkId: Discord.Emoji
+    - linkId: Discord.IUserMessage
+remarks: *content
+---
+
+> [!NOTE]
+> A valid @Discord.Emote format is `<:emoteName:emoteId>`. This can be
+> obtained by escaping with a `\` in front of the emote using the
+> Discord chat client.
+
+This class represents a custom emoji. This type of emoji can be
+created via the @Discord.Emote.Parse* or @Discord.Emote.TryParse*
+method.
+
+---
+uid: Discord.Emoji
+seealso:
+    - linkId: Discord.Emote
+    - linkId: Discord.GuildEmote
+    - linkId: Discord.Emoji
+    - linkId: Discord.IUserMessage
+remarks: *content
+---
+
+> [!NOTE]
+> A valid @Discord.Emoji format is Unicode-based. This means only
+> something like `🙃` or `\U0001f643` would work, instead of
+> `:upside_down:`.
+>
+> A Unicode-based emoji can be obtained by escaping with a `\` in
+> front of the emote using the Discord chat client or by looking up on
+> [Emojipedia](https://emojipedia.org).
+
+This class represents a standard Unicode-based emoji. This type of emoji
+can be created by passing the Unicode into the constructor.
+
+---
+uid: Discord.IEmote
+example: [*content]
+---
+
+[!include[Example Section](IEmote.Inclusion.md)]
+
+---
+uid: Discord.Emoji
+example: [*content]
+---
+
+[!include[Example Section](IEmote.Inclusion.md)]
+
+---
+uid: Discord.Emote
+example: [*content]
+---
+
+[!include[Example Section](IEmote.Inclusion.md)]
+
+---
+uid: Discord.GuildEmote
+example: [*content]
+---
+
+[!include[Example Section](IEmote.Inclusion.md)]
\ No newline at end of file
diff --git a/docs/_overwrites/Common/ObjectProperties.Overwrites.md b/docs/_overwrites/Common/ObjectProperties.Overwrites.md
new file mode 100644
index 000000000..e9c365d39
--- /dev/null
+++ b/docs/_overwrites/Common/ObjectProperties.Overwrites.md
@@ -0,0 +1,174 @@
+---
+uid: Discord.GuildChannelProperties
+example: [*content]
+---
+
+The following example uses @Discord.IGuildChannel.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var channel = _client.GetChannel(id) as IGuildChannel;
+if (channel == null) return;
+
+await channel.ModifyAsync(x =>
+{
+    x.Name = "new-name";
+    x.Position = channel.Position - 1;
+});
+```
+
+---
+uid: Discord.TextChannelProperties
+example: [*content]
+---
+
+The following example uses @Discord.ITextChannel.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var channel = _client.GetChannel(id) as ITextChannel;
+if (channel == null) return;
+
+await channel.ModifyAsync(x =>
+{
+    x.Name = "cool-guys-only";
+    x.Topic = "This channel is only for cool guys and adults!!!";
+    x.Position = channel.Position - 1;
+    x.IsNsfw = true;
+});
+```
+
+---
+uid: Discord.VoiceChannelProperties
+example: [*content]
+---
+
+The following example uses @Discord.IVoiceChannel.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var channel = _client.GetChannel(id) as IVoiceChannel;
+if (channel == null) return;
+
+await channel.ModifyAsync(x =>
+{
+    x.UserLimit = 5;
+});
+```
+
+---
+uid: Discord.EmoteProperties
+example: [*content]
+---
+
+The following example uses @Discord.IGuild.ModifyEmoteAsync* to
+apply changes specified in the properties,
+
+```cs
+await guild.ModifyEmoteAsync(x =>
+{
+    x.Name = "blobo";
+});
+```
+
+---
+uid: Discord.MessageProperties
+example: [*content]
+---
+
+The following example uses @Discord.IUserMessage.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var message = await channel.SendMessageAsync("boo");
+await Task.Delay(TimeSpan.FromSeconds(1));
+await message.ModifyAsync(x => x.Content = "boi");
+```
+
+---
+uid: Discord.GuildProperties
+example: [*content]
+---
+
+The following example uses @Discord.IGuild.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var guild = _client.GetGuild(id);
+if (guild == null) return;
+
+await guild.ModifyAsync(x =>
+{
+    x.Name = "VERY Fast Discord Running at Incredible Hihg Speed";
+});
+```
+
+---
+uid: Discord.RoleProperties
+example: [*content]
+---
+
+The following example uses @Discord.IRole.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var role = guild.GetRole(id);
+if (role == null) return;
+
+await role.ModifyAsync(x =>
+{
+    x.Name = "cool boi";
+    x.Color = Color.Gold;
+    x.Hoist = true;
+    x.Mentionable = true;
+});
+```
+
+---
+uid: Discord.GuildUserProperties
+example: [*content]
+---
+
+The following example uses @Discord.IGuildUser.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+var user = guild.GetUser(id);
+if (user == null) return;
+
+await user.ModifyAsync(x =>
+{
+    x.Nickname = "I need healing";
+});
+```
+
+---
+uid: Discord.SelfUserProperties
+example: [*content]
+---
+
+The following example uses @Discord.ISelfUser.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+await selfUser.ModifyAsync(x =>
+{
+    x.Username = "Mercy";
+});
+```
+
+---
+uid: Discord.WebhookProperties
+example: [*content]
+---
+
+The following example uses @Discord.IWebhook.ModifyAsync* to
+apply changes specified in the properties,
+
+```cs
+await webhook.ModifyAsync(x =>
+{
+    x.Name = "very fast fox";
+    x.ChannelId = newChannelId;
+});
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md b/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md
new file mode 100644
index 000000000..29b547e49
--- /dev/null
+++ b/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md
@@ -0,0 +1,24 @@
+---
+uid: Discord.Commands.OverrideTypeReaderAttribute
+remarks: *content
+---
+
+This attribute is used to override a command parameter's type reading
+behaviour. This may be useful when you have multiple custom
+@Discord.Commands.TypeReader and would like to specify one.
+
+---
+uid: Discord.Commands.OverrideTypeReaderAttribute
+examples: [*content]
+---
+
+The following example will override the @Discord.Commands.TypeReader
+of @Discord.IUser to `MyUserTypeReader`.
+
+```cs
+public async Task PrintUserAsync(
+    [OverrideTypeReader(typeof(MyUserTypeReader))] IUser user)
+{
+    //...
+}
+```
\ No newline at end of file
diff --git a/docs/_overwrites/Common/images/embed-example.png b/docs/_overwrites/Common/images/embed-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..f23fb4d70d797dd65e40fae54e84cd1935dd8608
GIT binary patch
literal 15290
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
SbOG+k1(6n45UUk23i@BYql`=d

literal 0
HcmV?d00001

diff --git a/docs/_overwrites/Common/images/react-example.png b/docs/_overwrites/Common/images/react-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..822857d3d108f151a2c7b3e75614f8830373aa68
GIT binary patch
literal 8994
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
IWt)5d2bHp1(f|Me

literal 0
HcmV?d00001

diff --git a/docs/_template/description-generator/plugins/DocFX.Plugin.DescriptionGenerator.dll b/docs/_template/description-generator/plugins/DocFX.Plugin.DescriptionGenerator.dll
new file mode 100644
index 0000000000000000000000000000000000000000..3e3a6fb7c829f3fb32d11d8184600bc557e6c7ad
GIT binary patch
literal 9216
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
LzvcY@?t%XV?WM^?

literal 0
HcmV?d00001

diff --git a/docs/_template/description-generator/plugins/LICENSE b/docs/_template/description-generator/plugins/LICENSE
new file mode 100644
index 000000000..eb92c0a03
--- /dev/null
+++ b/docs/_template/description-generator/plugins/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Still Hsu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/docs/_template/last-modified/plugins/LICENSE b/docs/_template/last-modified/plugins/LICENSE
new file mode 100644
index 000000000..eb92c0a03
--- /dev/null
+++ b/docs/_template/last-modified/plugins/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Still Hsu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/docs/_template/last-modified/plugins/LastModifiedPostProcessor.dll b/docs/_template/last-modified/plugins/LastModifiedPostProcessor.dll
new file mode 100644
index 0000000000000000000000000000000000000000..d91cf08737e9e605e894d2c405a369f5966a9ef6
GIT binary patch
literal 11776
zcmeHN4{#h;dH>$t-tOvbUvww=U#!S$J2HnYT_o8tv9TS?`r|0JY}u0RIEc!pyOp%~
z?)JR9XG_FRWKxotffjd$gp@Xr0&P=BNJ=1S(l7%g1-A{*nKFzACcvaaLkoreNlJi;
z`}^MR-AS^YDRibY?XdEG`+eX0-uJ$L@9leg9=QF36d@uN_oYijPvgngE(zZp%%VBI
z`k6RAS@+_ar^UV(*9=eDo>_98NjFn4vzcPi@y&6|bjwB4E}A_DhRlMKv(ihJ#I6rj
z5B3u66A{|>`bU1JGTQfOt+`0F6S0sHaAVzgnz)bQCaRaX64=cQjR9XD!wo)P5jyr>
z7Uh4nXGk&&*VDU+4lr_z=y?vp!fTdjF?gToA{t)U_GYwMHC;*>pl_KYpZ2Y3A9VdX
z0JKS8L%TuA%Y;>F*K@O=q;1E5u%qj7&$)IXU1`_KI}l`BX%;u@YQ;V0+C>C!=U+bx
zIc%FkQEG+m=~YBxzSw`8ibXcis`e<o8w&6*k-CN`mIAi1rA=MmxG|bafYH*nbiHhG
zlAxRh28{qQ7m_6{wG?<GuGBIhE~rwKia5)`yAxqhTiTYdzcUKt4Q&wu<E=nL%PhB~
z;QdDDTF{GbdJeYh4qS>YHk>9roa+FV+{EQp=QIOvP$SN2JPpSLOs!#7R86X>wZI%C
zDCB944Th44E=xr)S_;J(Yp6@srCJ!#(Xd=LG#D?Xq%+cFgfr$ADh@CO!4wKjYtUaJ
z;0Z0ECyW%_(CVDGpncoqrAwDyiq*A(PJ#Z89<XncY`s;}1Gf8PXjSfjD)s$o1UvOs
z2-m{2fmxikZ_xVJD1}%Eg&w4jZ51)*Ds+~<J{aH)?Hc7Ij}nbBwN+D>r(+xA?uejL
zY@_Dh!A}ngV=eAk;Lb*go&&16p8|}eP-!uzjoHf`7!zw*=G=fs3X>Sgj;wFokm>;H
zbOLPXjHEVk<7Or>ZUgGYN8%CIg!>uji@tv)%#En28zE5*qqhZAOjDh=;i)+{0lNRl
z=4=JFNN>Bwy;%thWg9pfH1}@M&f9@6Hr#uG2YO|oob6z1?zbxvOY}Nt2UzQMBY4Ku
z)K1XbE^uJ96sk(o-0xS!8`OmA{t%S=Dzk3pp5VMK0?rPAfTOtw8D|R`qKT;c4yJ;E
zYnq_;vsEcwbDymeM#2cjc!62L7)D%mc0r$1!<7?Q%T*L&Y9d<2v;fl+YJebkUFfU?
zWwZRYGh96z8roI*Gq?#N5eee@B9F*%jkw>g*n@EWka2dPCDc5pd6DiGRk%M55E!ew
zA7;kKYK*{&aEz_d>KJ<%4HI<`xO<ct(qqGQm@!jh1WGnED=Dm9TtK|u7^ol2p@i~&
zWNKBL(zxLodSe;mPB)~S9ssWwAa-XTpj<lk0C_{h$`|wcnK#QVJcl<rdx0&w=|KcV
zclH5aYy^rModK3?)7HChz@jB}Wvo1_S{l^Wb(-PqN1GedU~WA?LgjhBF*OLTa}Z#C
zT}y*j#tOZvbwfh?BqI$`&4rbvWHfaM5_k;Zk;0oM?6Pr1AP^|8o6{053!@8`1x>C!
z8wB2Y3hkp${U^oX1*JVav{{5mtwydd;*4M*7sXvl9R{``?H$2m_BO^V@okPszYyo$
zL$~f0;hO=*)5*>0_VlLqO&ur{j(#5S8wmNjJBhaIc&*g|AM#zhIO(y(C~Vrr?IT0<
z2Uyub(z-n({m2b{8uZ^HT<dn{opBb%g+*K(S*;j#aS%Tjn+P&UGhzPA*PwwXH}TDU
zn9XYl;g!R+Kud5lpXH!S-WUQ`ca-_8<;ln<U84?_;WrdhzlMfjxkkTGKA>u}LVYT#
z(R762k0pFS!W$(#B;nsn_zw!p+!s9!IH8=5#t?}|^*9;otKeK~oQ@{x!}J6e+&hg&
zF;<aYMPi&N<L4y49r7Bjfuu%;b~?I@ZZ!nptPtRQPGJk*L)`k9_M)ND8I4EWi@qBD
z(qR08&QM58J|iu8L_Hn7mM&;XEk-Y4tY-Rs@jl=e<hZ|7pGDu-wU?p!lY%v$hW@pb
z*Gzpay{4Ps-><RE$0dA8Fdm0@%cwCTqRn)a-lu6a1WP!Yf6f3A#~;GGO}SZY4Jc&#
zyV}j7A1jQYvnb8YQKm3!DYB-X{uRBLs*@BZH7FfB8BO~N<(0#;k1Gz~%Z8%}I<M!I
zE%X?9$})N@os#(H#WLvqv=}tem3|<;PP3344yo7l-&GV+*K*rg`Yr7NMI}F^z9t@0
zH2Uq3x?lN(qLX@kAel8DRTj}RlDcO_17fk5o|n}9G_HSESxm3Au;lp_EA?lTCG;PX
z3M7}%FC}$1b<!8m7GGbJjMKG}3MAvSR#JDP8onTcO8zc{1>K9XRp>7<Uj#jlvQ?;G
zso)jPYv4!dPnG(5mD;3aGa@hOgXk;hVhAJDh1fRef)aoltptoAdJTF#bx62X!Y&E>
zB|IqMQ3*2=+7g}vTuMI#)F>f-YIM;`u{N>?mGDq>1f18!QCcH@FFHo&=}*)V>JW<!
zi?)ir+HrcA?$v!nu|a<i^^4=mebh)%{V{5yBgPl#3Hn3*%XCmg^$XYxGv{G?78;(Q
z?*bkbor;AGZC3qf`XYS|oD1|p<)?tlmDiyEjB=bZ;(6m2WQ+Td(+<&KT%sAlcFu?&
zq2}0<Ix!>OfY&qP5hDTofSM3z#k8>u@P1>pI4>+QLJx}dqD5SwcB56Wo_=vr`g@VK
zLC-}xCk~45lOqm`t)gBW2WPu+7@SPBp1u!DN6{-$mj$PwP659gk-13ssr85n+jE`{
zDG!Pnn$aH;uS?E$Wb4ynJL>xLfLsYZVU)gYd`;|=Q5u#p5#lbDl)n%!!_E%zfoNP|
zzg8=+(_57FN{(JZ+;TEXZ22bT3A$Zj$!Og+B`?Ry%TWx>y>Z1rHYSxMYGGVS(;|8v
zuz_9#Ttz<uTt}}0Zlvx=nl{lPz_-&FU^krv+)MukI7F8K-$5}oO<BM!9jCXdA14o*
zzbs)BMa5=OLcHHie@su&x9DZMUwl%$Abui#CUm7$*`=tnT(Lr~(L7fOD~8;W1O(t7
z<rRr5gk5s=dK9ZQ_as^!@&>V~4tR=u8!$eoJRui+ffWcZC3ziHgp`}FFNskXj(Y<0
zZXxfq>>I@h8t<EMEv6UbGlAzC8brJvrVr68;-j>R`)}X5b!@DCtev*+vHU~UMBd8!
zR&LOBN|x)}mbY^}Y-YJmmP1?C@??XgcV;1Rtb_V{i{*mlX2$atQwQ9f<yyJ<%#iXO
zmqm*HrcUZB7qiDYX|FYNIFm11gBjZe*<UD>eOA?DXMNi#X51NYVJvMQaB}6mwUdTs
zJl`s$`w!p%e3HA4jnSZMl`^h1VELI`#?Mfpig;Pa&D-Npk*)OXcJk~kw0r42R?%|p
zEbVh9d+f|)(eZpxQ+^@egX1egvoGWMM_k*thV6ni;<IEXM`-MuP7mhGlXfx9A~4RL
zu&o?*l}c7I*F9zDb9Bhc<c6KzVvdF^9&rdekG!=XpB(5Gj3ALo%O8U_M6l>fMlEpE
z-(!0v$K!BZ$@Xfj*v_hreXdjJv(bY!@6Qx0@_;Z$5)hToF3+<H<M|m$^kf46XxJGk
z+9xg7%jDVL(3^dB(V}jrFdjY&wvQf};hB;}9Bzp~v3&Bd6^A6_$Q0_KW<PKQ`>^GX
zJDx>>hZYTHTu{=9N+{VV!uJ^&S4qHx68vyw($Jdg^0Av6FGH@!8ZS>ya-?d!ii^Xx
zKbJk6abaU0J_%W;9QSxlo^w*8;7@ni^PNJCRZ+;ngaaNb=<>$?;)LTCGO~E{SC#5^
ziWBx^*_CpaE9tSktZSE8Nv$z(U-md;<ulU~^J?uC^Dt3!<*a{sL$_0!aqY>eIZeIO
zCC8mZS9I`Lnc_@M$Dwl3M@2}!Z;#t~+n>|QB{t$&LsM2h-#cw(IVD^Oa%!XcYa;|4
z1UGEToUGPHI7B)O8YT<sG1#w@=ak(n772e!>K&5g?u=JsaY%gB?gE*4Y^Us(%D$A4
z$)1#M3}&*&YxP;cjI%lL>8kTNl%$o%be5|mnnrv(PjjdJAl8j=eRSM(E}xf^uD^)I
zg$JU6OwpdOJii|+S2z?6yLN$iw$rVST@1n%6qUrUR7VvnYnIRf=@M6DZCRT)+#Ghe
za&itsAE|dbYsoUB0XyqDo-^U6F?+kbZvHR|$%0d?PC~3_9?05|Y$MNR`5eG{V!0CK
zxr45@FR3svLw?4sGWabsBU?kGu*RGqB-_dqc-gdE8papN5Dki8cNvQ+8iFkLIg-HW
zli>Bw%fQuhQ+-?ERm96??ZrgtEc4P?`3SA5y%W4@?1PEGv5||>kma7V@nQ^@AXF_^
zi^s~Z@LFXy;t{@NWuiHE9*t#kIV%_7lbAWRAbVF#P4MpVXu%rQJMCLVUYM%(*7EP+
zH7Q@=vN*fkN%_)&3a6OO_|zwtEjlp%F1)IU7hHY?9GIBE<R+&y)?X;)?X2xnH<ILA
zy?Kk@S@KO*S?{Gk-DTJ1hW;We;^8wTEDdr!LxxcV)%v7DI4{U9Vq(hfkSOLdZY~Ib
zH1&{`vt53F&TkrUPFnl<vvrs(E*P37xdGWdL%W^ajMRuNhD^0wmyn;z8plrco+xK{
zDWiUGe>tB&;Pw_upzsm!Fj?eczi5*~McPIt(UINYO@dPdmBGF?C-F&8dC(sDzzUFO
z{seBk9>K|>%?EA*I)JvM3Xo6BKf0?A5;k-M@`2O@C?7l6DfGyqUjcvIv!<^V_yl_9
z@y9l?9pj*R$6Fc8qZw%z-lX82f=9vV+-`$s!2+7>f{nRw^ttwDrR6~cYU5UP-$Ctk
z23py=BA`VjXe~>NI6kf%BP;!4U#X=9QXG*s{8gf|19o`Oa1(8Tz77)67XDd4=Q!gR
zi8Xn&v1e^)3wlm~<HB~1>JAbSWae#0LeDC3sMt0EKF7|aJJ6r44WfGoPQqu9(HrQ7
z1(v=e^v4IEwRx1HUEl>7_HgDivEvVX=ByT>F^Fsi{=Wrhmv@rr?waTQe%QeAH6iUt
zdG?_UDkt^1XyeGa-~=8ZT9Fdb&@l4P@iC!0gE+8`Q^1(>W;MsLVV{ExrDz13<!;yp
zz0oO*Lps;!NuotH&!~&N;%Z_~JdD*=^)rYC&xqQ%ZHVjqS{G3p9#I3=AnS5L1=T}!
zp7fxIm~V$}_J(IsZS)<q7CaY!4m@nbb1m(p?Z{6>dM7-XI}Zk6p@+X9E<!J%kA)vm
zcw~+?>C><fUjdhJmd7O*Q+tVrQF$J4wbJa}OK`w7@pnBE%@c~#l0{QscnU$|Kvtw`
zl524sz1-2YkmfMY52cOad3v+9w^wy>IWkRkKBj4jO<v6<HI314pm#z0N!;_y)jgP=
zh1m~GLC8lZ4{H<q$1|&lfn9VtC08jwG@~Gu1=%QKZE&UZ+)P)@y8-bE)-ldBn{Wc*
zV0`APE~U|jYc>sOd{&jQo<bj9AE_=_nT{hDoEzj~DX)?<G8i6e+rl5RP{%cCA^6D0
z|Au2%&JJgd3yK!?!YM8fluJ}D{ZXFwln5pibAsiBmU2lhT>S9*xcFo3TVMa_J$q;0
zx&3od?Xh#DnnD;@szek>BEe)_GZhg}?zmo$#g`^WMDl3zC_k4b-l@csneY*hCoKGn
z5+!HP8TCRmGor>svJL9uQ4{2O2|pAiB_59(_`HEfJZO4YUz(gzl1G&&25VZeqFyLV
zle6!Img-|hX(ojg9)&ELl1B{_ts|m=w7@Ra#Ag^e#v@CDrqH-WbL`ba9t-1BhJe{X
z6Bevgq-9MJUBvN0QyRws!1o@Joc&^Q_BpBh1$-<{%>Erj&=*LfUY9H+Pt5<5{hOMa
zpgMU1u}q#o7y*+f@G)13>!y;N{U(B-M}mG$x}H2Ey_h|loITqlJ#1oAp#+Yzo*kM=
z*P#*Ku0UYw@I=UF&&GAhK^RQrY4)s9;jgS$IEoh+MzL9FG1(E49LU+Th$s>Z)h5Qf
zt_k|UZ(58j#F2BEhe%8`X%q=ECX#33T40^zH8ml0kPQtno_hD_;gy@ecg}eH=CQjH
z-;8ZDp6mF?%76OzC%37nI#LCIq8Sk_fjik~1g;!a;-*-d98lu$pCO0oVDcbWAnMCN
z9FZ-<R8crUxI~i$4Yd|;=5JP9vnV0_riCxKxbRUI-?NovN8C(lzf-K9A%>@1=aeTP
zr%1U0K~3rXy~EYBc58UF+ku~Iwxm0tB;HtU<WB+ljQk+c$i2*Jiz%h!g6f8F@XDLF
zcx8Ow5~SmBha-tav<%;pt8M0&9x*%HJMe=neknfLW#X{ox0Qmeuj85}`PIh6Dc!`r
zweL3bWT)v*WqcDma1WSe=J7$t%*q3dnZs7sbS5M}i;Xf)OV}}*x$u*X={vFs-+U@k
zrOc#-*DTxDk?u%$rrYuJm7u63WbjsA_2`K8?;$}~Z@=qGr?l`Wke+`AYBk?Pw$-d;
zqBFf|D}FX>Z#BEidB5yhJBn7>cQg4`bFe&)4L^3z!_IN5xTA>uu}mw2d($lskr)`{
zL_di8XI;40aZ7M<9X8<RZ=>gT<Gw!NS0Mk^HupL-)H8JF-oJU_uQ&e7-aq<i{vPc}
z^X;sod)p|!E4be1rp+Cjw~Pj#0Y>q)&+$e%dsqAj_a-gQ_`62Ksu?X>{^l(mqgPEv
zx|AEIp<B8-Z`?wmZO@K}w!#1AFMai|eqev)$&T;bxaqp@!N<z=bH>dIHUC-p|1AM`
ztlM#W^7(-b&i@7eQfXQ8;{mr`YJrZ0VVbY(|2-vS09IgD%y*U7AHv@Daz4x5g8Q~(
zL{oA}WDet-0T1KXfib{dIs~jA|I=ze=zhSy;D24wbLvmt2)_LD2nxmtp7`xwUaXR9
ze(u!+LO?6;Ui+{Y;*DNEHU+%L=j(dnUc+eRJ+Fs$-kpd0Vkz;s`c+<LVUrK3-~@2F
zrcX$jcK99qZN{b&F(6HxLSNp9@EI{Uk?;@PT_~UuxV+<P1I9aRKBe&%hj)YAn#caG
za-t2+RVMXFxjy`UZDIr33Fu>|7Mv)8Q!k%Bn8&A)+9`xLRhOSqO>igX$g|YK4HKU&
z*|u`k{>nM6G75XeC&&4^DrX`rx41TABVUO_aK4y9X7OVH?Bt81%h}08&n<`nULrI~
z*P>4));%&hwbMZ@NBf|M<2V2d=AP~cK{J2wvgmSsVt-TBJ^y<G+tYzPGvA%KIgg{%
z40)~`J_PVtkk9rt4}NtU(y*2NC0LPw?tRcZDYbI7l(4<!YMVqRu?N3Gd`x--vFe0%
z9XOx!m6J9e2>WrRvW=DaF%?Ane`4#f%t;W@9J0iRv04=H|1&YlubvBRF2gKUbS}(D
xEguALId@$chtI(Ud3>8eEUw-s$e|3<Z@{k~fnEH|CGJhXzKY-U{J$H4{{m!ptcm~t

literal 0
HcmV?d00001

diff --git a/docs/_template/light-dark-theme/partials/affix.tmpl.partial b/docs/_template/light-dark-theme/partials/affix.tmpl.partial
new file mode 100644
index 000000000..aafcdf05b
--- /dev/null
+++ b/docs/_template/light-dark-theme/partials/affix.tmpl.partial
@@ -0,0 +1,33 @@
+{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
+
+<div class="hidden-sm col-md-2" role="complementary">
+  <div class="sideaffix">
+    <div class="theme-switch-field">
+      <p>Theme</p>
+      <select id="theme-switcher">
+        <option value="dark">Dark</option>
+        <option value="gray">Gray</option>
+        <option value="light">Light</option>
+      </select>
+    </div>
+    {{^_disableContribution}}
+    <div class="contribution">
+      <ul class="nav">
+        {{#docurl}}
+        <li>
+          <a href="{{docurl}}" class="contribution-link">{{__global.improveThisDoc}}</a>
+        </li>
+        {{/docurl}}
+        {{#sourceurl}}
+        <li>
+          <a href="{{sourceurl}}" class="contribution-link">{{__global.viewSource}}</a>
+        </li>
+        {{/sourceurl}}
+      </ul>
+    </div>
+    {{/_disableContribution}}
+    <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
+    <!-- <p><a class="back-to-top" href="#top">Back to top</a><p> -->
+    </nav>
+  </div>
+</div>
diff --git a/docs/_template/light-dark-theme/partials/head.tmpl.partial b/docs/_template/light-dark-theme/partials/head.tmpl.partial
new file mode 100644
index 000000000..94670f432
--- /dev/null
+++ b/docs/_template/light-dark-theme/partials/head.tmpl.partial
@@ -0,0 +1,27 @@
+{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
+
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <title>{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}</title>
+  <meta name="viewport" content="width=device-width">
+  <meta name="title" content="{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}">
+  <meta name="generator" content="docfx {{_docfxVersion}}">
+  {{#_description}}<meta name="description" content="{{_description}}">{{/_description}}
+  <link rel="preload" href="{{_rel}}styles/search-worker.js" as="script">
+  <link rel="preload" href="{{_rel}}fonts/glyphicons-halflings-regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
+  <link rel="shortcut icon" href="{{_rel}}{{{_appFaviconPath}}}{{^_appFaviconPath}}favicon.ico{{/_appFaviconPath}}">
+  <link rel="stylesheet" href="{{_rel}}styles/docfx.vendor.minify.css">
+  <link rel="stylesheet" href="{{_rel}}styles/docfx.css">
+  <link rel="stylesheet" href="{{_rel}}styles/master.css">
+  <link rel="stylesheet" href="{{_rel}}styles/main.css">
+  <link rel="stylesheet" href="{{_rel}}styles/theme-switcher.css">
+  <link href="https://cdn.rawgit.com/noelboss/featherlight/1.7.6/release/featherlight.min.css" type="text/css" rel="stylesheet" />
+  <meta name="theme-color" content="#99AAB5"/>
+  <meta property="docfx:navrel" content="{{_navRel}}">
+  <meta property="docfx:tocrel" content="{{_tocRel}}">
+  <meta id="docfx-style:rel" content="{{_rel}}">
+  {{#_noindex}}<meta name="searchOption" content="noindex">{{/_noindex}}
+  {{#_enableSearch}}<meta property="docfx:rel" content="{{_rel}}">{{/_enableSearch}}
+  {{#_enableNewTab}}<meta property="docfx:newtab" content="true">{{/_enableNewTab}}
+</head>
diff --git a/docs/_template/light-dark-theme/partials/scripts.tmpl.partial b/docs/_template/light-dark-theme/partials/scripts.tmpl.partial
new file mode 100644
index 000000000..1b048feb9
--- /dev/null
+++ b/docs/_template/light-dark-theme/partials/scripts.tmpl.partial
@@ -0,0 +1,10 @@
+{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
+
+<script type="text/javascript" src="{{_rel}}styles/docfx.vendor.js"></script>
+<script type="text/javascript" src="{{_rel}}styles/docfx.js"></script>
+<script type="text/javascript" src="{{_rel}}styles/main.js"></script>
+<script type="text/javascript" src="https://cdn.rawgit.com/noelboss/featherlight/master/release/featherlight.min.js" charset="utf-8"></script>
+<script type="text/javascript" src="{{_rel}}styles/plugin-featherlight.js"></script>
+<script type="text/javascript" src="{{_rel}}styles/styleswitcher.js"></script>
+<script type="text/javascript" src="https://malsup.github.io/jquery.corner.js"></script>
+<script type="text/javascript" src="{{_rel}}styles/cornerify.js"></script>
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/cornerify.js b/docs/_template/light-dark-theme/styles/cornerify.js
new file mode 100644
index 000000000..4430f2d01
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/cornerify.js
@@ -0,0 +1,3 @@
+window.onload = function (e) {
+    $('img').corner();
+}
diff --git a/docs/_template/light-dark-theme/styles/dark.css b/docs/_template/light-dark-theme/styles/dark.css
new file mode 100644
index 000000000..0a021b377
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/dark.css
@@ -0,0 +1,304 @@
+/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
+
+@import url('vs2015.css');
+html,
+body {
+    background: #212121;
+    color: #C0C0C0;
+}
+
+button,
+a {
+    color: #64B5F6;
+}
+
+.sidenav{
+  background-color: rgb(30, 30, 30);
+}
+
+button:hover,
+button:focus,
+a:hover,
+a:focus,
+.btn:focus,
+.btn:hover{
+    color: #2196F3;
+}
+
+a.disable,
+a.disable:hover {
+    color: #EEEEEE;
+}
+
+.divider {
+    color: #37474F;
+}
+
+hr {
+    border-color: #37474F;
+}
+
+.subnav {
+    background: #383838
+}
+
+.inheritance h5,
+.inheritedMembers h5 {
+    border-bottom: 1px solid #37474F;
+}
+
+article h4 {
+    border-bottom: 1px solid #37474F;
+}
+
+.docs-search {
+    background: #424242;
+}
+
+.search-results-group-heading {
+    color: #424242;
+}
+
+.search-close {
+    color: #424242;
+}
+
+.sidetoc {
+    background-color: #1b1b1b;
+    border-left: 0px solid #37474F;
+    border-right: 0px solid #37474F;
+}
+
+.sideaffix {
+    overflow: visible;
+}
+
+.sideaffix>div.contribution>ul>li>a.contribution-link:hover {
+    background-color: #333333;
+}
+
+/* toc */
+
+.toc .nav>li>a {
+    color: rgb(218, 218, 218);
+}
+
+.toc .nav>li>a:hover,
+.toc .nav>li>a:focus {
+    color: #E0E0E0;
+}
+
+.toc .nav>li.active>a {
+    color: #90CAF9;
+}
+
+.toc .nav>li.active>a:hover,
+.toc .nav>li.active>a:focus {
+    background-color: #37474F;
+    color: #4FC3F7;
+}
+
+.sidefilter {
+    background-color: #1b1b1b;
+    border-left: 0px solid #37474F;
+    border-right: 0px solid #37474F;
+}
+
+.affix ul>li>a:hover {
+    background: none;
+    color: #EEEEEE;
+}
+
+.affix ul>li.active>a,
+.affix ul>li.active>a:before {
+    color: #B3E5FC;
+}
+
+.affix ul>li>a {
+    color: #EEEEEE;
+}
+
+.affix>ul>li.active>a,
+.affix>ul>li.active>a:before {
+    color: #B3E5FC;
+}
+
+.tryspan {
+    border-color: #37474F;
+}
+
+.footer {
+    border-top: 1px solid #5F5F5F;
+    background: #616161;
+}
+
+/* alert */
+.alert-info {
+    color: #d9edf7;
+    background: #004458;
+    border-color: #005873;
+}
+
+.alert-warning {
+    color: #fffaf2;
+    background: #80551a;
+    border-color: #99661f;
+}
+
+.alert-danger {
+    color: #fff2f2;
+    background: #4d0000;
+    border-color: #660000;
+}
+
+/* For tabbed content */
+
+.tabGroup {
+    margin-top: 1rem;
+}
+
+.tabGroup ul[role="tablist"] {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+}
+
+.tabGroup ul[role="tablist"]>li {
+    list-style: none;
+    display: inline-block;
+}
+
+.tabGroup a[role="tab"] {
+    color: white;
+    box-sizing: border-box;
+    display: inline-block;
+    padding: 5px 7.5px;
+    text-decoration: none;
+    border-bottom: 2px solid #fff;
+}
+
+.tabGroup a[role="tab"]:hover,
+.tabGroup a[role="tab"]:focus,
+.tabGroup a[role="tab"][aria-selected="true"] {
+    border-bottom: 2px solid #607D8B;
+}
+
+.tabGroup a[role="tab"][aria-selected="true"] {
+    color: #81D4FA;
+}
+
+.tabGroup a[role="tab"]:hover,
+.tabGroup a[role="tab"]:focus {
+    color: #29B6F6;
+}
+
+.tabGroup a[role="tab"]:focus {
+    outline: 1px solid #607D8B;
+    outline-offset: -1px;
+}
+
+@media (min-width: 768px) {
+    .tabGroup a[role="tab"] {
+        padding: 5px 15px;
+    }
+}
+
+.tabGroup section[role="tabpanel"] {
+    border: 1px solid #607D8B;
+    padding: 15px;
+    margin: 0;
+    overflow: hidden;
+}
+
+.tabGroup section[role="tabpanel"]>.codeHeader,
+.tabGroup section[role="tabpanel"]>pre {
+    margin-left: -16px;
+    margin-right: -16px;
+}
+
+.tabGroup section[role="tabpanel"]> :first-child {
+    margin-top: 0;
+}
+
+.tabGroup section[role="tabpanel"]>pre:last-child {
+    display: block;
+    margin-bottom: -16px;
+}
+
+.mainContainer[dir='rtl'] main ul[role="tablist"] {
+    margin: 0;
+}
+
+/* code */
+
+code {
+    color: white;
+    background-color: #4a4c52;
+    border-radius: 4px;
+    padding: 3px 7px;
+}
+
+pre {
+    background-color: #282a36;
+}
+
+/* table */
+
+.table-striped>tbody>tr:nth-of-type(odd) {
+    background-color: #333333;
+    color: #d3d3d3
+}
+
+tbody>tr {
+    background-color: #424242;
+    color: #c0c0c0
+}
+
+.table>tbody+tbody {
+    border-top: 2px solid rgb(173, 173, 173)
+}
+
+/* select */
+
+select {
+    background-color: #3b3b3b;
+    border-color: #2e2e2e;
+}
+
+/* 
+    Following code regarding collapse container are fetched 
+    or modified from the Materialize project.
+
+    The MIT License (MIT)
+    Copyright (c) 2014-2018 Materialize
+    https://github.com/Dogfalo/materialize
+*/
+
+/* all collapse container */
+.collapse-container.last-modified {
+    -webkit-box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
+    box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
+    border-top: 1px solid rgba(96, 96, 96, 0.7);
+    border-right: 1px solid rgba(96, 96, 96, 0.7);
+    border-left: 1px solid rgba(96, 96, 96, 0.7);
+}
+
+/* header */
+.collapse-container.last-modified>:nth-child(odd) {
+    background-color: #3f3f3f;
+    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
+}
+
+/* body */
+.collapse-container.last-modified>:nth-child(even) {
+    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
+    background-color: inherit;
+}
+
+span.arrow-d{
+    border-top: 5px solid white
+}
+
+span.arrow-r{
+    border-left: 5px solid white
+}
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/docfx.vendor.minify.css b/docs/_template/light-dark-theme/styles/docfx.vendor.minify.css
new file mode 100644
index 000000000..f9eb380d6
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/docfx.vendor.minify.css
@@ -0,0 +1,1022 @@
+@font-face {
+    font-family: 'Glyphicons Halflings';
+    font-display: fallback;
+    src: url(../fonts/glyphicons-halflings-regular.eot);
+    src: url(../fonts/glyphicons-halflings-regular.eot?#iefix) format('embedded-opentype'), url(../fonts/glyphicons-halflings-regular.woff2) format('woff2'), url(../fonts/glyphicons-halflings-regular.woff) format('woff'), url(../fonts/glyphicons-halflings-regular.ttf) format('truetype'), url(../fonts/glyphicons-halflings-regular.svg#glyphicons_halflingsregular) format('svg')
+}
+
+body {
+    margin: 0;
+}
+
+html {
+    font-family: sans-serif;
+    -webkit-text-size-adjust: 100%;
+    -ms-text-size-adjust: 100%;
+}
+
+article,
+footer,
+header,
+nav {
+    display: block;
+}
+
+a {
+    background-color: transparent;
+}
+
+a:active,
+a:hover {
+    outline: 0;
+}
+
+strong {
+    font-weight: 700;
+}
+
+h1 {
+    margin: .67em 0;
+}
+
+svg:not(:root) {
+    overflow: hidden;
+}
+
+pre {
+    overflow: auto;
+}
+
+code,
+pre {
+    font-size: 1em;
+}
+
+button,
+input,
+select {
+    margin: 0;
+    font: inherit;
+    color: inherit;
+}
+
+.glyphicon {
+    font-style: normal;
+}
+
+button {
+    overflow: visible;
+}
+
+button,
+select {
+    text-transform: none;
+}
+
+button {
+    -webkit-appearance: button;
+    cursor: pointer;
+}
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+    padding: 0;
+    border: 0;
+}
+
+table {
+    border-spacing: 0;
+    border-collapse: collapse;
+}
+
+td,
+th {
+    padding: 0;
+}
+
+@media print {
+
+    pre,
+    tr {
+        page-break-inside: avoid;
+    }
+
+    *,
+    :after,
+    :before {
+        color: #000 !important;
+        text-shadow: none !important;
+        background: 0 0 !important;
+        -webkit-box-shadow: none !important;
+        box-shadow: none !important;
+    }
+
+    a,
+    a:visited {
+        text-decoration: underline;
+    }
+
+    a[href]:after {
+        content: " ("attr(href) ")";
+    }
+
+    a[href^="#"]:after {
+        content: "";
+    }
+
+    pre {
+        border: 1px solid #999;
+    }
+
+    thead {
+        display: table-header-group;
+    }
+
+    h3,
+    p {
+        orphans: 3;
+        widows: 3;
+    }
+
+    h3 {
+        page-break-after: avoid;
+    }
+
+    .navbar {
+        display: none;
+    }
+
+    .table {
+        border-collapse: collapse !important;
+    }
+
+    .table td,
+    .table th {
+        background-color: #fff !important;
+    }
+
+    .table-bordered td,
+    .table-bordered th {
+        border: 1px solid #ddd !important;
+    }
+}
+
+.collapsing,
+.dropdown,
+.dropup {
+    position: relative
+}
+
+.collapsing {
+    height: 0;
+    overflow: hidden;
+    -webkit-transition-timing-function: ease;
+    -o-transition-timing-function: ease;
+    transition-timing-function: ease;
+    -webkit-transition-duration: .35s;
+    -o-transition-duration: .35s;
+    transition-duration: .35s;
+    -webkit-transition-property: height, visibility;
+    -o-transition-property: height, visibility;
+    transition-property: height, visibility
+}
+
+.btn,
+.btn:active,
+.form-control,
+.navbar-toggle {
+    background-image: none;
+}
+
+body {
+    background-color: #fff;
+}
+
+.glyphicon {
+    position: relative;
+    top: 1px;
+    display: inline-block;
+    font-family: 'Glyphicons Halflings';
+    font-weight: 400;
+    line-height: 1;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+}
+
+.glyphicon-refresh:before {
+    content: "\e031";
+}
+
+.glyphicon-filter:before {
+    content: "\e138";
+}
+
+*,
+:after,
+:before {
+    -webkit-box-sizing: border-box;
+    -moz-box-sizing: border-box;
+    box-sizing: border-box;
+}
+
+html {
+    font-size: 10px;
+    -webkit-tap-highlight-color: transparent;
+}
+
+body {
+    font-size: 14px;
+    line-height: 1.42857143;
+    color: #333;
+}
+
+button,
+input,
+select {
+    font-family: inherit;
+    font-size: inherit;
+    line-height: inherit;
+}
+
+a {
+    color: #337ab7;
+    text-decoration: none;
+}
+
+a:focus,
+a:hover {
+    color: #23527c;
+    text-decoration: underline;
+}
+
+a:focus {
+    outline: -webkit-focus-ring-color auto 5px;
+    outline-offset: -2px;
+}
+
+.sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    border: 0;
+}
+
+h1,
+h3,
+h4,
+h5,
+h6 {
+    font-family: inherit;
+    font-weight: 500;
+    line-height: 1.1;
+    color: inherit;
+}
+
+h1,
+h3 {
+    margin-top: 20px;
+    margin-bottom: 10px;
+}
+
+h4,
+h5,
+h6 {
+    margin-top: 10px;
+    margin-bottom: 10px;
+}
+
+h1 {
+    font-size: 36px;
+}
+
+h3 {
+    font-size: 24px;
+}
+
+h4 {
+    font-size: 18px;
+}
+
+h5 {
+    font-size: 14px;
+}
+
+h6 {
+    font-size: 12px;
+}
+
+p {
+    margin: 0 0 10px;
+}
+
+pre {
+    line-height: 1.42857143;
+}
+
+.small {
+    font-size: 85%;
+}
+
+pre code,
+table {
+    background-color: transparent;
+}
+
+ul {
+    margin-top: 0;
+}
+
+ul ul {
+    margin-bottom: 0;
+}
+
+ul {
+    margin-bottom: 10px;
+}
+
+@media (min-width:768px) {
+    .container {
+        width: 750px;
+    }
+}
+
+code {
+    padding: 2px 4px;
+    font-size: 90%;
+}
+
+th {
+    text-align: left;
+}
+
+pre {
+    display: block;
+    padding: 9.5px;
+    margin: 0 0 10px;
+    font-size: 13px;
+    word-break: break-all;
+    word-wrap: break-word;
+    color: #333;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+}
+
+.container {
+    margin-right: auto;
+    margin-left: auto;
+}
+
+pre code {
+    padding: 0;
+    font-size: inherit;
+    color: inherit;
+    white-space: pre-wrap;
+    border-radius: 0;
+}
+
+.container {
+    padding-right: 15px;
+    padding-left: 15px;
+}
+
+@media (min-width:992px) {
+    .container {
+        width: 970px;
+    }
+}
+
+@media (min-width:1200px) {
+    .container {
+        width: 1170px;
+    }
+}
+
+.row {
+    margin-right: -15px;
+    margin-left: -15px;
+}
+
+.col-md-10,
+.col-md-2 {
+    position: relative;
+    min-height: 1px;
+    padding-right: 15px;
+    padding-left: 15px;
+}
+
+@media (min-width:992px) {
+
+    .col-md-10,
+    .col-md-2 {
+        float: left;
+    }
+
+    .col-md-10 {
+        width: 83.33333333%;
+    }
+
+    .col-md-2 {
+        width: 16.66666667%;
+    }
+}
+
+.table {
+    width: 100%;
+    max-width: 100%;
+    margin-bottom: 20px;
+}
+
+.table>tbody>tr>td,
+.table>thead>tr>th {
+    padding: 8px;
+    line-height: 1.42857143;
+    vertical-align: top;
+    border-top: 1px solid #ddd;
+}
+
+.table>thead>tr>th {
+    vertical-align: bottom;
+    border-bottom: 2px solid #ddd;
+}
+
+.table>thead:first-child>tr:first-child>th {
+    border-top: 0;
+}
+
+.table-condensed>tbody>tr>td,
+.table-condensed>thead>tr>th {
+    padding: 5px;
+}
+
+.table-bordered,
+.table-bordered>tbody>tr>td,
+.table-bordered>thead>tr>th {
+    border: 1px solid #ddd;
+}
+
+.table-bordered>thead>tr>th {
+    border-bottom-width: 2px;
+}
+
+.table-striped>tbody>tr:nth-of-type(odd) {
+    background-color: #f9f9f9;
+}
+
+.table-responsive {
+    min-height: .01%;
+    overflow-x: auto;
+}
+
+@media screen and (max-width:767px) {
+    .table-responsive {
+        width: 100%;
+        margin-bottom: 15px;
+        overflow-y: hidden;
+        -ms-overflow-style: -ms-autohiding-scrollbar;
+        border: 1px solid #ddd;
+    }
+
+    .table-responsive>.table {
+        margin-bottom: 0;
+    }
+
+    .table-responsive>.table>tbody>tr>td,
+    .table-responsive>.table>thead>tr>th {
+        white-space: nowrap;
+    }
+
+    .table-responsive>.table-bordered {
+        border: 0;
+    }
+
+    .table-responsive>.table-bordered>tbody>tr>td:first-child,
+    .table-responsive>.table-bordered>thead>tr>th:first-child {
+        border-left: 0;
+    }
+
+    .table-responsive>.table-bordered>tbody>tr>td:last-child,
+    .table-responsive>.table-bordered>thead>tr>th:last-child {
+        border-right: 0;
+    }
+
+    .table-responsive>.table-bordered>tbody>tr:last-child>td {
+        border-bottom: 0;
+    }
+}
+
+.form-control {
+    font-size: 14px;
+    line-height: 1.42857143;
+    color: #555;
+    display: block;
+}
+
+.form-control {
+    width: 100%;
+    height: 34px;
+    padding: 6px 12px;
+    background-color: #fff;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, .075);
+    box-shadow: inset 0 1px 1px rgba(0, 0, 0, .075);
+    -webkit-transition: border-color ease-in-out .15s, -webkit-box-shadow ease-in-out .15s;
+    -o-transition: border-color ease-in-out .15s, box-shadow ease-in-out .15s;
+    transition: border-color ease-in-out .15s, box-shadow ease-in-out .15s;
+}
+
+.form-control:focus {
+    border-color: #66afe9;
+    outline: 0;
+    -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, .075), 0 0 8px rgba(102, 175, 233, .6);
+    box-shadow: inset 0 1px 1px rgba(0, 0, 0, .075), 0 0 8px rgba(102, 175, 233, .6);
+}
+
+.form-control::-moz-placeholder {
+    color: #999;
+    opacity: 1;
+}
+
+.form-control:-ms-input-placeholder {
+    color: #999;
+}
+
+.form-control::-webkit-input-placeholder {
+    color: #999;
+}
+
+.form-control::-ms-expand {
+    background-color: transparent;
+    border: 0;
+}
+
+.form-group {
+    margin-bottom: 15px;
+}
+
+.btn {
+    display: inline-block;
+    padding: 6px 12px;
+    margin-bottom: 0;
+    font-size: 14px;
+    font-weight: 400;
+    line-height: 1.42857143;
+    text-align: center;
+    white-space: nowrap;
+    vertical-align: middle;
+    -ms-touch-action: manipulation;
+    touch-action: manipulation;
+    cursor: pointer;
+    -webkit-user-select: none;
+    -moz-user-select: none;
+    -ms-user-select: none;
+    user-select: none;
+    border: 1px solid transparent;
+    border-radius: 4px;
+}
+
+.btn:active:focus,
+.btn:focus {
+    outline: -webkit-focus-ring-color auto 5px;
+    outline-offset: -2px;
+}
+
+.btn:focus,
+.btn:hover {
+    color: #333;
+    text-decoration: none;
+}
+
+.btn:active {
+    outline: 0;
+    -webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, .125);
+    box-shadow: inset 0 3px 5px rgba(0, 0, 0, .125);
+}
+
+.collapse {
+    display: none
+}
+
+.collapse.in {
+    display: block
+}
+
+.nav>li,
+.nav>li>a {
+    display: block;
+    position: relative;
+}
+
+.nav {
+    padding-left: 0;
+    margin-bottom: 0;
+    list-style: none;
+}
+
+.nav>li>a {
+    padding: 10px 15px;
+}
+
+.nav>li>a:focus,
+.nav>li>a:hover {
+    text-decoration: none;
+    background-color: #eee;
+}
+
+.navbar {
+    position: relative;
+    min-height: 50px;
+    margin-bottom: 20px;
+    border: 1px solid transparent;
+}
+
+.navbar-collapse {
+    padding-right: 15px;
+    padding-left: 15px;
+    overflow-x: visible;
+    -webkit-overflow-scrolling: touch;
+    border-top: 1px solid transparent;
+    -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, .1);
+    box-shadow: inset 0 1px 0 rgba(255, 255, 255, .1);
+}
+
+@media (min-width:768px) {
+    .navbar {
+        border-radius: 4px;
+    }
+
+    .navbar-header {
+        float: left;
+    }
+
+    .navbar-collapse {
+        width: auto;
+        border-top: 0;
+        -webkit-box-shadow: none;
+        box-shadow: none;
+    }
+
+    .navbar-collapse.collapse {
+        display: block !important;
+        height: auto !important;
+        padding-bottom: 0;
+        overflow: visible !important;
+    }
+}
+
+.container>.navbar-collapse,
+.container>.navbar-header {
+    margin-right: -15px;
+    margin-left: -15px;
+}
+
+.navbar-brand {
+    float: left;
+    height: 50px;
+    padding: 15px;
+    font-size: 18px;
+    line-height: 20px;
+}
+
+.navbar-brand:focus,
+.navbar-brand:hover {
+    text-decoration: none;
+}
+
+@media (min-width:768px) {
+
+    .container>.navbar-collapse,
+    .container>.navbar-header {
+        margin-right: 0;
+        margin-left: 0;
+    }
+
+    .navbar>.container .navbar-brand {
+        margin-left: -15px;
+    }
+}
+
+.navbar-toggle {
+    position: relative;
+    float: right;
+    padding: 9px 10px;
+    margin-top: 8px;
+    margin-right: 15px;
+    margin-bottom: 8px;
+    background-color: transparent;
+    border: 1px solid transparent;
+    border-radius: 4px;
+}
+
+.navbar-toggle:focus {
+    outline: 0;
+}
+
+.navbar-toggle .icon-bar {
+    display: block;
+    width: 22px;
+    height: 2px;
+    border-radius: 1px;
+}
+
+.navbar-toggle .icon-bar+.icon-bar {
+    margin-top: 4px;
+}
+
+.navbar-nav {
+    margin: 7.5px -15px;
+}
+
+.navbar-nav>li>a {
+    padding-top: 10px;
+    padding-bottom: 10px;
+    line-height: 20px;
+}
+
+@media (min-width:768px) {
+    .navbar-toggle {
+        display: none;
+    }
+
+    .navbar-nav {
+        float: left;
+        margin: 0;
+    }
+
+    .navbar-nav>li {
+        float: left;
+    }
+
+    .navbar-nav>li>a {
+        padding-top: 15px;
+        padding-bottom: 15px;
+    }
+}
+
+.navbar-form {
+    padding: 10px 15px;
+    border-top: 1px solid transparent;
+    border-bottom: 1px solid transparent;
+    -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, .1), 0 1px 0 rgba(255, 255, 255, .1);
+    box-shadow: inset 0 1px 0 rgba(255, 255, 255, .1), 0 1px 0 rgba(255, 255, 255, .1);
+    margin: 8px -15px;
+}
+
+@media (min-width:768px) {
+    .navbar-form .form-group {
+        display: inline-block;
+    }
+
+    .navbar-form .form-group {
+        margin-bottom: 0;
+        vertical-align: middle;
+    }
+
+    .navbar-form .form-control {
+        display: inline-block;
+        width: auto;
+        vertical-align: middle;
+    }
+
+    .navbar-form {
+        width: auto;
+        padding-top: 0;
+        padding-bottom: 0;
+        margin-right: 0;
+        margin-left: 0;
+        border: 0;
+        -webkit-box-shadow: none;
+        box-shadow: none;
+    }
+}
+
+.breadcrumb>li {
+    display: inline-block;
+}
+
+@media (max-width:767px) {
+    .navbar-form .form-group {
+        margin-bottom: 5px;
+    }
+
+    .navbar-form .form-group:last-child {
+        margin-bottom: 0;
+    }
+}
+
+@media (min-width:768px) {
+    .navbar-right {
+        float: right !important;
+        margin-right: -15px;
+    }
+}
+
+.navbar-default {
+    background-color: #f8f8f8;
+    border-color: #e7e7e7;
+}
+
+.navbar-inverse {
+    background-color: #222;
+    border-color: #080808;
+}
+
+.navbar-inverse .navbar-brand {
+    color: #9d9d9d;
+}
+
+.navbar-inverse .navbar-brand:focus,
+.navbar-inverse .navbar-brand:hover {
+    color: #fff;
+    background-color: transparent;
+}
+
+.navbar-inverse .navbar-nav>li>a {
+    color: #9d9d9d;
+}
+
+.navbar-inverse .navbar-nav>li>a:focus,
+.navbar-inverse .navbar-nav>li>a:hover {
+    color: #fff;
+    background-color: transparent;
+}
+
+.navbar-inverse .navbar-nav>.active>a,
+.navbar-inverse .navbar-nav>.active>a:focus,
+.navbar-inverse .navbar-nav>.active>a:hover {
+    color: #fff;
+    background-color: #080808;
+}
+
+.navbar-inverse .navbar-toggle {
+    border-color: #333;
+}
+
+.navbar-inverse .navbar-toggle:focus,
+.navbar-inverse .navbar-toggle:hover {
+    background-color: #333;
+}
+
+.navbar-inverse .navbar-toggle .icon-bar {
+    background-color: #fff;
+}
+
+.navbar-inverse .navbar-collapse,
+.navbar-inverse .navbar-form {
+    border-color: #101010;
+}
+
+.breadcrumb {
+    padding: 8px 15px;
+    margin-bottom: 20px;
+    list-style: none;
+    background-color: #f5f5f5;
+    border-radius: 4px;
+}
+
+.breadcrumb>li+li:before {
+    padding: 0 5px;
+    color: #ccc;
+    content: "/\00a0";
+}
+
+.alert {
+    margin-bottom: 20px;
+}
+
+.alert {
+    padding: 15px;
+    border: 1px solid transparent;
+    border-radius: 4px;
+}
+
+.alert>p {
+    margin-bottom: 0;
+}
+
+.container:after,
+.container:before,
+.nav:after,
+.nav:before,
+.navbar-collapse:after,
+.navbar-collapse:before,
+.navbar-header:after,
+.navbar-header:before,
+.navbar:after,
+.navbar:before,
+.row:after,
+.row:before {
+    display: table;
+    content: " ";
+}
+
+.container:after,
+.nav:after,
+.navbar-collapse:after,
+.navbar-header:after,
+.navbar:after,
+.row:after {
+    clear: both;
+}
+
+.pull-right {
+    float: right !important;
+}
+
+.affix {
+    position: fixed;
+}
+
+@media (max-width:767px) {
+    .hidden-xs {
+        display: none !important;
+    }
+}
+
+@media (min-width:768px) and (max-width:991px) {
+    .hidden-sm {
+        display: none !important;
+    }
+}
+
+@media print {
+    .hidden-print {
+        display: none !important;
+    }
+}
+
+.hide {
+    display: none !important;
+}
+
+.show {
+    display: block !important;
+}
+
+.pagination {
+    display: inline-block;
+}
+
+.pagination {
+    padding-left: 0;
+    margin: 20px 0;
+    border-radius: 4px;
+}
+
+.pagination>li {
+    display: inline;
+}
+
+.pagination>li>a {
+    position: relative;
+    float: left;
+    padding: 6px 12px;
+    margin-left: -1px;
+    line-height: 1.42857143;
+    color: #337ab7;
+    text-decoration: none;
+    background-color: #fff;
+    border: 1px solid #ddd;
+}
+
+.pagination>li:first-child>a {
+    margin-left: 0;
+    border-top-left-radius: 4px;
+    border-bottom-left-radius: 4px;
+}
+
+.pagination>li:last-child>a {
+    border-top-right-radius: 4px;
+    border-bottom-right-radius: 4px;
+}
+
+.pagination>li>a:focus,
+.pagination>li>a:hover {
+    z-index: 2;
+    color: #23527c;
+    background-color: #eee;
+    border-color: #ddd;
+}
+
+.pagination>.active>a,
+.pagination>.active>a:focus,
+.pagination>.active>a:hover {
+    z-index: 3;
+    color: #fff;
+    cursor: default;
+    background-color: #337ab7;
+    border-color: #337ab7;
+}
+
+.pagination>.disabled>a,
+.pagination>.disabled>a:focus,
+.pagination>.disabled>a:hover {
+    color: #777;
+    cursor: not-allowed;
+    background-color: #fff;
+    border-color: #ddd;
+}
diff --git a/docs/_template/light-dark-theme/styles/gray.css b/docs/_template/light-dark-theme/styles/gray.css
new file mode 100644
index 000000000..1d914368a
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/gray.css
@@ -0,0 +1,311 @@
+/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
+
+@import url('vs2015.css');
+html,
+body {
+    background: #23272A;
+    color: #dddddd;
+}
+
+button,
+a {
+    color: #64B5F6;
+}
+
+.sidenav{
+  background-color: rgb(30, 30, 30);
+}
+
+button:hover,
+button:focus,
+a:hover,
+a:focus,
+.btn:focus,
+.btn:hover{
+    color: #2196F3;
+}
+
+a.disable,
+a.disable:hover {
+    color: #EEEEEE;
+}
+
+.divider {
+    color: #37474F;
+}
+
+hr {
+    border-color: #37474F;
+}
+
+/* top navbar */
+.navbar-inverse[role="navigation"] {
+    background-color: #2C2F33;
+}
+
+/* sub navbar (below top) */
+.subnav {
+    background: #282B2F
+}
+
+
+.inheritance h5,
+.inheritedMembers h5 {
+    border-bottom: 1px solid #37474F;
+}
+
+article h4 {
+    border-bottom: 1px solid #37474F;
+}
+
+.docs-search {
+    background: #424242;
+}
+
+.search-results-group-heading {
+    color: #424242;
+}
+
+.search-close {
+    color: #424242;
+}
+
+.sidetoc {
+    background-color: #1b1b1b;
+    border-left: 0px solid #37474F;
+    border-right: 0px solid #37474F;
+}
+
+.sideaffix {
+    overflow: visible;
+}
+
+.sideaffix>div.contribution>ul>li>a.contribution-link:hover {
+    background-color: #333333;
+}
+
+/* toc */
+
+.toc .nav>li>a {
+    color: rgb(218, 218, 218);
+}
+
+.toc .nav>li>a:hover,
+.toc .nav>li>a:focus {
+    color: #E0E0E0;
+}
+
+.toc .nav>li.active>a {
+    color: #90CAF9;
+}
+
+.toc .nav>li.active>a:hover,
+.toc .nav>li.active>a:focus {
+    background-color: #37474F;
+    color: #4FC3F7;
+}
+
+.sidefilter {
+    background-color: #1b1b1b;
+    border-left: 0px solid #37474F;
+    border-right: 0px solid #37474F;
+}
+
+.affix ul>li>a:hover {
+    background: none;
+    color: #EEEEEE;
+}
+
+.affix ul>li.active>a,
+.affix ul>li.active>a:before {
+    color: #B3E5FC;
+}
+
+.affix ul>li>a {
+    color: #EEEEEE;
+}
+
+.affix>ul>li.active>a,
+.affix>ul>li.active>a:before {
+    color: #B3E5FC;
+}
+
+.tryspan {
+    border-color: #37474F;
+}
+
+.footer {
+    border-top: 1px solid #5F5F5F;
+    background: #2C2F33;
+}
+
+/* alert */
+.alert-info {
+    color: #f3fdff;
+    background: #40788A;
+    border-color: #2F7A95;
+}
+
+.alert-warning {
+    color: #fffaf2;
+    background: #936C36;
+    border-color: #AE8443;
+}
+
+.alert-danger {
+    color: #fff4f4;
+    background: #834040;
+    border-color: #8C2F2F
+}
+
+/* For tabbed content */
+
+.tabGroup {
+    margin-top: 1rem;
+}
+
+.tabGroup ul[role="tablist"] {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+}
+
+.tabGroup ul[role="tablist"]>li {
+    list-style: none;
+    display: inline-block;
+}
+
+.tabGroup a[role="tab"] {
+    color: white;
+    box-sizing: border-box;
+    display: inline-block;
+    padding: 5px 7.5px;
+    text-decoration: none;
+    border-bottom: 2px solid #fff;
+}
+
+.tabGroup a[role="tab"]:hover,
+.tabGroup a[role="tab"]:focus,
+.tabGroup a[role="tab"][aria-selected="true"] {
+    border-bottom: 2px solid #607D8B;
+}
+
+.tabGroup a[role="tab"][aria-selected="true"] {
+    color: #81D4FA;
+}
+
+.tabGroup a[role="tab"]:hover,
+.tabGroup a[role="tab"]:focus {
+    color: #29B6F6;
+}
+
+.tabGroup a[role="tab"]:focus {
+    outline: 1px solid #607D8B;
+    outline-offset: -1px;
+}
+
+@media (min-width: 768px) {
+    .tabGroup a[role="tab"] {
+        padding: 5px 15px;
+    }
+}
+
+.tabGroup section[role="tabpanel"] {
+    border: 1px solid #607D8B;
+    padding: 15px;
+    margin: 0;
+    overflow: hidden;
+}
+
+.tabGroup section[role="tabpanel"]>.codeHeader,
+.tabGroup section[role="tabpanel"]>pre {
+    margin-left: -16px;
+    margin-right: -16px;
+}
+
+.tabGroup section[role="tabpanel"]> :first-child {
+    margin-top: 0;
+}
+
+.tabGroup section[role="tabpanel"]>pre:last-child {
+    display: block;
+    margin-bottom: -16px;
+}
+
+.mainContainer[dir='rtl'] main ul[role="tablist"] {
+    margin: 0;
+}
+
+/* code */
+
+code {
+    color: white;
+    background-color: #5B646B;
+    border-radius: 4px;
+    padding: 3px 7px;
+}
+
+pre {
+    background-color: #282a36;
+}
+
+/* table */
+
+.table-striped>tbody>tr:nth-of-type(odd) {
+    background-color: #333333;
+    color: #d3d3d3
+}
+
+tbody>tr {
+    background-color: #424242;
+    color: #c0c0c0
+}
+
+.table>tbody+tbody {
+    border-top: 2px solid rgb(173, 173, 173)
+}
+
+/* select */
+
+select {
+    background-color: #3b3b3b;
+    border-color: #2e2e2e;
+}
+
+/* 
+    Following code regarding collapse container are fetched 
+    or modified from the Materialize project.
+
+    The MIT License (MIT)
+    Copyright (c) 2014-2018 Materialize
+    https://github.com/Dogfalo/materialize
+*/
+
+/* all collapse container */
+.collapse-container.last-modified {
+    -webkit-box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
+    box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
+    border-top: 1px solid rgba(96, 96, 96, 0.7);
+    border-right: 1px solid rgba(96, 96, 96, 0.7);
+    border-left: 1px solid rgba(96, 96, 96, 0.7);
+}
+
+/* header */
+.collapse-container.last-modified>:nth-child(odd) {
+    background-color: #3f3f3f;
+    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
+}
+
+/* body */
+.collapse-container.last-modified>:nth-child(even) {
+    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
+    background-color: inherit;
+}
+
+span.arrow-d{
+    border-top: 5px solid white
+}
+
+span.arrow-r{
+    border-left: 5px solid white
+}
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/light.css b/docs/_template/light-dark-theme/styles/light.css
new file mode 100644
index 000000000..a5360711f
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/light.css
@@ -0,0 +1,113 @@
+/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
+
+@import url('tomorrow.css');
+html,
+body {
+    background: #fff;
+    color: #000;
+}
+
+.sideaffix {
+    overflow: visible;
+}
+
+/* links */
+
+a:active, a:hover, a:visited {
+    color: #0078d7;
+}
+
+a {
+    color: #0050c5;
+    cursor: pointer;
+    text-decoration: none;
+    word-wrap: break-word;
+}
+
+/* alert */
+.alert-info {
+    color: #165e82;
+    background-color: #c1e0ef;
+    border-color: #8cbfd8;
+}
+
+.alert-warning {
+    color: #825e16;
+    background-color: #efe0c1;
+    border-color: #d8bf8c;
+}
+
+.alert-danger {
+    color: #821616;
+    background-color: #efc1c1;
+    border-color: #d88c8c;
+}
+
+/* code */
+
+code {
+    color: #9c3a3f;
+    background-color: #ececec;
+    border-radius: 4px;
+    padding: 3px 7px;
+}
+
+/* table */
+
+.table-striped>tbody>tr:nth-of-type(odd) {
+    color: #333333;
+    background-color: #d3d3d3
+}
+
+tbody>tr {
+    color: #424242;
+    background-color: #c0c0c0
+}
+
+.table>tbody+tbody {
+    border-top: 2px solid rgb(173, 173, 173)
+}
+
+/* select */
+
+select {
+    background-color: #fcfcfc;
+    border-color: #aeb1b5;
+}
+
+/* 
+    Following code regarding collapse container are fetched 
+    or modified from the Materialize project.
+
+    The MIT License (MIT)
+    Copyright (c) 2014-2018 Materialize
+    https://github.com/Dogfalo/materialize
+*/
+
+/* all collapse container */
+.collapse-container.last-modified {
+    -webkit-box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 3px 1px -2px rgba(0, 0, 0, 0.12), 0 1px 5px 0 rgba(0, 0, 0, 0.2);
+    box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 3px 1px -2px rgba(0, 0, 0, 0.12), 0 1px 5px 0 rgba(0, 0, 0, 0.2);
+    border-top: 1px solid #ddd;
+    border-right: 1px solid #ddd;
+    border-left: 1px solid #ddd;
+}
+
+/* header */
+.collapse-container.last-modified>:nth-child(odd) {
+    background-color: #fff;
+    border-bottom: 1px solid #ddd;
+}
+
+/* body */
+.collapse-container.last-modified>:nth-child(even) {
+    border-bottom: 1px solid #ddd;
+}
+
+span.arrow-d{
+    border-top: 5px solid black
+}
+
+span.arrow-r{
+    border-left: 5px solid black
+}
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/master.css b/docs/_template/light-dark-theme/styles/master.css
new file mode 100644
index 000000000..4e0dffd7a
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/master.css
@@ -0,0 +1,156 @@
+@import url('https://fonts.googleapis.com/css?family=Titillium+Web|Noto+Sans');
+
+html,
+body {
+    font-family: 'Titillium Web', 'Segoe UI', Tahoma, Helvetica, sans-serif;
+    font-display: optional;
+    height: 100%;
+    font-size: 15px;
+    scroll-behavior: smooth;
+}
+
+p,
+li,
+.toc {
+    text-rendering: optimizeLegibility;
+    line-height: 160%;
+}
+
+img {
+    box-shadow: 0px 0px 3px 0px rgb(66, 66, 66);
+    max-width: 95% !important;
+    margin-top: 15px;
+    margin-bottom: 15px;
+}
+
+article.content p{
+    -webkit-transition: all .75s ease-in-out;
+    transition: all .75s ease-in-out;
+}
+
+article.content h1,
+article.content h2,
+article.content h3,
+article.content h4,
+article.content h5,
+article.content h6{
+    -webkit-transition: all .25s ease-in-out;
+    transition: all .25s ease-in-out;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    font-family: 'Noto Sans', Verdana, Geneva, Tahoma, sans-serif;
+    line-height: 130%;
+}
+
+.sideaffix {
+    line-height: 140%;
+}
+
+header .navbar {
+    border-width: 0 0 0px;
+    border-radius: 0;
+}
+
+body .toc {
+    background-color: inherit;
+    overflow: visible;
+}
+
+select {
+    display: inline-block;
+    overflow: auto;
+    -webkit-box-sizing: border-box;
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0 30px 0 6px;
+    vertical-align: middle;
+    height: 28px;
+    border: 1px solid #e3e3e3;
+    line-height: 16px;
+    outline: 0;
+    text-overflow: ellipsis;
+    -webkit-appearance: none;
+    -moz-appearance: none;
+    cursor: pointer;
+    background-image: linear-gradient(45deg, transparent 50%, #707070 0), linear-gradient(135deg, #707070 50%, transparent 0);
+    background-position: calc(100% - 13px) 11px, calc(100% - 8px) 11px;
+    background-size: 5px 5px, 5px 6px;
+    background-repeat: no-repeat;
+}
+
+/* 
+    Following code are fetched or modified from 
+    the Materialize project.
+
+    The MIT License (MIT)
+    Copyright (c) 2014-2018 Materialize
+    https://github.com/Dogfalo/materialize
+*/
+
+/* all collapse container */
+
+.collapse-container.last-modified {
+    margin: 0.5rem 0 1rem 0;
+}
+
+/* header */
+
+.collapse-container.last-modified>:nth-child(odd):focus {
+    outline: 0;
+}
+
+.collapse-container.last-modified>:nth-child(odd) {
+    display: -webkit-box;
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    cursor: pointer;
+    -webkit-tap-highlight-color: transparent;
+    line-height: 1.5;
+    padding: 0.75rem;
+    background-image: none;
+    border: 0px;
+}
+
+/* body */
+
+.collapse-container.last-modified>:nth-child(even) {
+    display: none;
+    -webkit-box-sizing: border-box;
+    box-sizing: border-box;
+    padding: 1rem;
+    border: 0px;
+}
+
+/* nav bar */
+
+.nav {
+    margin: 0;
+}
+
+.nav li {
+    -webkit-transition: background-color .3s, color .3s;
+    transition: background-color .3s, color .3s;
+}
+
+.nav a {
+    -webkit-transition: background-color .3s, color .3s;
+    transition: background-color .3s, color .3s;
+    cursor: pointer;
+}
+
+/* arrow */
+
+span.arrow-d{
+    top: 6px; position: relative;
+}
+
+span.arrow-r{
+    top: 6px; position: relative;
+}
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/plugin-featherlight.js b/docs/_template/light-dark-theme/styles/plugin-featherlight.js
new file mode 100644
index 000000000..2fd056fa0
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/plugin-featherlight.js
@@ -0,0 +1,37 @@
+// MIT License
+
+// Copyright (c) 2017 Roel Fauconnier
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+$(document).ready(function() {
+        //find all images, but not the logo, and add the lightbox
+        $('img').not('#logo').each(function(){
+            var $img = $(this);
+            var filename = $img.attr('src')
+            //add cursor
+            $img.css('cursor','zoom-in');
+            $img.css('cursor','-moz-zoom-in');
+            $img.css('cursor','-webkit-zoom-in');
+
+            //add featherlight
+            $img.attr('alt', filename);
+            $img.featherlight(filename);
+    });
+});
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/styleswitcher.js b/docs/_template/light-dark-theme/styles/styleswitcher.js
new file mode 100644
index 000000000..a87b89525
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/styleswitcher.js
@@ -0,0 +1,26 @@
+const baseUrl = document.getElementById("docfx-style:rel").content;
+
+function onThemeSelect(event) {
+    const theme = event.target.value;
+    window.localStorage.setItem("theme", theme);
+    window.themeElement.href = getUrl(theme);
+}
+
+function getUrl(slug) {
+    return baseUrl + "styles/" + slug + ".css";
+}
+
+const themeElement = document.createElement("link");
+themeElement.rel = "stylesheet";
+
+const theme = window.localStorage.getItem("theme") || "light";
+themeElement.href = getUrl(theme);
+
+document.head.appendChild(themeElement);
+window.themeElement = themeElement;
+
+document.addEventListener("DOMContentLoaded", function() {
+    const themeSwitcher = document.getElementById("theme-switcher");
+    themeSwitcher.onchange = onThemeSelect;
+    themeSwitcher.value = theme;
+}, false);
diff --git a/docs/_template/light-dark-theme/styles/theme-switcher.css b/docs/_template/light-dark-theme/styles/theme-switcher.css
new file mode 100644
index 000000000..c6e27c93a
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/theme-switcher.css
@@ -0,0 +1,9 @@
+div.theme-switch-field {
+    padding-left: 10px;
+    padding-bottom: 15px
+}
+
+div.theme-switch-field > p{
+    font-weight: bold;
+    font-size: 1.2em;
+}
\ No newline at end of file
diff --git a/docs/_template/light-dark-theme/styles/tomorrow.css b/docs/_template/light-dark-theme/styles/tomorrow.css
new file mode 100644
index 000000000..026a62fe3
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/tomorrow.css
@@ -0,0 +1,72 @@
+/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
+
+/* Tomorrow Comment */
+.hljs-comment,
+.hljs-quote {
+  color: #8e908c;
+}
+
+/* Tomorrow Red */
+.hljs-variable,
+.hljs-template-variable,
+.hljs-tag,
+.hljs-name,
+.hljs-selector-id,
+.hljs-selector-class,
+.hljs-regexp,
+.hljs-deletion {
+  color: #c82829;
+}
+
+/* Tomorrow Orange */
+.hljs-number,
+.hljs-built_in,
+.hljs-builtin-name,
+.hljs-literal,
+.hljs-type,
+.hljs-params,
+.hljs-meta,
+.hljs-link {
+  color: #f5871f;
+}
+
+/* Tomorrow Yellow */
+.hljs-attribute {
+  color: #eab700;
+}
+
+/* Tomorrow Green */
+.hljs-string,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-addition {
+  color: #718c00;
+}
+
+/* Tomorrow Blue */
+.hljs-title,
+.hljs-section {
+  color: #4271ae;
+}
+
+/* Tomorrow Purple */
+.hljs-keyword,
+.hljs-selector-tag {
+  color: #8959a8;
+}
+
+.hljs {
+  display: block;
+  overflow-x: auto;
+  background: white;
+  color: #4d4d4c;
+  padding: 0.5em;
+}
+
+.hljs-emphasis {
+  font-style: italic;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}
diff --git a/docs/_template/light-dark-theme/styles/vs2015.css b/docs/_template/light-dark-theme/styles/vs2015.css
new file mode 100644
index 000000000..d8c14a046
--- /dev/null
+++ b/docs/_template/light-dark-theme/styles/vs2015.css
@@ -0,0 +1,115 @@
+/*
+ * Visual Studio 2015 dark style
+ * Author: Nicolas LLOBERA <nllobera@gmail.com>
+ */
+
+.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 0.5em;
+  background: #282a36;
+  color: #DCDCDC;
+}
+
+.hljs-keyword,
+.hljs-literal,
+.hljs-symbol,
+.hljs-name {
+  color: #569CD6;
+}
+.hljs-link {
+  color: #569CD6;
+  text-decoration: underline;
+}
+
+.hljs-built_in,
+.hljs-type {
+  color: #4EC9B0;
+}
+
+.hljs-number,
+.hljs-class {
+  color: #B8D7A3;
+}
+
+.hljs-string,
+.hljs-meta-string {
+  color: #D69D85;
+}
+
+.hljs-regexp,
+.hljs-template-tag {
+  color: #9A5334;
+}
+
+.hljs-subst,
+.hljs-function,
+.hljs-title,
+.hljs-params,
+.hljs-formula {
+  color: #DCDCDC;
+}
+
+.hljs-comment,
+.hljs-quote {
+  color: #57A64A;
+  font-style: italic;
+}
+
+.hljs-doctag {
+  color: #608B4E;
+}
+
+.hljs-meta,
+.hljs-meta-keyword,
+.hljs-tag {
+  color: #9B9B9B;
+}
+
+.hljs-variable,
+.hljs-template-variable {
+  color: #BD63C5;
+}
+
+.hljs-attr,
+.hljs-attribute,
+.hljs-builtin-name {
+  color: #9CDCFE;
+}
+
+.hljs-section {
+  color: gold;
+}
+
+.hljs-emphasis {
+  font-style: italic;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}
+
+/*.hljs-code {
+  font-family:'Monospace';
+}*/
+
+.hljs-bullet,
+.hljs-selector-tag,
+.hljs-selector-id,
+.hljs-selector-class,
+.hljs-selector-attr,
+.hljs-selector-pseudo {
+  color: #D7BA7D;
+}
+
+.hljs-addition {
+  background-color: #144212;
+  display: inline-block;
+  width: 100%;
+}
+
+.hljs-deletion {
+  background-color: #600;
+  display: inline-block;
+  width: 100%;
+}
diff --git a/docs/api/index.md b/docs/api/index.md
index d9433363f..c16ca1363 100644
--- a/docs/api/index.md
+++ b/docs/api/index.md
@@ -1,13 +1,16 @@
+---
+uid: API.Docs
+---
 
 # API Documentation
 
-This is where you will find documentation for all members and objects in Discord.Net
+This is where you will find documentation for all members and objects in Discord.Net.
 
-__Commonly Used Entities__  
+# Commonly Used Entities
 
-* @Discord.WebSocket  
-* @Discord.WebSocket.DiscordSocketClient  
-* @Discord.WebSocket.SocketGuildChannel  
-* @Discord.WebSocket.SocketGuildUser  
-* @Discord.WebSocket.SocketMessage  
-* @Discord.WebSocket.SocketRole  
\ No newline at end of file
+* @Discord.WebSocket
+* @Discord.WebSocket.DiscordSocketClient
+* @Discord.WebSocket.SocketGuildChannel
+* @Discord.WebSocket.SocketGuildUser
+* @Discord.WebSocket.SocketMessage
+* @Discord.WebSocket.SocketRole
\ No newline at end of file
diff --git a/docs/docfx.json b/docs/docfx.json
index 50ae39092..2a50869d6 100644
--- a/docs/docfx.json
+++ b/docs/docfx.json
@@ -1,74 +1,54 @@
 {
-  "metadata": [
-    {
-      "src": [
-        {
-          "src": "..",
-          "files": [
-            "src/**/*.cs"
-          ],
-          "exclude": [
-            "**/obj/**",
-            "**/bin/**",
-            "_site/**"
-          ]
-        }
-      ],
-      "dest": "api",
-      "filter": "filterConfig.yml"
+  "metadata": [{
+    "src": [{
+      "src": "../src",
+      "files": [
+        "**.csproj"
+      ]
+    }],
+    "dest": "api",
+    "filter": "filterConfig.yml",
+    "properties": {
+      "TargetFramework": "netstandard1.3"
     }
-  ],
+  }],
   "build": {
-    "content": [
-      {
-        "files": [
-          "api/**.yml",
-          "api/index.md"
-        ]
+    "content": [{
+        "files": ["api/**.yml", "api/index.md"]
       },
       {
-        "files": [
-          "guides/**.md",
-          "guides/**/toc.yml",
-          "toc.yml",
-          "*.md"
-        ],
-        "exclude": [
-          "obj/**",
-          "_site/**"
-        ]
-      }
-    ],
-    "resource": [
+        "files": ["toc.yml", "index.md"]
+      },
       {
-        "files": [
-          "**/images/**",
-          "**/samples/**"
-        ],
-        "exclude": [
-          "obj/**",
-          "_site/**"
-        ]
-      }
-    ],
-    "overwrite": [
+        "files": ["faq/**.md", "faq/**/toc.yml"]
+      },
       {
-        "files": [
-          "apidoc/**.md"
-        ],
-        "exclude": [
-          "obj/**",
-          "_site/**"
-        ]
+        "files": ["guides/**.md", "guides/**/toc.yml"]
       }
     ],
+    "resource": [{
+      "files": [
+        "**/images/**",
+        "**/samples/**",
+        "langwordMapping.yml"
+      ]
+    }],
     "dest": "_site",
     "template": [
-      "default"
+      "default",
+      "_template/light-dark-theme",
+      "_template/last-modified",
+      "_template/description-generator"
     ],
+    "postProcessors": ["ExtractSearchIndex", "LastModifiedPostProcessor", "DescriptionPostProcessor"],
+    "overwrite": "_overwrites/**/**.md",
     "globalMetadata": {
-      "_appFooter": "Discord.Net (c) 2015-2018 2.0.0-beta"
+      "_appTitle": "Discord.Net Documentation",
+      "_appFooter": "Discord.Net (c) 2015-2018 2.0.0-beta",
+      "_enableSearch": true
     },
-    "noLangKeyword": false
+    "xrefService": [
+      "https://xref.docs.microsoft.com/query?uid={uid}"
+    ]
   }
 }
diff --git a/docs/faq/basics/basic-operations.md b/docs/faq/basics/basic-operations.md
new file mode 100644
index 000000000..16f98c3b9
--- /dev/null
+++ b/docs/faq/basics/basic-operations.md
@@ -0,0 +1,123 @@
+---
+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/programming-guide/types/how-to-safely-cast-by-using-as-and-is-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.IUserMessage.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
new file mode 100644
index 000000000..5c529a3f5
--- /dev/null
+++ b/docs/faq/basics/client-basics.md
@@ -0,0 +1,66 @@
+---
+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://discordapp.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
\ No newline at end of file
diff --git a/docs/faq/basics/getting-started.md b/docs/faq/basics/getting-started.md
new file mode 100644
index 000000000..f38d2cea7
--- /dev/null
+++ b/docs/faq/basics/getting-started.md
@@ -0,0 +1,79 @@
+---
+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.
+
+![Snowflake Generation](images/snowflake.png)
+
+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).
+
+![Developer Mode](images/dev-mode.png)
+
+### [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.
+
+![Escaping mentions](images/mention-escape.png)
+
+***
+
+## 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. Make the role mentionable and mention the role, and escape it
+  using the `\` character in front.
+2. 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
new file mode 100644
index 0000000000000000000000000000000000000000..fd20b95d188751a2f3b4268e7ba7294b71afaf06
GIT binary patch
literal 80742
zcmd43cT`hb*FK6BQ2{;JkS0e3q$)@!L`B6$5eS`tA|RnD5K15vQLrGO2uK%@8fxez
zAfg5c(gQ+(i1Y-Aq!5#k<QF`8zjNOAJL7l%yVo%ohCTLPnS0K)=A7$!p2ZVWV?)8+
zM|bn_@d;kNa?y;BZ-*rx-`3GxJ9$@JeZ{7E|84OzGrYi8-YdSu`(?Y^d86}ud{yy#
zHg4_U{Vs6tij5y1pHRo<&la>#(H%ZMZvNGa=PiQ3%j{=<_8&93+;DD!Bbz{B56h;9
zSm*A#^wQ;yH0E}t625}$(Art&iHUoB=GbFv98vD_hXBut@ZEK55}s&F8=<F2WwY$c
z(6&nHb7l#Zd!(g~?YUKb?u(Yd@(62ma)Elo#H8=;iR(d^DHhng?-{Fp#@U#j)Zl@_
zJ}wQ&S#aCVvvBiY0`LLouTOkOWd7fO)cm}p=0^D=E%3x@Gj|IE1~RI=G33%@T-2j}
zr;-_{8|d;{Jp_!j=i-b53*l})@nc^}K$wL_jaPCXd>Uhev8pS*n#`EP>jqiZ!DqZ1
zX^6Ql-+HBFaI{0rR8X5eDfVjM4P)hPf7$l#bBf7bowW9nULolGk=<5)NsQ>dme4!{
z|1ZTDt1@tUMuDSjfw2j~4W2iXUJ!bpGU(JO<Opp9dl%XBS8CV`CVA+b!_MiP<9+a!
z+xyq3U*`u?9qu+MWb1V7-)$NrQUVF)N9YEwXh@f=GTaN7By+<mONe94CVT!e?|6_z
z0)dPY2HxIk3TX4L<Ww~4<2o$(bK)fdt_2LJXZo^^I%?XxvIL{vymwN>Qsw`#y-=;W
z-``3f8jTS&ixK<zEgHlA2G_-6$48qcqBEMLbq+vd`0k|?ZnFw(npffZtizT)K2qg1
z2(X!COw4_8`LXgVVD~6<iKEX!1#a80)6pg43GF4Vj~q4i@J^tZ;`Q2mA5#4mMCSa?
z!sIqjU4UI>Ns67FrgqukvZ*aPcd>xmG>_)JzoYDQSHnQ;+TE!aoo+UHjryancOue+
ztSEw(>XTyFo$1LE+~HQq=T6wdQTK&`^X05Gr-Og_O-_$73w3_6G-e9oj<N%bysv=U
zOI#19nN&hT3JKhC$%?uOPRQBlt^Hyi+%n9@E&hqo?TEjgJvZGYTOqb`L*>9*Ax(P;
zRcnVaq|EcxV92&>a12VynsAWFZ?S}<l3F}$$)~u?>6=Xx@W-!|N9)&!OxRe{gz|Nh
z(Rv1PX+6>k=HM;C9vAfXI)cE>)r~ns<DUJp@ZIP9Up^-%DV&oqZb+kdAVPKehv&j7
zn{vGTYyrGc=ANae?8K~)C*BO_Z?lnj-Q+b$96_0R^?@X^2s++<R@su<{uaf<-QO=<
zpu{~~?N3$E!v3D?B|cU3#_6}5`b_V_rFTQonN2Z8Qm%y2fW4Lued`yY7#i8LQOM4#
zsD!b?b4TG4-zeN`DRWv#<u8Bm@f}a1ANl1RzKC7z^1rU{75Tq?9O6PTW%UAle62Wn
z9~IBUz^<-#k3rl`S+Tf{D?6D&-6g5`<mxD^xfcha$dxJ&)qD4|d(>zt*XWmMO{ALT
z)#aBVNuRI((Mu-0_3oM^cP=4R-y{dm4K(L_cOrvOR#GX3J*x3VPy|$O<Y0<VQim0d
zC}EcG*k^&!A{U7_7tM=?-l+SC!LJvUs0G~=`moXzNNWi~l{c`vR-W{PG?;wG$xiOc
z8+EmDhazj>)B4&KxTDSFAI`{TC``{J$l<b4jgghHRO~qHdu}S%y0BTLHkjN$0~;e)
zmzGnyH(lWrddzwU-}Xn!M|XUD7zKRU;YGlE#djyQBL-QEmqaR+L31*9hHoK?vyUs@
z5aCB!#dnV9bbm`2h)z6JI5*YR6n0@%ohFs&H4i<p+kow)PSa5w<^&_{Vp6Q6k_6Xk
zdYrK2aY=r}f)tp59YT^2^3~a(R25N~!XG%EbNTpY1bLA-Cg(pOCwJXn>u!ig!3ATn
zLupfQyPQ;n_GC&T=mAqo&-}lRg<b5G+^F-kK4Vg#G9l0Jk3zR84beiiy9qibh&kd^
z6^v1Z<)3>A=@|1dL>VWZpPezhQw{#qqwY&`ZlV`SmFfU2lR#>jE=R*yZA$!-qd5BU
zrIkv65z0w@G+<7ow29SC&3zvAO{<}fX0<Ye^Sc=k;w8iL4<Fy@sr{u}`5s(2{QSY-
z+Uth;cEj@!0`$N#Kw0?pRPKH2B7@$yMcx<q6TJI|T8GH}FBjKo%PvE6kwZ)<tTV`N
z?r88^6C)r>VfSeTVvlNXA<dKhA_Is#u3X;^X_^uWOtp1o<>BaVmpb--nD}YW!P0TY
zSwKd6=0N|Rl=ZT!6>Wd+PBaO~7ru3_a<gu}d7U(=ao(G4o3!CIHu^c7=Fuj!>B`PF
zr>~!Gw3ySaGnGZQxorA4;{B~{pzN&Gk>i`eZalna^CI81$ko)NyFp6z3-UjoLskB~
zY`Pmsv#gx}BX~(A;u!t?*3GNuPVIVBtZ$dXOH%u0!PY--l-rSW4C_YxW79Dcd;S_T
z|JZ@IOiu@15<Hg>a%;=xeQyptd|;7XcAaPRE?*VJpO3zJV46Uvh6-42;XA+jXw$)b
z5oY^#o5Aap|7psF^Cf*FC;zhg(9cJ&otL{p8*BOx<97UIoSgJQsL|kS)1!p9il$jc
zXYmJ$cfAtK|8w9^u>k+>Xa=<1_kc3}y;+fK#TNy!Hd=<~BxN%toPJwZo}Efc$RQ>3
zy?OM@+#n4)I5G0PRa?fQdkT|$5AHF)iYZyOX;j&-+}2o7v_de!mm_3jJUzxX9DHl~
zQr+&I>kU*99uZ8NR9g7lv~zYavhJRQiOpvRWKp9{$u^fC{*8x|FT8Er7t^Y^S-%=R
z$Jodoo3(r2b!GT|dnxEfCG37%=`cVy9XH#WRqgBYJ<VQwBDp%n%`2oLqm5@c<o%qc
zIV~<x<^TYhcU9gyQ?B;&3X(o7J(i)MsO*y%Wt9i73aDGHYC4x3u-^S*a?g9(w%kg_
zomE<pYXBlxdA+meoT$FT>ZAO91Lm7q{dj)c_2^dTt>=C@H$rx|<)l-^wGm0lgh&Jm
zIZ|wO<A$|%&<zd#Ze-e|Gb~-wUHH|U`w8MnYbEi`aUQiE+k7R)Za8{-#P8^uxK_f_
zd!XCi&pY^57CIcokX|M=$9JVp3Hjk*&bTn`pr91RL8xnBck7I-i^+9}X#H?aS8oRj
zS?!Vw1Kf12TYZT__jNN`!y1PJ&&RF%ch=NoWtQ~Dv3;o-%593WLiEn)F$lPN*%?_q
zR)#x~9s+a0$KCTW!#UILvR*j_o8C^z5N(l35vp+&wX3~GNY{1gi%j(W<Qe7dTwhxH
ztotyO);;iS8wACMz$%u#Jf1EL;h<NH?JX$wdJ6o3^)fLwS9<+uNO2J5^@?cw`fdLP
zUJws3eK-4@Sp}+u2;c8nsuxyiJJK(0NL5-ZY<hds!~^L1Nfz)$EGC+N{4<q0m8yiS
zC#BgF+^;Iv-{{i}Ixl&4CQSpA^$apK!<uWC$n2WlsZ9H_cAfURXn@=&{^caDc|HBz
zT4=q{A1UcB#2kTTWZqQ%Hs8uxd37bDM7<zmua2)SV?(7;lR+?}YDGxv^^&N1!f01?
z$67<_;gGr3IoOdc^)1~sYa43@$iiy#+O^mAgV6ZEv^QhImcju`UWlg#gfQ*F{Q0E`
z71`ld)F3WP-$cChG9~s-$eE)Pd#+3GhHGzj<>Z6RI03%jOFnCH8nn&#BlZ1o`x_XX
zR;s536k5A+uB79Wq>V*tT3_1={H96UUg}Cp{(P;FG*)jR;L^0`PEeSA5<TEzMLHdm
zA1he^GP@~S+pdTcO?y|W+o+7cXj8)~6#!H$Mtl*p!cprol32*NJz_LvfU}enbS=U2
zZl|PcTK}*>zFPFwqNP`P5N%l<b6k?7R!q#+BU9_QYyLepGJLi5xq*RQ>m&12$xNAD
zdJ6Q9^(}Uy(zybLEEke5jYJmGzP<Hh)3DxLU{|gL!1w#GOXHobCMSg~#hR6iMztlG
zua>Kd9Ss3G<|v1uOBg~*lvm(Yo8W4_pldN7Z#Fbp@Fy=cRX;>2OH{6ZGWkJDs_hCG
zlNMAi@_KBrXy0BU;0t|+Fd$m%;a_ODNvc>&^se8g{=3CFXDo+aJ7ER(IEzZ(R^{`2
zfgAxhss@?W;j(g|622GdTUVNov6{y3+|0eY>IW-zRmO~-(CzzJk51>KBbQSpO6t$8
z+s7u`xfY)6z-}3eqV;&|t}pfHPUS-!C|HkL@yVTR=9R!g#mvbQ3L%3A1F<WoDRj)h
zWF``B*p#mgE1hpc9WnZAd5iz|^6p#Qfmo|)Wg{uy&-pIjRD%cFk1oA{jCjOsJq^(H
zi-{?aC1Am0snw(I>EgrAuO+>&??Bixe8&*mtZL&>n9MU)Lj;TbzP!{3Eg{QoUR0h1
zaMfmA%$FjF!&>Vuegwl?<#J-kty33sRM5ORc&_yV{>+x&HRhdKT024Mi8tjA+z$~F
zB7Y<H0k+yVTe6}Cd37Yf(D{u_6qYQvPokm0aillvPpmpGtaWVPN`!Xpa!`vIYFW);
z43;_46~Nn102Lu<-{P{;mxSm!B&r^NL)S-A8LG{Wv>aKM)b?9@y*xJXr<#b-;Fk$e
zI&xCwI&>H00XA%GG<RO9BC#=`D1sMX_+v}_nKAt~<L=>5+Ruz^GbYMkGoa@-*FFZx
zgsw)_k;lNXGQ0}(_<~~`uRKPCKKgssb+d@V{x}q%HYuTk722_n|4~X@ASM7Vh7z<)
zLKX;V--RXFvVCj(&O=1I`iDhtAA4I4TF-ih2G%l-yR(u{`CeyuHj*0T)r1$w@3CW<
zz8}&_-5<eY69@P|bmj1Qj!BR8Lwz4Rfr>p6;WGWT6roN=N2cnK{w~jel#EK&e1qD<
z^R2jNH)p`syKgRH?km&v$rZl%K(4yA#vgPN%c{D^RFoHp-HwZYD_Ij~o9K5FhsV#I
zdG@qP#@(|B)1u_~+2?|j+v7<4ZpiA(%afGhl^tm*6Dz|jh>A6z6)D@{tW#$D<@Qwg
z1>v5FE&TdA4IMr>^&5`tLt<aLOf*p;asxR^?|ED3h(G_4eJ&Lm&(}e_*H;sLPilde
zg3KW}JFQ>2s`oP8LgKS2mb2s%=c=;Vs)WM+K5O3WDg%^eFNWL11*r4Gka58LI@F{0
zsLBJm{V6l{p9m^7%DiU|wDt$y;M?`9ulU*Y{N)g5+F{$n|K)+7t<57j>YP?e6?0FS
z#}z~TOSCe#_eV@#B>9i;D5*A;zP9xodx2MQ2$Oq{f=j3$&4aI#rRLD=9AA7oIVzib
z6CAvRIyY9BcP#D<AD{NazfFvvjo8mQ<0pz}>u*BpFw6D0B<{h!R3__36tFAagr5*T
z4rY1`zlrCV8^?6hTTb<b?*j!d<eLU_!oJ&~q&V_@JG=GOT|<0)#nxM-x!-4{W}k{B
zXK_rY7#A}S`*00?$LSV!z!6<eA~zY>vhH2tZP}I*&ZsWolB9T#O6<5FyM?b)`tKEQ
zvzz=`3^Op#HypT_aLhXs?!LBb+&yIqi>BiKUEy826`b=~rvaAuB&oJg2hR5{$2o>U
zWU#)MhIJA*Su<<*D@TqA<8=9bc70o)qSVd@AfiFAVeOwvMI#H{hFm47*5q+?AE&v5
zx&Z7F_RN&t?8HyM`j_w=XAk8N0^>L%iZfl=1b+o~pQDLJp(E=emg5sVlRBz~5k@Hs
zGlsk$$llnu?&v#7P2MoL+&C6(qW?med!teZwzVC?$7@3Q@>KriMXzusOli9Dt+&9e
za1QMKw*+ET{A@_O@2D90;p#``0yjAx$WUQ?&jfahbltb+#&68lwsq@rS6NreKe&Vk
zvEto{L5rzei#hHoVDJr87~wdLL?kcISu|p{-wNj>>UnIfYU><wN8QCIYTo$DL_0ar
zGiAAQKB3<oOFnazMuE&{dfZtt_c_-i59_(|QY9-*oJa`85aw7A;|&w_fxk`3sk5tR
z_{u*FTh1qvdl95dnBWBw#`k*IazDPS8j`94pf%~OXN>m-WuqwMX2uTe{Yqvia%GKU
zjPr);ac+;Z*Rp{x0>LcdU`3nq5mxND6e(136dNFmV>c+pkJCS0Z+qsbkOF+AIeaGM
zDt(s*m-Aub8+Xl+sl~Y(c02lEkO|lfn#;&_2`%yq<~bxPQ?p!zt(zPW8Y5CVUoT;>
zx}X<VMa;o)r7Jc<LVH8+0oWNgF)*e&wC6M94V{f9M>n?`w5ctGl%PiE@}=5}yU9UP
zT0_Shr~HcjRLW4?)oj@_a3RDD`I>D!DO`<3Qo?c;p{uk@=$mbY=0oKzCF=_~scz@_
zTK#pV7H%e|clxX8pJROv00&Zh&6*F3#wfx!uXzMYp;=trF6L_E8$5*&3a8P7LtD3;
zyCv}VW_EL{vf1Z~FQ`tmg<b%$7b;{I`=u@kpE&KW(l<H-4&y5EqI*1;g9Ua;`D?B7
zX8M?x79&#NqW`W!xZ)`ExIW|A#>FH!$wguS{%6IBsG-rkthj(43y~9?lnqS0SFjFF
zf&7HCn9L0X`@%-`{T%d1FstF_;K7+voybW8ASclsjh3=cNda@NaOR@!icJMy<##AC
z)^jadU15%Rguk+SdH$BXe>J9oL*kz5L%6i$7-$DJ)4~{wD&*uTDIKR_X%BJ9unjj*
zK{C77hkL>&^|T7cbf>=CVw5nKZ9?w$nPD^94avd<aR5o~Nm5Y&kV}9Lt;S>P47Ust
z$t~k<qre}}HZX`1`xsN#FfqcVmFv2zYXNDJC8F&mf|v5Zr30a<?T`ZvJ7G-)68PyI
z2!^L&FFON$#+VXh!JUbxYUdHst70<!%t^AS^7>3lyA3|6p2k>v(vpKiOv&nefG^A~
zhDwm(2{Q5Y3}x<Y+pzwV-o)^mf|}^%mHw#qT<#WW(%VnyTJ%O)HgR1L)oN-&ph{u}
zs<<7x0}ahEDOXP4OX=RpLMqFqcBye#?<SlDw3sp@`mf&)H9pbjqSiJp1rwu&fV0tD
z4*J1jurOc8{=av)o15C7&2R5XoTJ?7&zcrk-g1B7c~{G#5~j1;2^hM9Hye`V%K4?e
z*lo<2L*M61%K)xQ2g?aLfuC>d&GYGUPQfRW9>K;>$+Vm~Z@-aHa;I{=Nw4fMbs#)V
z(of^<Q&`_e=+Fg3eeQSltV6XF=V1M@ZG*<u(=QyN1<ximtOVHQGIfqH^M;(y3JGIj
zVNQh~XWq@z?v-gh4kb3$zZ~LBgCsORZpog^t|;i1Ql&KHIOq)Z-r>`@SP3b(giD>8
zx|^o!2&+skQPXLM6!Ztoj`tZz&G_Fu%{<I_60SITZtx(tPoTMVQQW`x@Te&%%4u?$
z)Oc5S_)I;i8qk(#rEivqT(+zB`h(pk#2)YAc0n0cVVQj)dVNk<abjUh*7QiiLb(*5
zAq%Lz{fc--E6tt|UVf1!JyjlLqoR!#<9mAZ@4dp`DrG-@i4%Aug0Qo&LjXj}Zp(TT
z8d9oHKMcYw)w<nT--peW%xbc_E3Y-MrAQ2R89>+X^-Zr-0VrPEbIbEI&G*0!_Qkd<
z(Ry5IpW+lw9lUS*D;@EtDXjA_pE_#)=be`Zygnu~p5a6unS1Xm-0=Y8WSV;E*t=_c
z^o<&se&f`trAJH3T*2UP3tUm*llzhmx>f4*tX#1R*GGS$c@Jxlf{1FDD=1GIrVLWJ
z$NIP$M{VD|Dh4*A3LT$|xx;G1P5@T}w|%<RB1{hIOI^8wqpz)X*7?jhi_>=28r=PW
zvZDmY^Y>y*D+$pBqGYYWp$CInS84$d^45|;&1&;jUZVy(sNn~IoyPQUC}kA@#i#f5
z7CuwGzqcztfs~*9Z{v?}nRD>7yPZ87bS8M<a3ir(S*Y=wWX814HQUq4w=X0KbL8T`
zxUYE)>nxIeQ1HbCorZzPyAyk;cwi4@-Cjjcm)a_D1FF&__xjrN#<WA7+b^8!@Wi0W
z8_v@aDgggy$!k@jJHN&+W!;Af!lp<1Bk}vTZn1Q&Wa0<PhQZBY6BXT`hghJ4(4Hwq
zS=#z6X;#*!d1Y@+#l9%)3s1vwW(V;a@KbpM$8c0_ok#)3e_Gn$uT_!}V)L?3cOO0x
zt!#+mZP-{%p(M0anq5DwV}y#2DS@xs_p#s!b$w<Nbo<2#jA-d9qh9Xr2<p6%(~=@E
zp7y90L!HS+YkMcZn3=#rzexlA`8;7`I=CYe%_g&gK2r;hVUA(@_=klvIVe3be*8S?
zxO(_F_XiLAI{YuInz|5!=n&*hyyiIj9uXR}|HVkh*?>hsMx4-ztePA<!aA-jgp&}4
zDHm$@m!q{yb=03n1Fir!R<dvGJNTS<q+|iJ9DH=LyiDrCY^mcDSoPRf*;V-B4lAJX
zl#m4d6Xn7jwO<MRNtfid^J7fzdblkwDRzErw+hu$rB4$}90+ZZ35ux9$o1#9Dwzoa
z@4Q0Z-*W4}Qg_^o%@CjQcMaLf&6C!d%JGvQy$_$%#xK|C;rWAG7A`D+SDk2};GPyd
z_fKvvZqD0HpR^WBA=Bi<jq9XGTOSKTSJT4LfaiEdqD}bt_w5CO*_{d+4{L|l1a=Gy
zr=EG8moTETE#ktVfAI}2TdW-Nb5%CSWq2NwXXdC&bthrkcmZsaHECNv%=pf05;e01
zXy3BDvo}ClqxBlZLSJH5R9C-3*qhi;#R|Rrh5D&$&4QXoXKr#E&nNz|tKTfQa$b0C
zTSV-SEt*ZA-G!r6F$`<)(~$C$1~VzNm3K_{=~1I1=ctAvG-7<!3fk9!?@F=)#-*h1
zjyJ>nK!uX}iDc9sQdhN4xMKL@lrw`)>bvR4iJg)$hTPlqIddsq-Bo)jT;Ussj>o@>
z5kj4c*Qe#QthJ*D^v_a=_vL6+F!QkQz8n38cXVeWOi`RFTaE~jYrb(#R`bBKan_nH
z38C?2%_q;Du^j>H8Iz^z*Ajb=mVT-LUJ18tJu@4y7nM!X{!|{5#d>y%`@NooS;`~8
z=|7suGgerbQOFFtATCPMgs#gbVcJ6XWeyE6r%nq~VN0ojb5hhHYCI=hj}<4+orN(I
zsnsaq!M(IBF`G&VS_>QARRw;YGwK$P)>Uaktj~pzTY@W7nAhv1;rJNA`>UU5xibaa
z<u8aT175~k@}uPeyM~%Fc{>f+EXI{7hM&J)8)Xn0ynqFEio_#Sp?bz`Z{yuIwD)uS
zqNtP|e7nv6B@x?)YuHP87nN`?5W5Ne&BX~H7|rD!XC(G5>BMtmT5`6%n8k;8*#Wr@
z6W0}YTc~o)qzm`+=ZcyrX+|0)JJD*w5w(Y6)WZ7S$Ii8!1P1FG@11EQ>d4(#j}5t=
z6^0&LHQ~sspx$;^Y5G$Li)}zIC@b8IU-P)2<xJMA$gIjw=Hb_-E_-wJIbVTuPXUL<
zXGj=3omoH5OSD4p9{2`*f!7biJZ%ay*OS*5Ng}~BjlxDwN#lJ!pW4$n)vUAQ(G%?@
zVL_=wK`4{#0d&7|#~#a>8L{O?ZC=DAO6LP(9ZJ|0W8c*|tXXG9%0jLm0N%!~-<Yli
zc8iq=t~U_i$r=@7^<baxo}_J#z4VD)Q6TK)A&f=svE##1x8a<%A3yNGmr{ii@u3eu
zCr2ASh+p`$_B8;hGu&8?p#j-MA_mWi33d!O;r5A;P?TvLcRyQLfQN)%I`J<X3Da;L
z(_d~s`f?Re5OM_uFme#i46~DL{_d)^PyDHXMhmzgduO#n-KfjEf%@pFf*}0stj9Uz
zTLbk`@x5WE(Z?}s%-)%{L_-t)t=AQ@S9%MLBivJ#)Q>2e3<?{OVgAhMiMY_cA-You
z;ihQa2C$#<o$&a@d+Q;GhgotsW;8>;A%|`s{bP%5j^z8Q3F5Olud`G9jlB-sc7JJR
zOXo=M-7)Pc3ZLoMf2m5bSjW2#nnqlySw;%*DXe(MrwT=FSjN@$s2uc1BQXO%z2;(4
zl;#{ikejE+wVM>P60W!xb)IIe%?=4>&H*nQD29>`GX&b@BL4WtCjWmLFqcx!1!9wX
z)`p21n22UtuA;Zio$S=#*u84->{Da<hJFxJqLw$uu5-SRlMIXLMC%~ODOJ{@bMPFx
z#gOk+`M+!y|8INwbQT>Y!(E?p{3hp5<xo{gtkt%iqdeLw;{CrQ&iN@r4oDL9W4$OE
z0kc6Z;8ig~Wg<Md;E~ebCxJfH2<eYj9-9!CSMbDAa4sQMF^aoi-P*XXqWBX<I4ltn
z=Sni0+>>m|gXiA_{T(GbC-l5orSsia^~T|9J!}1%CuX|MmkynraOXjSN|Y<jx?cVk
z^%98+QEX(zN&B!o*8oRL*34^9p;!5*Ho1X{;wD*_5TiHZm)ieAJ)C*=9dpbfz2^H(
z!6aa}j``h;iR#9JZNy5|UYS1D3229mZFp-B1X>343Z>wSLZh(Ab?1RF^Im`T9mF@^
zf8hZC4T>Y(r&LmQ@(|WINo}CkF@8J5dzvrPKMGrw>{w|li;H(mjGS@sb*x~L8ok~3
zju_<l{pExsJhM8j{+_b7gSy5$wyEB$GIX69=OLX-Zz|18h6rc7qO-tbxOr;ljT+2U
z2a5bg5{TVkmD(TW;r_<7?)HvJ<jBM!pD64TRX?<}_WdeHWe2@eA+`l?lk+TkR$rme
zDxLYQVcOw@1kY^1z$r&%VaX{Ku|Gg&_(3JZUWvrdu(8k0!!WA9gIlC0@XaW3$=zgU
zri)-1vRcy?ojSupLFJMlq5xSVu|9DUh`1!BV{PP*5v_)U%tppNqGi6MpUEoq;yNIG
z>1VV>zI^($i9>ocjtR4j9W1?Cju{5jUxPO~L{A3Pa(gypU3}cC17q(U|5x~3dhX_r
zVAsF{X&M1bRhBB9QSQ$9mkoAgkiZFP8g_K==OKBn+YuVyW0T=?B|_dN-BYWQ+T(>j
z=_bz&Z8d<lz4_*>xmF1W<U)hcS^n88b`CAdsMsyqFzfi@5~9S@WH0abHpP%0Q$8p%
zpkAbizz4!gXkicTKtLg)Rv_IT9i6#$Fe(mHd}}*o+=y`wzhi7PzdOXZTXd+Gmx`CL
zB{9aQx7<BDLP+ZH0;7u9DNL%qmP|+!Z1%BefOKtGbw+F0kjIanNC)!Q$Rf5C443zP
zm?|fkAOdheI*^W|DnfMMDtZAL_Wv9F92r57kacnTUOM3>)nYMp%8=juyvLo#PS_jI
zE)4gZ@}&sXUoFdYg#{FBz3Ha_A6KH9&$gPc*4!19x#$%DOD))eC_ja43_Q29Tr%-9
zbfD%EfUVjec*RmCB;qp8*`QzU7$CJYJ0n@m+Ce#lHC#ulIZ>EOI}v560O2N0#SQB}
zmI`uNcs`O}=Mo0l6}@=t_S*e3xDw7vjc^|3Uze72D~(HV(N1f5#Ce;ciPEHFa_^wT
z_E-)Tq%u5@9o-S@jscbE_UYuf*2IcrE_LwV*<<N}^%t3tG3efb9HQ>SqAuszEvZkk
zpkHs-i*ml6SKBxb6YkG>fL$C3pNtw=Iu&w_{tzW&82DwX&h~DbMVG6DTsA=!VD`DG
z$8@i;#86_r<GQjH*Vw;HU=mDYepqAs;>j|__lV!3|8*IM-q%VyBm_aLV3N+$r7fKg
zmR{z`J&ryq;N=pR5@V*XS0>d-{ivnWIV{xROVP@<1);8WiOi*Os#gB}V4oPZKGSwc
zlIMspq6yY6@b<VYb>CKZz&*e1i2JY80oK?p_o+>#1vVP~h&e~`)6->O^h8Zo)xSr7
zi^-1>sFFJP?(j3UeWjnA^QNpTkJ4pmpY}LFa4z5l(b7*dMOh^8-XkIY2FbGPDM`ey
z4ZUKpW2%}~l}E*urEjB)CR4@pH2OJY%dv&M$M@~F^f0P$aC^MdaEyGn2OCwE>T*PM
z6RIC?3Ols%U^BDrb(yKp+7tFShSN%~*KNKd`A->tBmFz_Lg!T0I|nZ&_IR$m5P>yB
z)Vw>rd!LHL-Na8H9L&7lkLNr9iCq-xd?CSH4`5SSY?(@<M-9Q-5p$n!Rt&WoAnS^+
zmH|gh-7btQ*0Hx}50#Bu2B%vLD<$M-qI@~`hOet1bqhEb7oe<3Q6lJx0ygBYR~~&H
zP5^#YI22Q!0!u~@<*sL2v0Mt=N4JjMvnJV*ra@MH-BF+KH>U)qvpuB1pn+CLp@6#1
z9v#4^<%{l~M0Me&aolq0Va*SlQ+7;YeP`Q=O{#}SPSbvo)2?R_sb?=0^uCtGSk`uz
zsCyw@;mw{XR+s_T&V(mSiz^qi-O2X=<n*EY#_81K8P9xZz@`~xifz2Z(MQj_v3rp9
z`IFS98#}U~$n}WTxnklMyDu?9mb8un%XRz5pY)z*0{fL|UEms?FYeo|Y+Qx2T#Abw
zPx>``T0=0K)JF5SsWS77IwI29*D+lv$e<mf=l^c4cku~Z^xLhiFNtyEz<cVgkMN4z
zQrkdC!-KnDA|t8rdkqE!A6ajjXbBllqLw=&GM3zp0DJdn_V8X+p8d$0uCWV#Ym?jz
zWtJDN9V#Kb85X=r$zK?tL?;WpLjIz$BX1SIR1JR|(S525{KkFAfiWy_sv?nj$7Hlh
z^(I8b$jmVj#tch)Q8y_fc*e=mO(0sL{fy<dP2$7C$7z%9+0;<Hsl4Hxp-j|-o`@PW
zvLl@Vm=%70?bba3E@t9kY05)Te+Nw`tjj7g((KSLB}7EJ6ZHWoR^rzH_Y}cRGNQ5G
zUxsgO9Wq7PQ}tlrW^q)HDd5fUZ}q@enZ<<TR{VDy<M@p}FSj1EGG6)98ujEaeMUrj
z1?0ViYpI3ALjt%^ZC-Krh*+F9CFMj&CBcOVeMs1n|L1?|H}3iIgjaF-B~krXX-}L`
zFZwaa=@KyiwEQ)j{}f_;oks#dqvd!Vnf5|(0l03Z@o34m|CV~Z`|OOiz@o09k($Mu
zH+8>8$bo+I%D<%~5$OiNDtvTFUN9?MW3`eGHkqUIF6g&ocq*5_)G7_yBWROVsptHl
zx$D6GYZd14^+)CTKUM!0ApFE^P2p<_E@U8(qRo)vQq*{{c$Yv8G-OMtQYVr7jMC5a
zZO;(XfNsa2UxEw4_1*?W;zufebNYWV96Zeix1ulXe5*fZbT+wyr&Z<SGZ@56&;mPe
z3s^zp2htCEkDI1|5pwE(f0OIdgDAmWARf_o+McQVmZL1njI+4{kuf^cULZ+2YawYC
zg3fGTDi0-C2b6*)lTEcxOa7Lh`~{R<!FL~I=Kjn*m%>x_!qJK+>d=cwP+7Zgw$P36
zjd+tTdc34?vPZlmyl1#e(;iD~wE?(Brl0(KAWvQVsSrF;e0!Ir;U5sfSE{392;fNh
zxGLMRO)-5sy7^tu@80jHZx8&*+qm%Y#af)%j!+o&RLz;6{j}6h_Pj7nxN-qxRAE<t
zzW$_zP^{rU-}cW<vDCXO2MsEl^uy%2S3YS%JFqW!O3Js)hwj^iD=(Z9_y?o5f0Jn8
zyIgYQ0Z8I5BnKJ#<s9^FP6;$`h3~1+-=~+^<6S(h5Z`ID{6nSlus2xKU6wZ?{|wQ^
zO;uFH3;Ad#XouY19dEcET)@kFJQ}q!fIZ^$Uygn3^i%f&+S^WeuHSNvJDROAaW5&x
zD(ApI18}#YoiJR`hzx)?Gj3}gr6Q@S21MR^K6guj_f2CZmK2oVcx-SxIl;7ukRm9{
z3&4n1zn4JLwwas%e1m9_QUYI1Fym-(Y4M)q_=jLi3R3;yra19Z(UAu{!D(7;;KV6z
z&`PmW5oAf#!EjVCiFNsp)vX_u{~5~;0ZS-pa9}S;33UUt{1+c<#S0Y76C?qt^Fqm5
zOTIL5O7kfyS%MNZV((;Fy|MoNQnO~-myU`UUG{Q$BYp(E*<T(tt}JQW8(k0|U1hJq
zGv?D}-cV^_cZWX{&OkzX$Y14OrTtEX3A_%3{oO_MNK5kk;F`CMtw@pM8+pQ^&cXSD
z8h5oo;);#}{p28VtNv!){1vi~f0T~j^W)(nP7LcoVv9|V@;$ZR=KSbRcj>z%@pc{a
zqW4g$JFHYWAzybL^Q6@o*{FBgByxNLQI}VL+{^a2^y#VGu}`0;H|gS={0PeU9XmAO
zQ(ADOFW<QrcVEt>=k-y%(nq^rIZ5z6Dzbh6`n+zNsTO{<GE{L9x&$4xJD4x`%a`wl
z8dwhmKy>AbZbg*}UVgXTvS$b4T<fMw<hz}qQ^t)O-66hgX7*4EcU;Xk2=pdwf9g<^
zxey6{%=(Z&XH=ARK7`StOiIpfMS$Bh<Z$1Z9bo;_LI=OGoVrWA$eG6{krSzPM0d6}
zU5s(d5H@Lo51cFXX;lJFinW2UDk^PUkKkNwkSqj|=DHvds=*_)D(1-bX)h@k)9&D^
z+-7U(Lqu>JCyOaQQ@vYm=f?x3#@-p;t$u_xV_B^11L);MaEyc<s6y9*|485O<uIuD
z7>39qyd*d^dgS&@R5`|F5mT<iQ|3NI8mBJBb&R)M7h12mo+oMf^_`72epF>4p5EE5
zV^?@pgG%MK3V-c-dVG~T+t<h3r@d?p5X;M`H{Hy+o;5ZSzW(7(YEBB?&#bqIeEo1=
zcl&ApHtz12EOWSyTI?PZ;^O9!S&aWu=ZKm*`Rpa8VPK`fNPbh{Wu9Urrjn_9iq(XB
zJJ1`SJGU9dfgOk^T8hKKrtFPYJttV{>Z=Yo&>Yx<jbFd$l=Ub1g8~ExW}L57?0k4w
zsv9%PoI^5~D~0d~3~rb_l^E!_abC4lbe$Y|zi1zxU*>fvU36^jhF#tip47_P6a3AU
zE1Y++ttEi%)#$oy>Nqfwj_0O|2M``cVd=AD&P+9CvoE15yDMEs56(SIE~03c)vv)N
znpzoZ!MA-ToS`J`#sXk-)~fNyHq(Zur>wDuRO~YMS|Ma6_Lr*h(g9C<JStkUEjI9X
zCM@U4h;)LCcuK%sDYBrh32%U<J5NHm^l~K=;A;`{+A2QZyUGVx0Om=c5RhOr9h1eA
zF<gzu!dldXyz=&0#k|<2W4f~X0=}>_cMAD=O_iWC`#6o;UCis!<BWqVt*{a;in?xv
zDMSVxT1?JL^yLs-#?*AxtS51Yp4aLO)v#WBYIq%av{JNmmbGj~QXVVE72)oc8_uWA
z<-OkQ@GU&s34qZljq~5C4L86h*K&&&eWWC8Dw$au{()~4Bb*M(WjWP4Er(s6LUHy4
zpA7@#lQezVpR-Sdy!RM;0HRmBcP}{>xz`z@UTVpzEKU_y2zDRU&31muyg@JABB%H9
zP$^`yZr}l<r9M)L_dqJ<Ds~kH6$%#o|05eM9|QR6XFI72iS#W8NbUuVo|K(%*GUjx
zPKhcre+m7mJ$wdG9cqbtfK^y%aw(UnSFgI>TjV0{9uHO_4CD}{ZBoTY)w34v*_CV%
zu8u8JB~kgIxfUO21_oQ+?m*;KNw{XyFs;e&`UT`5oBPOvR+VW@wUa0Z4bLjQHz8H6
zteh4uCxkrzj7^Tv6(UZZ4`wt<b!q@g-#zoeG?T*RNUda%;F{VC^Pvbwa1aHchR2K=
zzYY72rc4aoe@`vgtrU0-O`jtVwLKn1Bs1nK=El#^Y@AbW5f&MF&{poM&+M3Nn+om^
zdZ$PqTW58ER@bu8T`^aP9w}iCP*buuyvJ2v`tC%mwu~i{`X~;JX$4@StPYjKdel-}
zKQkF5wv{EXoekmUjSiD%*kyE_MxoVs9R>Joe80-f=fais2I9>X^89tRm(B$jS#~MK
z%nJ4m<#3PtkktFlpR4-O=3Xq}Ks4*5RVt*T*aMQ@qXWfZ?=Rz)wzHV)^Vyx4HBQh<
zV;CcD^$|S-9B$$EVP$tej=Su!hMd~C#6(_Tt<<^=#%FtULPJPpR#`7(dziU?%P}D<
zYxle*0#igu2<@&pL6D@5Y<ONTo=OKjEeT}Gl1t(7A6eWje&9Kl{&##K6L2ryFLb4@
zKx!dns5eqNu4+ctgk!s6f|a3x!;ET|9<>$~76jv4RORqbh-37dkVXiX*!Sk)kPuBD
z*6tC*;slwux#^JiDAuQPU*zMGG6k<v1T6C+G}QYJm>Y8ARSSh8a?NAgON8`Sf)IHC
z#fT7A8yIc9{&dG~hu_Lp1-vAp4CU)$O5Y1D9PNS^W*i&Z{<6;P?uUnI;L5btav|-P
zdo2%l8UqyDzn=4d248+EFV*m+EP3FBaMlpOP!}1;(z#Qqa};-TN`~dHVukIcpoP1#
z>RgMJbNNH1bvH}jQ+aFk`aF(yJkB8fn-oK;+oMmgdrmg{$%Q=tnK!6>4bA{h4+071
zMJkL*_307j5J|1FB;vi9Mz`6*iY1o~8?e@)*9%E*v*SZ;aSK;zs_BD;gcg=q@U(mF
zl)i-j;`eDyUu`hym6mk_hgUWVO@z8l9E0u3Ok(z@M)p-NkZw{w-14oPg5FQh#d#g~
zLU`W&)|>9dm?F0_w*}jfW&(j{acj#%Ypr`$5Qj}ZP!^^6E#M&Z-mCXk4iCUG*tg@*
z>1_#zzqz1X--AOkzA?VpJ;Gb92<}`suI*X|38AXuH&QoD;p@cH*Hk*90r+6!TDz5a
zx9nkJ_+@Yy#UQv*WjwsG`^LGq^cg?kO?0qn7RW{B*wd&Fb0uXYB84<gpNm8RuXxpu
zlXQYwUIZ|fwP~&6vOo*3C+m?V;rc>*t5@nrnNcildecf3PpA}n(~G4pQCTvVM!)0V
zieh|I`8GpNziYRm7m%uR4m4LxUo)K>>+Kq5$!B`UK=8bk<N?8RzH753%~=bL-?>h^
zT7|#O<lzfpqNCv0<QEY0nlci?uTRmic4-Gm{0QMl^M(_a6Mq0$dbR>@g*GFF(?qF5
z4Guhdce2i>PnZpqez{P>vUz=dBjTMoGsBdGSyY?f!kG3TXaU&{lyQBnejfyY^b)7*
zQ<!E_uLPY?o!?^m>ggG4tp8W{kaEH?|K11r?XZrVlv@TMl;;J|tES)W)!DTph=nG<
z`2CRgmw^efQ9U!6W-m(poZBJ8$p-U>SZ8%wYUZ>hjd`cQbmVb478+fH#sFjDxdR*P
z#Y}G%+XE+m&Ar+!?WXO761fOCC5`emaipE<K5xj4A-{LW5zDSBw;hU6@5&0j|HgUr
za36)turO&{92pS@l;24AYN*t(jS&)`1gBCC$%ZVrOy!CLPc^Gg3@Jepz3Y!_hr7z@
zQkD7#G}^e|8t+t?_~9zj)@>aj&7XZe?={igWF~^A{pEk8=c1kb3odPWYP+hyE|x4_
z*8(gpn^XgOt>en~i&x8?@JIW{(yxl|PG1R93l;M%NAA79=o9iSHQ148LOXhvWsu2#
z-v=w^Zq@W714fbcHSx7g7ifJsq`GeRNROE--{*@9?uDY!<AB4|`>)kZq!xmBYL2&k
zOOx*NH;KSx9bhg+y0td6i2P1F7;}c*x+msU>Nm=rBcyG9p~Fm*lkp~r;>PKRd=TU4
zF1jz;WY%b5Gybd|jS%z)VadEv0y~EkeP-yJOH=l#wS_ywLLp&VXtn(-eVP@IIOuDy
zryPr!13HOZ%AfP~>OaQb#-)Zxrp@pUXB<G?7PM5-oiC{iGmp8Ec}B%r<uD*VYg9Sr
z3@Gx-?>tm^pT1)Nr4nCL=nXeP){phAY8dPkcMtRl_j!SW7vrctde$f-jl~GHedOdM
zL!$be_q!!gRcnc)mG572wl@vO7n*86jouW;&LGi{)BZMMkBl^KoB=Y2!u!*u81C(t
z<*aEJA{vY;0I5xxLA~`<C4Ad{_?{|3k=(kB(=!6|5Uy#Y$<Cny&n@QSO?!`<B5|G_
z(#I=>0v#{a?_o`M(&ua@4OFKrMVf+y%dYNJnGf)~j#?khwhY%od%D%IM<?eLV409C
zehYR;R;&+n1jWu0d(}ZN*t%@*VtaPkKyM?mypUIjjlZNy9>H5T4?gNEo--kw)|;}5
zWFOkSR%%a-i=+7<^-d`3;HSdZE{=OG3cr45WE5DB6?cOg!#x(sU$s-$fr?vs^>bQ(
z5@(6$l&9p+vh^Db%Tc0o_0tVDZZ%~~tVyqhezca?*tNyiKW@3WX7<p7V3kK}yL@8W
zfWFU0UW{{Lsi|B_hmVK<6#OnMk2_4Yz_OGNX7Mj<u1+2RNflwO^z)^yLYq862%btJ
zRo5bdQ=e6U@t43EfQB$%m$>Jy{SID5i#9<3BDpxM{Ok|jffH+Gk7l7%SrW;iocOVR
z+7Tdw6A{7c1$K2yN?7ZlfQHi6N^124;Z9NZD|R>TZLW8u;>vOoB_^-(th^Ow(LFI0
z3N@RooY1Qwv@-@aWUN<oPk3N8hDR?>yW4Konls@k;=`=s9OG{9vX=zLq-(~PJYB*|
z+Rcog8<r9$Z1gU76lH6VFtexs<HJ)GG#;#+NtL2D8Z>>^>vF<Q$d~ze#a}oDuy{9j
zT-OCxm94!cp}r+zBGTksve)xF(aHuYc)^(4k<bQ~ym;J2Vw`uI(2fgFZM+Y(*jtY7
z7@ZEugt^mV{Cbud<m%WtNBv0&{7(D{Od$8&-mW)3Nu%ghBXyqxdtFto1G+X2`>xcq
zp41`i&z$gS&YOBhYGZf=Gm;iZSb^EBu$BoiuM`E0w#z!!XV$lx9movZBN_j8nb<4w
z@DgsW{$$#MSMUgaq}31Uf$g7b_fxg1g!s&abG?G6$F&*8XuuNJ{8ATNzcUnn#5Hr>
zlG|U`w9>P1q;QXfNO-v0h(L|{zS35o=q=yJ?|)btkUF4Z_c=RrRD(Wodch$y_KyMX
z-7{W+7Z{7-T5stA{HCFw3@RZ!BuGWc>2pe!VV{_-jA{4p4b_EiH_UuTN*-=Jap&yD
zv~jA9=xDJ=5^DYwr)~qe?9r^CKD8vb9Wh_bc33n2QP!G>Ec{qrc&(t8o(3-TX29>u
z*-pabYyw)F$8KB~woDS6j2qiLF_g*W9R^u>=^k5cOZ^$fa;Mr0t7ic7gFa}JYl_L*
zOhZ<^XXRIpb$s|29PZw>Tjr|?%6fgToZI%n#r)15h_G_Jz9-@v*t25e*uI2I(L(wF
z@1PeqvqYQrqCz#rpY9lWQCD%n%i1Ld{McJc=+WhMEthC{Bh{0`$9=b>dtUKB`0;({
zlX-mzt}r_Wa{)bo_n9PjXaZjaIu1LptYeBNJ%-{Ki?s@&#`##`<@&E{yT~J%XvRE0
zVnELaqYhNG!a>IMEP@v^diIxI1~_5YbrurBr&ty6)P<y#9iAbO=sI;&W{2*lY3FY-
zNvY82-Ig<ynU8+%3o#m05&F!nD?MCs=5u?E8H79x*uqlN7LTuQx*S6<X~kP|?XSk|
zSYE$toS_CN|E#fNisCo#LM#@1lMq|zge^%u`*C}IlVORZ0#?wD)<!$)P(WO4%5mZ2
zooT#m5}Y}VQ2GA+$*F;$ye%&3fmidE%0!i=Bt-HpYdh9;B*2Zz%^scn*CxLQSQy`A
z6<>vTeUHuksYI{Zfv7*>sUpvIDv^3Ubr+}8s!-UoEz$EG<D9<&iPe^jVQRRtKddcK
z<HKYh3p_MRy>$(C#VzW=VPjJ4)@YxP!Y8lwieN|E+r=fWEw9E)fs<@21fyvk>Eo7V
zN$PlJ81(~1%i^?G5cja}H6<Wy7wDMQ{ov_KO+CSCDWpD;T~%9&S8!HOM93E=#8xW7
zu4HL-2)9YN_$sbG%`e0M`)g|juaNL#eXZ;1-`8WmzP{96zj{B|cs12Z+Rrwyds;SJ
ziIfIMYQd1K7nuXwg609oOj?S@*_^&vU2V*_N<!^<HSlsq2=B0njxNh92@<oUUMzL_
ztyHeRaqCQMqAoe$BPQ?!*UbRGZNBB%gVWp=BfQV_OpajH>TDG!HG^rHuIN~6)au7^
zBfnQim79K9?4iu7`Ce<2TBz;XX1Eg@a@>2!bS}rwx6_HHNj6~5hG047CR~}O9pSth
z91=POXR?s?QZqh+-5yQPA)+^ZhWhIY>ec9H>L_n7w!ekY>xbR0hnDlw`TYGoq58Zs
zvdS1JtGg7Fj|ZWDXp(Iw0;*M7D94}chi5?3G`82Z`*_SRTqfi^Smhq6MzztR-cy4M
zfp$__gDOC*Fw2ZoWl93`J#x|8iQv0z_$!tFlGZ;}w#NRUJBJK@UnjKPYzm(5DA|82
zp?nB-Aq$)1fVAh&?cD~wyl?Olr2(^1y@?2s?~>cE7U%H&3CnC+C=gSw>B`esteRq{
z>K)}zz|5H5Fo_@0ZEA<ili9&rr7fK#IIU^qvUa&Eu_<si8{b)rDn52bZQs+{tY_J;
zvtI^?JMh|S=4*S(dOZYZ62Ihkt4v^GsGF*^g!W%dMDz$m?PXKBVZoMOhBf%K*+^Ne
z4&I7Z0XVL*n8WuCPHELSG+^-X^0;zyrZUtRu#go9VL9rhz^+(3wYdN!gG)oY>zBEw
zE2&($E18HK3Z#2Ao9AZTz9HF{UOf)_El%p%2hO#W(j8e(>_@oHF4m-N@V%4H;z|p;
zT@>F%Cv{$ApyJIl-z`U<NrleyRx{db(Fv3-RR|u&JV_}-u{;_#$`;w$7L||(Hg1fj
zu)Em|FTpU4G47cHv|U_C6T~A9Fe4G}Ad7C@YRZFfx7-o=`<c%Jxw(5Sl_ooG(#2Qq
zUe^cVHC?b8V|ChWjphA&wp*O1j7NjrCIW^OPUnSIl`eg8g>}0mKaZ}m<7A9j_%u(S
zMxR38Z@CXkuci$?_X!q~tQL2fKeBV&GfOC&^D4y4IGb{=`0a~2g?BY>HF3m#q6S(A
zU-vOO&Futc@3V2Kuy7kji*W8tVu-du7c>^ms0n%K8#X_yL9N`vz|<=GZBVAH_;&AT
zmyhuLT^s(Q2P}r$357~{r-S)r&i#4~gvrAzrU$$0d%H~V8>g?U+~nhXdicMex>%{R
zSH~JVqZ-}KhtBY!VfOg&_JC~_XfWH9O$P+8G%6a1^YNK}_-{}Bg69wX_n>DpoS-Yr
zfS(xi<gWh#i2s-G-@FwvWbY1cb+zaKp-SgnJbI7@b36=K&Ys5?ApeQg58QhIGU9*J
z6j<B}4L`f+vcH6ff*+9O@dRVP$)~?43m#&=iRwG?3WB`M@O2kZ!`^@LJJ+Ru@dVFf
zoNDj8%sYUH^BQT$G<Sr{q~<a;#AT?-HT6|S{rNvIbzO(tT9xcZuHC-PBuAPZ{Ks_p
z<%HoM0+yPX_wIft_Inf|l5jH03CYc*6eFT#rv(7MF7NJcb3)y<RYx5UkhwA0@aYtO
zP+q`?ajtmx|Hef?Hnt<m1{YI|ywuy5o)(N#mu%U)Z7K{#ll<Nes%&%m=ez!55!97K
zN;QTJT|^FdmNY}hc=Ps~jc>DBH01Nd;;r)Qe-yj(4gQ9_|8mmr2g4qK(4Slz0m_IX
z#}f*56JjZFbIZ@MpTH>iss@dBc(w#%FB$QB)9@=<{Q}l!WUU4F?)X|%o-KP_V+ls@
ze7{qybkO-==l{<Am<d=uj|L%^R#`4%7Btc)>^wfUYWJPP|L|!pmyz1nmEz5?{r*gq
z7sZ6<9HHW$XM+zV#-6cU(Ly{&+?n}gnTkDYc=QjoJC+zg2{@*wVw8ftntSr-pH4Gr
z2US6RL&J&~jXE_wzI}WC;pBnCZDulDVzuKjdmdACZt5ouXZ9DdB_rz00}b7-UYb#L
zAG?FL0=2Fg+3b(6I_jSA0qKSOnCgQ`7F5l2I(Yh@i!Z-zA8~3Y({l6JmXjQ_c_wHV
z$k4FN!nic0yTnw~wCV4+|HmQnh?%&qz%7@K`wPYYqG>mey8qo|-k`kou;Vwn`<tKS
z<NN>ksQdq~&*A@X#?5^8!rd9nnDIrwIwyL1?|&Wp|Jvw`Lm;6hO`nDJl_-b2QhY1C
z=epfMjG;j-X*knJeM!IuG2U{=^39DWbtbiqs@0{wv_8<-n~7VFEL<S&LU9(-$oo0w
zOl#xe|BNzvd%Q5<r1^sQ%bha~Jxf0tJx8QH7DUXJhLzIQ<vgTX<P*KGJAN`svZ^eZ
z2+>oMTYmrwXWeM57d{>Kzm699y>hu1gM{@V21iDcG*Dk>MM?uW6T>zrn4N8^R4H?p
z<@IO(^#>4wki5on!d5|@7=Fr*u6I)KzHl$u#-uY>37tPaate1skeHoZE6g_2(4&?r
z+HoIFtO|*o&beOT{RBgTUz>j`sKOHwIBLitBxC0tkfjP`o`X&2uij`h^3L?XGVc{`
zTOf-z%~U+-r;K^I0@TFVzfEqtRpbQ4Nf+Cf`B1_w3r0s}Fg%27vXyWt3R!CI#Z|6#
zu-oY}wP7?6Y95Elg|aN{psehdSUaJUF}wS{GKbbm$Fm%}$5*WKZw=1QHktnTufO&1
zE)if2O51q}f4Qyb6f9HnqQ+H&m^6BO``sgvE-5ZHg+j_R!Nly-0I+7D{>h=kv~GWq
zi1FaVB{V|+`U27^HH%(S8g`|A#(yHtNEJl^*-RD`pfUZ@2=KyNC0MItcL@#sStn%z
z;V68tbk&?Y<(j<YjgTsBs$e@o2Xa>iRNac<Na87*ef8m3m;|z9X>Hy6OPI~kg`$<o
zf|UQm-g`$ixwUVDSP(@4kElqOqXN<e0Vx3$6_wsXZ$dyi0-*#0Dgr7}q=XLA0wjT8
zAcPhWQ7NGaNr(`NN|P=nAblP@$M-${JZomYHEVrq&6?q#@CW4C&))am`!3ggT?{S!
zd|K|B{<nV_xttlpvs{nk&%AHGP3s%vi3?voP;EW?MvDR_5=lKZ6Un%j=c&OL;T9F{
z{Mu5f<q{^%6`FdMUv)?#W+qq>fn*a@DgV%Epsa9z)+>x1OqE?;o|07o4GjhBsSrK6
zZaciccwF|sEE<0wE#Cmgijj=7b6r*j1!9uu9r}9=VtazntGC8H6hvp^nQLv5z+T!$
z==*(Smpx9SA*o9r&^Uj5{g@hG|BWTkIkwIUduH_QzWc=Iwy5>PUZ>6A7ChpaE(<F+
zJoI!Ls2I|)?s2i-pX<m0mTNX+glU3?T-Gv)-Br1@6rYt%!;>97#9OPa@u1Wzc}dlL
zlB`CSv`NdkywHs$mI+>`vNXPkPdQgo>(!3tuVcd+QNt?|bhjzgR`N{Wv#aC3F@j{d
z18~vI<c^e_l4(QYji!f15HGm8)EJ@i24S&~IgOpnxiTROkC&URv@u8a5?oX38R`J*
z0O)ddQZZ-d+EjL2@9z7JshQ_C`<X07>z45h4W&V0&wJ6p#mW{A;Ol;z%=)Z9Pj^+}
z!24f|zwR;a&lPd(UdbkngRr;hD<dvBcVOSDbdGr>kHxHqcUKh?JQ9lORGe~d;ix8I
zcE=DQ*)I$s$lvPA-zc~jh4LB)rhnYtMDHeEK<%Y_0?-n2)KHSX9K*%}Y+nDC$5;=3
zq9MpWHIcR|ysrlsWm}0(SPw$4tY*UHmbT$E>Us7z!6RTJdaa{wRR6Zc`D`9$avy9q
z_gmG!9ZbS@+I`;hMzZi;q^JxupCvZ^Z1*1kXraD?gZ=i%HI>e(tHtJ974F_76=~A!
zLfKw|_Ds?_4rE)U+H!?<=CR0RpdeR(nM74H)YIlCaE{w*sRanR0XymuXc>SUP|lgm
zAHls@aUb*-O+%bBlc(3t^;K-W^53!%urj&!+n%ta=pbYVgDERt+dnwAk#NuDU~Z7o
zpz`kN=fQ0;)fVLU?z3I_gjKRD?`~`U|8|a-f4f`$_uR^eN8p4wbM!nSSfzG!s8YU1
z=Da-Uf^XJYVVV+yH($sh4H0*J)^*z-=sa3hE>2g_L!yIZ2l_ryqO|MCSVe2$8mMvl
zNqjM*sM6Dhcyr1%L$<cm<xsKDcyXGlxV%S?pVwNigqJxuOj~hd+|wNY!7U2mF?<d}
zm%crKXb-A`^I^ECttkOLs^$f>WISkh3&>Rd+yQ^ZA}07zx({wX?Z^>jf$3*^--d6D
z*1_Q0p9?xwRq_=b(qxzHmE6V~#9}etNK>h#xu~JV5^`;Rr*#Bw)}Ud?0VgRX=RxGr
zX*jkM@KP^n*kyt+ZRlZ^$r>^N8W7pXwc4t>RWtG`uv!fiYpsiMDwqjTB@XpjFU5~3
zt!5@c8$|C}!c^)ex78{=z#HNxI&VM+f_VF5Qbv+`1@MDW@k_g-e*N)R$I!3?7Icjz
z%v6uG?{MBwo=Jjf+j!-r54<<Zl(*<yRG*NurpA2*aJQbec-(=f=MBozSd9|mJxn0v
z+z)<V-dOu+vtVLFEs^Ok-6z2egTAAymvs(<6TZ}Nllf<Bh^Awg-RkO7Eg`dSs@#j<
zT%>B-2wsd>u^sI&cz)oV2$UZWLVw9BtpRb|uN5Cs+#TY#$zL2nRzrH8@Hdsdq=U&5
z{Fu@ULL&w6bjPL_f(7AeE}m!2I(opIR_rUc2!~WX%=(@C;Q-Z_PVC1&SkMc~UFg}{
z-|2Fcdbx;?(oL*jY};CtE4Qm<K)Qzx2e@#)XG7@2^be;+4f0P<Q%fjqbyiIz@yL@f
z6S`$j(n(CInrQMD%R#jEr|)L~QlOd>>gVU}7-?3MwPMMM`#idrF&;XWPJ9Tp8jX{a
zGA8&u0_eh`9o{EvVB@1n`F(y1f#6Fg%Gj&tD{@vyWsgkorC@pM)epq)Wv;%kvKl4H
zI2*B5f&0enf=^XPIj-!^1Czr~%*@}thz8QlYLhm{0P3o#f@Xmjfe1&w3l0&;N7R}s
z#qp8FCq|{sJd9?&4s|o4n8=9!w-+m4dsi_Yc#=B}Yt)Dm5Cp*aQw}|F@BBs-SOlsy
zhtSm3+=HHFRvE1)IX4_pG_ww@y;u~QZd1WApWx70=VTpL2uVK_GSNB?cijQ?I!}%F
z5ATjlrvDe)e^haGwTMDMVfBKag&3-7?4h_PHLYARbkQXd6J}Lk)rC=C>oeW6><Up~
zd=urjDFqen>xx?ZpuN=(K&sZ>L>hrSHTf_W0HNCjlbxwQ%mIf3Kfl-~edZw83$5KU
zt_gj@BiYqyNei+dZoh!d9?>}}_&3F4Hu4wDp-e|YWV_LP=vk4~K}juVsU(xkjnR)U
zth@KcE*=EuUG570Lab&U;<%E;dkCE1K@=lqx;fT(PM4CAn&U}lEJwV_hrvlj&c$g8
z@pkyFCmEpc9(`qZvb1fhOxVA!x3WOSh5~|SlLJFDKzD=p4NFF8e@zoNGs*a%P%WK6
zmTG(GPYfMzHKZOOs{MfSG5wDL+UZ!FsZAJpazhGKDbC6pc?4WY+E++bg|k3ha8^+Q
z{TIEJ+3%L{vVxN?TXqTd36;llJZ?JzPT2GH;3Mi|cJQE0A-r%b=UnHhV)Iq&tc`O+
zg6IA3J`@7Fqj<{Y;kIC%T1)m67OMh)^zKU@u48!|i1?Tu=>1H*{Tg~1eset*pQ5BS
zwOKgKm3xZ}feGR9A67E^)R*$@4PWj8Aer8q{WE8`i>dv8d$6YEf=-Bdmkt?3c(uKk
zq&vPFC^mFK(%SM<OK|VCy^<kvoQ5whNV6IdFG{$WHtX=$MyEqUa;365FGwn!z?VDr
z-iAxi9bqL|h^<p#5%5jY`>*f;TwsK;3h9b{>!ngoPFd)!Wu-cqKd7GrPbOFtr}j&b
zdeI|zr-zgxmn62RT-rLZCIo-BeS>fXiG5ngoesH?*&uN|0+vdt5QA|@rRLZ;tN2@)
z?m1rgi-G6scqEks1hjl9W-}yH#M0;LHBTy{1h-w+kwEfAUTeHqaB~*bxrMu9;StC!
zDoQP9Ec6RUrH{8@5W$oNMbh$9KJphi>yuu@VLlPKs&ld6f_bdHbvXv`?<qYJPpf&g
zGZ|5w4<TR1mtx(B+P2QN!_p)qN|~?gOHWll-x=Q{iVCDz*Zx^wI%K2<Y>vy->7AaO
zK6w**e@3x{MyBzQr}vSXbWB0MzKfu0=$M4O<o%hd(!HYKU(VQDa_R@?U!0KREpSTP
zet4Am($l1==C{36**;2C*aJk+@>|ip(d!@Isn2;_&THa{ad}moH1!nkvoYW?)eM_k
z1@07f6A{)AP(5)@iif#SfTIMbqV4#-k_<Diy*#{_q0R*fDHDdFHC41+0X5>N9*lOc
z>J{}>ES{WBFF^VrB*=~Qnc|)gDRFIL&fKCBoXZ!YV@!`@B4YVzCQR?denEeFFl3<}
z#Bmm4rOP{sVq^9F<dD-&bvK04E6gHgS6kAO+#r25UhnPMnk&o-_Eya_d)I8=3k^VD
ze7}_9Js1@IX5;|cDUB1e-W)q(e&kJdam@s3Th&IvgroHs3-s1(@ks36L~aaHP^A>j
z^vv|1JI=5zmp-V_LOFytBp)C2sc{{5OzqDN;X50AQzvQ7lH%qo?l3N^e|HM9IAely
ze8-xK*N#-2m36oy*<5k+ufeq4;eUx<eKmRg1Wjut_o`6a3CvLAg2dI-oc>ukIz^sg
zV=hPNMx(W@&bm<+Y`DZU9(sqFIKvh{4z@y1T<-oQXLq}A6ao-C&XmM|AY}9^qzfK)
z8&`Nc;x}}Lgp_})vA<}td^(JD`Ezkmx|AHkBSCUJ@P_(;67pRu+b5hr)3uB5N7BNL
z3To_Ag9N=Skb+gmY=k}Qts2Fe%TE=spbd&(4esWItH;RWH~;JwJ%RUi?49BE(JTp(
zF<e%cwRBqKwyMgolPA3zsbT#u#P&ym@0`aMKJ&_R^2c8z7~-QbhiWk0s(Wa<G(F|<
z-pVgIUi?Eiy!A=6U~uuPp-aejqM!#P|0C1+_P37bPfuDZl*S)eQoE7U#*Oh&jf&&N
zyx)n5&CUttQ!I^-9=@qFB3Jc6snNC9p&6Kydq3yoAS!-peX{4nC2Q+VGRadi`}Ej}
z^AJeo%(UUSwluaV-ZFEo2W~CqI{zGDn}C{-wj`4{bQIefqzH*7;iNANdXSEahczgh
ze3Cp@;o@5VtX1|FzRN2wQ-l)oTpGyO+%~cPeubwGnfKD<tYF5m*B2y1fISPO+CDv{
zjIcEOs-jZ#yPUmWw84JtGufZ}Oz4C!1iBdtCX{B(?T<`wT#umaL`M%uiX(LlAx4l}
z{eBS3+IBSdwxp?ewpf%xFat4^3h7%V^`}1l<Ojg$j4xsiC7+L)@=8!aXztkbyzI@y
z)LNgUyqhh~l6GTMj2Vq6fLr;s=5?i-Tr)$PkIu#>N8W4tElAue<~+6Vz}@?!7+b4N
zaq%}_^E<hei&C-s%&eOapoim>paCtja+U=;4W5>NQs;0JAx-TK{-2K*7iCDW$<bQk
zkxyMnHh7t-^C%ruX?$DN>I`Mf;8V5z+CWj=XZG`0eUc0`nIu-et&qyq6&%c<mG4L2
z-nd<DO=vv~7Vijy`30f1P3Z<Ua@Tn#yyBRn4Ptv|X7xPIyl43>Sa0!;Y<G!z)U4D&
z*LhMUVegfo7oII#q+RcsJV{kBqwe%VRv0|hP39pTo1%OkmP)25aYM3Pa%Ss+dN=1O
z0bEE>Aly96qyW0@C~cN0;j8UMsfE~hxN?`y%r*xC9ACRv=s%L1_5J5?S6CuDj7Aab
zNkB)Ee0lyrq6!F{E=<Zt%J-m1Iw_OOW*#4is`T6-#rEXe0c%uW2&3{YcYlPumSg-O
zQ6rM>?NUWq*G5+ok9kjNA-Yodq)H=-@EpMH+Aj^h8k4=HN9qrGuJ|wMKhRtO&tQy~
z7sD&zTIDx6r5F_3IsSCTn{SqF7>PQGDo&*@@Cq;8ZKdQpah9}-mfV78t{UNT!$r(!
zQsHg$ku=fo_?|~punVP0(6}qfBz+#CK-P7xZd_@GoKoD4bB~A3&uo=$ZiaJ>?e;%(
zL`iSGNemy~4PmW*nySlOA~RCN8A;XQG_EE)$iILshFrw5onxFrhoou{_ZVSCNUFZm
zL;<za_?ZiWtgjyzne>#Yvc51P56o(T{KPG8)D2)}31k@?Al%P)OC!5KZqv^I_Bb|p
z{>)-+Xt3t?I<4W^PGR9zw&HO7ysCDUMSEa&j5;5AA<}`>PW5Nh;oWDsliU@z$jToh
z_Vm(o_e}9I-ES$}A^mo80WC$%qJsnV=7>pwVv?ffv>Zn~>#~`N6LtEsVp@P-m<gli
zeuRYFQa&=NSlK|Yw-!R}S(Al2MPU@|eJch4i!0$A2_x#C=2Yi-FBs!;Pkd+nTF`bl
zS6B{e>t{z7tKj_Zkd(Kd4_=r}jM~`*K(?kkSk+1?V|J!Ik)J^N7bmX@7ivBn8((3I
zFRELx!`Bq+SY%$f&G6nsc7x7;px~@MpD0f?q6`stJ5s>iRkG0ZhF2QB3VQM*L?^FM
z*UVFb!0PlYXn1daPB}@y(S=hiw<Fid(0Z@|r`3V~4x{e^{8K2&lC~p3OCn^g*Lw3a
zojUh(;aaA87Y`ZQ%nhx_8h)`ci;EF_G{VtbQ3c1>DbL%P(AXsRg~zT=eg}9BLf=oN
zs4aF0wlSvXTjxV}oU6ARmlkinWM_Jg_@|S@Jo#Pd(zdsDRB}B&6sT%7?Kv(oR0w>l
z-zIm0gYrmSU4AgS-p@v1`zu>@$d<<1#5~K?p4Xzk7S3$bt=6cKi|es!nU+m|e<4?+
z>*Oc6GVtBa*{?1k$z5ALNA`T{ImCbsa*Q!9Ic5qJ9cIcC`sL;igbkE%s3md?tq=Eb
ziwQzDkMe~AW))?J_xq;C5BxgP^;M9pP`y|ays@LIv=J}h#$c<KrD$N%2yJI3LPYga
zBW=#_Y&ML!2k<_Wcp&s^MM^iewjdb2{guHnmfgTxDwp;zLp4xGE@+@bcJx5SE+V-C
z7%vbt)rPi^!ku8kQl^}^rLXqk3k_xtG`0BrItTRC(d<w`hJ_h<C*pqGJ-3hGp!}Vk
zq-2{=J$P}5-q1Q#z3ohgXHW=Iy2`S5Xer-)Xf1x1ocF=r?(NkE1RKYu1Q6$TPA)mF
z&%A3D++lj~>fS^}wV@IH=%!5))@z5n+p9rer0kpXV+_uRsgoFd0b-!VJli()txv(Y
z?yXM6Jh`bYRB}M996yulPpkQhWPm*4d9KNL%R7w2CMim8KzTSJN-r~6Q=vqE%%f+c
zYrd6bXA@L-|E{tz8?!Q#=WawL>VAg9bcBh)2u+l?F`qE<iVAu{^`19gZ$u+$Q`nHB
zqWd2F60aCmEmv6z-r$gXQV3e<iClz*rW-YP*O^pi2ivH9H?gf!jl!!Oc=V9{L3%9E
zo5X54Qc>MFZ>sT%ql7gC8x?u*RHp{!q{md^tVmY!Fehg3sjI&@XJx%xd37Nm0Y%b_
z5Vw!4Yqi^^W2>&~^R_e&>A>KRjjp2Yd-P8MrNftHI_Y@P?^|Mo?>Q#Qs*L)Ha}D#8
zxao$(a+d%xrL@(SzQU|zTIl?90uMkK9jEonV~UnN>|8kHWVUs)VB%1>6z%{9L$J+%
zqo8(UCuw(BBL{%;@A1k%n9<WAqFCFV^84Swo7Z;YXpHaZ9D$N0$KW0GLK8|Ykzlhv
z?6a^D>{u&s@^&c4Su<vt$N$`Y1u~QO2%C}I*DBQ+mG{4OHMch~G&qJ}Q}bVNCl&+L
zVH%}!$C+e2k7D*-w&!itX9|kWK{fZ%J{RvCMPE|g`UEUZ!%}cLKv3PH@yk0rY1cs8
z?AX6=I&x%?^f~N%Z<#0P04;K{7i*J52-(TnoXQSSnh`*&*0KJmgzJBd*!hOa$zJyY
zEq1Ld>?|{_%x~XXb?jIi4Fyag=;w+3BQ^PKn6)pk3v7N|f)vXRaM(~KRcu)!RG2*3
zcdbUdrf}+;hRN7QS33RsFbpMUHHRY_?W_g2x~zK^Ow)$r1WT5tI=?2COJ8qd0bcFb
zV(t~?jW8kOh%aw1NZO3qW{cWNVmnpLs8EJ#4kV{+;qPN0T96#%vvLlkFvaWhj^jqy
z^2ha>kSQTBS#Psve>qI_f#%#~;%wU)^*|dN8qtmsh6T*x$S<eO73GkFyI0be>tz<o
zf8S0M5wR|tAH+Zc+spbv4?^@^D2JgQsvhC0ixl34CNu^(xk8mC>CVfoSna{~F{TH<
zl<QCPtM6|Hu9}5E%_RBj^nhO{zxx`+Og=w>YYDxX)LTbg1`mdWHC@>w3i{{n{LjT8
z{fOGrxZwxf5x~HVm_~jf0)OPUdH2-raY#CVmahALcx~Ethexw0HMC}CExX}znZ?_G
zyJCMV7;sat?cNlDeRhob)tRK>ExJmhw~5|{x>x<V(4AT0e)RR{e_tGzkWBBxej2Im
z*tOz=I?~2tP{ZuI@iz)8W%aXiZi|Vb_mVY{_ks!sXnn%b4`q)luD<!_@N5mTEo)c(
z(t*ZbL@4dBbiHGnAO9ojmv{g2ZV&Quw^EKASs@LLeO`P&$Ys2?+v#I9mtMVrLxqCp
zv>ubZjCXlC<N|d{&WsuAxs`e5o3B_IGjyT1phb0cI_x$kV?=&Kq|F3*yMu_@ekYL1
zEvj)3;Mlm?92)^#?-q6LWiXOygOu%d8*Mbo_I!eLNVT>nR`1l`eaUT}>A?Ku|J(d|
zQ~lby8{K@yyweYzB$Lt|C#nG<gi@9Hp;Y`V(6N38>t1vyc{pVZN04TfPwq9oW!~X#
z-rpy#8KB5Ag_M|@On%sS7$<iWfxxc-ssnqJKJqZ`b`);yM~@@}wS@;)kxe}fl4#>>
z>l2G(mThBN0wA5_N#z>PySps34}SIo$07g2R9-nC?zT%ff^F^Qhfb2c(%6-9`+e(!
zue_9qyhb50+UJC^7~M+22H|}`let0v^1wlGv-Ga-9j?848UNY!?am^vP9b3z!V(d`
zW-XhrOI`mR5xI|2R5)>=Z{|QLKo8wENc8z~r@?Bf_6Kzb(P#*0cw-kBN;+wbkgsU#
zY;qpEpPe=_aI24At*R7zewz3aL6vrnnNOZA7ZIKyB~HCkrg1#<MI~(LGVi5S5lVR}
zP98e|F*$M`mvJfNX3SI$Gf={rNpL`^4%PD??rFyG-^tGL-Yp@C`YFq7SzOoAeT)JI
zdFm%9`EtaiGS#8U=NdfGpft5>uaEZ)sGNoYL<ZKGIO23%M)yd9&5UlubGcf^se)!l
z-_08Lkk|}C3N)rQt5d4a_dCW4H@3?wjUAzcRC{R_s(wU=4Ulkh&4H!eB^$0;Lov&j
z3Dwt~dLbMTbU=nNX)c-AQS1_J4cq*<EVOrXWf<UYCT_9lzQ=l$@ysWnogrR@Ln6)E
zH{l@!Hn+$jXHkGEo|)-cIJ=(4Rp_qUZTt7ReEITn9P03*9iQxtJx;Kr+-z)dJh2pt
z9MRf{+!NON9UR;c=`wbWoJU@M0zjk16Cj7%!;pR{>6mFzx4X&k8bXnUEv%~MvOj7v
z8D=3ne(RZ_VUmTvYKXf<$_$}FEQsDf->%4EYFC>~hD#R1?;vs_!8Z{TKgYCdP5)6K
zIBG~fCvsr+QvSV{Uk8;18Q=V1zC4mh0-Bhq21<GUrhREJCsOOWeG&UDh71#eT|11Z
z<RJqqwLEDuB#bX1<_1TkdE<2n@UJg@irIZ;&2Z&;SryygSk@|r*}%?oy$lnT43Db(
z;QaR>ucf}fr{&injH<Sr7YL?=el&u8y?dRgEzOYNptLf|itpAx^o?}fi0Sn6=x`z4
z!~-lm!kB@PBb;$ZOtDTu-w|Cwr;;Znc~eBPR|=WY$Zh7n39qIY|5VF_VKt4<-v3jA
z;i1IL?9K*zM$*H^av$4h(?UtP0qqsP*=JWjE}y<Im()-H{G6Ny#D$3yH3i-2HsGwj
zrHdB@P++(Bx+Wy0q15JmIlwnWj@sD<etodKq6yL>H>Z}wcPxB6fHW=X6G@$|x$Y5`
zDiRBicms6q0<ZbcnA80Fm0UKlEt|X*|NH!6QYFRlmSS8j@Mfr2w*yXz-F{0T&ET~1
zX-yTNg;gh$(&_nP1GY*U_u(C7Z%Lg~aKY5+{AfV#v{4GJIs+$K4A7U`iUrK+#v+g;
zBS$B<*bJH3>I|Nfc2B(VHAa!|VZ6iz2ZxXiovz+S5{>|Ucv1LdOTPdS)U77d=<4%i
zFSYdTHN2j2Eh3<`F^bqNyZG_n7AQ{R_*o}GYz3xRE9T=jlW7%km2@M$k*+!h{269O
z&Fzt%N>@@;q+`jU6KF?IT5ARF;Vv$Gtn@MmO)RyS8+1?I+!SvVSw?R2O6W&yIki)?
zBIyMR4mO&q?N^ElF^KN%MW>)|i9;gY%GeCLw75xn0uVzf0F409)mFO(zFAM5h&qi~
zx#R4=We!d;@9JQfDL(futJ9qV7%D8eMQfqC6ci3Nm?xLl&PDam9ymwU7+P0{0W=jn
zKEWMoE=7mggX1IwJJp&BJAX@@?A8|l2dd^5b&&rbGWGvZy5xVQtbP7w0+O_xx+FW;
z_lcS=g6;>((ZC5_cBe+$kAz8kEa4h8<^H3<EKA~q^^uPmj_G3E;|`P$NsyxHA7xt8
zJ(DM7XG;@mT$UUspCuVi^b)3@($p7py@pcDzbI%fIaltImNCV}{_X2Lv=S@4>5$u6
zRB|LS_QllNERKlQILX}hKo3AUoxiEI(z@2@Ci^MaPZOuBLC^C!pA|CZYPJ2n3D<H+
z7mc`Ysrw$%stk{9tyD3Bdb)*5q^W(cQkCgTEk%UB(>7(yUNqIbXzLZJ2)BPZiyZtR
zoWpRbrdfBjM~-1ozAnQ&O8`UEP+b_jhp11p78~TEPDgDxW@YYju`|UHevUJ)Z49>*
z*uZ6Fm9P}40vRtnTGlyJkLeBARWA8!wD+Mn*I^Sz{n`sYPjnP=uv$xZYIW`%97kC`
zRg!RR`U>Y=8zr3lRJVD#jliT4v{X%)j=a94V^yUUGx>nA;6?JQ-Mn;~s_TC)*QG7u
zjQX>})mBeVcUZ(haF=@BMR<+jiLQ}S=XHWK%7qKE+Wr*^<nrHG0q#HWQ}xGB=eB;)
zsV^_=X(OP%(f6mEPArufSFvP9S(?2Q+b+q`uJ{b#xHt&3h2*$>4QyZL1MPfk8<qS<
z4w#f#M5*HXODwq}b7ET+2HoW6?oCCcIN5MI_S?MlH|H9g8JUv%v|RdKVXMUF`;@%W
z%Eu8GDEawmGh&Ibg{RoZ=%$`#LEQs@W4k*d8HJxkR8@nbKI!0OQ%EAUQczB)J+&11
z9M^rV?Ag^%K(Bs(rb@mk%L^_+-NT%U&W8j6I6xs%^UBvcufpxw-i3Vza$UeAHtsK7
z@MaQD1WB&?PuA2FV&p;*V`m{pn7x%*VIzx0tFzaGZm#M_PuG0Lsvm#Ao|q^5KPSfJ
z<Tav+9^k*0)!p*XBIjI>Z8yd`&s{pJ2@n<BF4Tp(5%^Sr<nf5mzBV2Ui1R#iHHG#c
z=W2SW=P!Z-hqb@x*2r}G-gE&B_!iu^a7M`+;4Odvew&2I^5S$ZBt>D_zc98r?Q0w{
zlA{=^M1Eioh!lmp70>j}o5RH$RD@B-7}`1<67sy5Da+NotRlbw&k}WIk9x$~q`x$Z
zOj<B2R35!Z3dLwmeR*Xg_r@qd$@~#jD;DG~kOK9Z7{s;k8$sV)A!}^U5GGm;IdRC?
zY93}Z*VuzpQ*)5C6cAzqi|~N=kH2xapTy?l^1^7N_g5czSIg4aK*{sTTF3yjBsRW-
zNOSx&Amu{APAiYLPyxUDKaN_n2T?-B15nA*K2VyK7)IRZ3Tw!?^ucp{DU8~I+WcGn
zr83~1#xcJ6=Wm9c1|xQzZE136DBiR;W+9IG)G%Oc_NavG!e_T$Ec<JBiDIW!J=)?O
zN_iHVa!S?2c$eKoUTaf}6YwmV0(q`!hh#fS)|N(v<oI4YAd_cabzUpebm_Snu~!Cg
z2V6n0BOf&b@<C(SIlD&2Was`9IbG$ndd*%l#!eozYz6SDm9`dSA%I9lBc^C=R)0?v
zY#s7)J`SUOAj2T`qj)4em!@oH!hmvoyxyttDuM?{xYpjon$sgjWk;ZA>HD7pI#cJb
znJj!S+LbyBhQo-8vt|W=y4qZ2fh>HSr|-T#%PZRGj1+JF`zw>5OeSZo@}?w`OloyC
zNqCMb6ehtVwpbZx-KtDRXNd?DLdOX@(!F*!d05cS9Q`ZrKt^&fjM%LB$Scb;-IuU1
zP{<{|udh%TSs`ye%t|I=uu`HgeV0lG&?NX77@7)zz{yi(ltZArZ+;CDCOcAcS0>G?
zu{V+><1&>$o#K;eVlq=M<F5M1AD&woa^JEci5sJvm|9ZnIKOb%XA(6xh)T8(GbxNj
zg?PZqfauRjMOsF7m%!jUVR?ErMP$vpm|o!8Kj`x*7w*&GZ=$PKcZ(-uY(T*!dL~4B
zRbNMPWb*~TthmzS%Y5MX04uwp5%FfgO)L!VGQ3_@e})}w^u?a#i=BK)`#i*z<`7I%
z-n;<D7n!;bfC)3NmWN7r-{`^2&y%6&tpg?tXbBwaIvV@R)r&!MkE^cRjk#_P=4M;<
z3iZ|J$yr<a8aMApr-F>gkEn~|cQeD1$NnQOGa!Jzoom_owrNkwOPb`q8vuXP@mf@C
zx#N2Kr0fNK#6_1Hl$_R7-39aAuz;!H%+KudE=|i<8>D7`q2rHJ38Xt)vi(Q!G@QU!
z2h)j}E7C%E$c&UYMN~k>Ou8EYJ^;F3CJEOZbTsL_-eJA;(MDg`r3apJ60cJSJvSb_
z02nrRAHeiqUMkxlUkce+T^m(seezsd{sn*rXE`HUfCnm7A3gj>_$yeJ1FkQ~&e+@y
zYsJkMCpYNPWA;y0HcexZc{{xA3SQgT1D#N<LfM2_+h8dGIpK(cRU8Xv@#O29zd28r
zZ;tKl3;FJIQNXq5!J%t~;aL@4p6^VdFo5*11ao`bKlAxs0BV*$<5De-Qp5mlMy65%
z@ocWC+=LC9U)qAbk;WfPitm5((|iDCG8owb`po!o+meETE7fPp?TZl8jhDHePu55(
zqb+vp`ukr;{~iV0F(pgvilk+Y00f)Bkq`l+>^%b<`#&b@zxem-SRkXoA1BVG*A}*<
zIdtYEK>Ydtb-ysY$i7t(GJ;5a_w+6ddMCWXokFg>Mf$>RINM<wkK)O{=ZVIc6K;Ca
zu$<_gmCQ<+p-=~5y7JZ}$?5S#7t%9J!cwrS7C>RRj!beow`@Y`?aR<<@Xe-c&ROXN
zVnT8jxe6Xu!(v9$hU7x5yPj^gjcvNpd|`gBKcZdM!zE$T$+i~&jZ6)6d(eBNNKV4}
zZ+fMlz^$Yc(!kf}*UqgEEZCxznJYq@-@bjUZH+VUEuNK|FYZ^u$*4*3DtgA5vq1sE
zwl3}aHL^nv_`{A#zE%qTU6TtTLnmJ>JM^9=(=Ih@S(aaR#qn$2e>OE5)3*X+=$Mzg
z$57rv%o})5ehFY^V*VwAcwUtu3m@FVL5<QS%wP4Uq!%UAr_vyUgR3MY!s%A~;OTTq
z15H|Y|G2aee#!A27>})gr3048I<b|auYPv?{f0+tjaM5OpN)79ZHb3uQsorUp#d#o
zmX+R@>;v=K`->`dwjN|&yoYL+-?4c)9$V-&c)A=ZuSsuk3D;(o8X=R*W(3H{YVvsN
z8%7Nr4e^1LTr4#v&wD0^>ntqSD&EW$t9$-R-umP;ydb8dx0cX~si7C#aYY9SmYB=x
zA*EatA>zo%2Zb^#_x!fsde{_qdd=h6BMv+7#Dsq@ml+y|7*Q`m+bi7%UJmJ%;BE+V
z`DQ`Z+K)(aI*2TR{4GaZ83MJMy_o0f`%ESD=ks>wGojr<!37Bd^EwVHQkEGVhMcM~
zIb-%SMbka&Ubmyv4!9||UvNuJovyXF4>4uZKlSqr{sHfN!wKiMX$VAU>uM*Z9Wv0%
zqH|42_oPE=Chr|(Ib;cL;pbjTeikT*u@y>in=XLeu|^Sc3`C49mt&t%d*T$}5(U_$
zm1=rBN9z0cyI6+d`kc3P!o8&a`o};URY}IV6Ht;PaqCLK)OCBhA|yoPE_XKKJ4?o)
z4a#(J$pWC=fz#gkWT^m3^9;!tmKIO*yfI&40ga*DXg<q+^q6>_gM43N^BxUS-J8B<
zPD+rqJZVOw+-r-L6b_i*jj^{d&Icl4R8;@yMhjm<Ee*A5@m-EHyRv=NY}vf*iqpmR
zxK_rBocCrn;oTYUc6ak8)+MDXr^<D{BLbTD`^9E<?mxjA05}iF9Z$2k;S)^9pZ&ac
ze~|rsdn=T*ewD9U6LHp$LvU*z?DBki4XdR~RW<)(K2LJEinbX*e#Tuac%RW3do`f`
z)o6*_`YYGiJX*b~@mqEGyfr!mQIGFsOZ5ZoFmw#W5AlmO6MaqHDa{&NH}$T8TzWe^
zo=?34xy56>9vMG4+R&w-&`hXM#vXPRti6I-?H|r&E(>kGX18OCazPSa_4R&pcIub?
zR@{07oas<*Lu|M`Rwwx<Ads?|>bcYG`1O+V(g-<UZNA-FXli5lar^wER@(N2(<k5K
zmnVNhJAOomtn}waT!U@qKFxRFQELZMU11Uw;ouuLh_ko#Hyu=Kp!DsO4@6q7kFVQ$
z;r(EjQs@mx)1fzc0*TXHdP&cok|FhLLipQrcg=)&8UD@0TCp^RqOqYfQM?+Y@5fE#
zZ{At3FvmHjwtE@SQK50opI2|-*^s&e{`9bMr<=?N7lK9mrh`%K!?`xopHH&73QimZ
zANJmfIV63wNE@TD(_}yL%-nF2233<I7mkqQxqGgooToo4P?lA0j{>jE-R%D5PxHK(
zTX(B+M(-`hNUO0$%fh2;>O=BC)jQ=OiV~E0RwmY8%UXfRw&izAjy`ZA<zlIfx@Ws&
z!qcz*t@4KpZ$q1Kf$K7Y5f@9ZHI5*G{=6ELjT6Q|UD$oT>AR-=B2e$pu*(c+w-Peq
z<utT*3+uMu|Cy8PW|YNHP5Ao5+xVWct1RWpmtw;57^G2l(28r_fSy-Xn7b=ANJ(=X
z+pWGh_X1+X&<Lm8dm7w()|L0{AF=35Bf@Hzo7j%#KDdmBT7*%wqk=D|4ZRPqhy}Q8
znX5vZA9G^*^`X;9yezz*@0PYvc4VKLoCfJlitn(4JUI;#A&_-N{jv5A2bV9&=V=Dv
z`dbcg-p(I)y`;PR`N+u+U!9CZ1q_QzMlqa+`CN+79SehH`VHbtqWgbFjz5Z)joo^~
zRF3B#K0m}kM#NlFUXrHr?OPT4;x7>WOoYMLIcOg?MtNst2|`n;_cpBfQ{Xk~6ggUP
zb}1j5!BM<dx`g&MJ((`Ol7Uy=zKem=ueuTP@+r9GS%Ep9=G%TMD+nE4M{pi_38Sm7
zql{-mI}Huc;pBb$w>0EoA5)OoAs${{k{R#}0CkEz><*ZLh*>lYS*t)=ZUtWWo?O-Z
zt5&W0)D>=os=C%^VEtXPqfF!+pTg9ucSaPZ@4YP)sn==_>2&Gdx!krrSSIt!J2L0~
zQ?>OI8R#)#1)F3VAMkR(Cfye3{35!%buVw$XvtYMMcnX0PMN@;@%PJaT+YGE>-4T#
zJS5N!Bxd=Hlw!_!BEPI1(U9tkJ;QosWuB+5i|PB%BULp$7~A^#6X2RlmAgBwLQMR%
z6@tmW#YL8<wbIiwTn;-<T*t>4S@+y6?3hC=g}L@q_f-46l(d?-kx07*U-C({9MML*
zB%c9D)fspsjrq>+xR$4nOvVOEpX>XcZA6*d07S?h&)n7Sn|BI&CQk+Sw-3UqMIgRG
zE6R$F{y;XqP9oSzg$%GFP85eIy$Zepvp)TMcZ~q&W1Bj6SR6oajF2sK_j^RuK4U&t
z_84H`J^1?oUS0WW#p!Q@04<^8AvsJHcl--yKp|J87!1;y5s*oqd3w)0!TsxG5+~d>
z2<|-g>9b8=AF5d|8Ywtq;W;HaHI<ad#X|Af7<-H=C+KkS#@UF-8aT~;l-BHGprO`a
zXt1M3T`6u?IB`SY3Q5lau#@M~utCXusv+j3M*xk%5!X}}WeC!I$R|jqy8bTzE_3?Q
zH*+N{;@;%I1^n~c3_B%P@_(oYYkp7<7AyZKv^0-C&$1;fd=IIPz2Fdq_^sn4Fdn2$
zN{7S>Oe_P5lW4E*Re+g(tw!Xle6^oz!vG;qYlUy#bZnnbzT}CQKtKNRJ5o;&ysLK@
zVN_9V9jrsdfv?e18A@eZl>xJgOBwSqo+Hw3>cXZ{S&8sLYaF~;N-3A71gLIKUohFS
zV|<e`cSQ6FX=-B!0!1GvGuBZ<LpDL)K(!?B)1x%aB#}tgC;j<h^gaAV{;MtZz6R+l
z3e!G#Nf2sg%Dj)>cb={iJo*V(+@35}q=6Lxe0k8boJkx`%5M0UyE*NKEeu*HuuZ{z
zPz5~i%NKrjNqoy6tjYd(&Kam{0fg#EQzzID?tFC3L`~)^v%(g5VNW51o%vHFGAFCd
zCUbnt$Hn_{Ol31sKU%D~sQs8l+G`rnAav>YWq=kZJeP=5Q0jC`lF$L#Q6``DEAU>V
zZ~5kfU>=nW<77(On!yZ^47hOj2Y4yYP;|ou({CV3PmaCn<+eJcIU2CD60^y`hMw5b
z`>RYk98@LKM7^WT@t$?#WtDf`Gmd5q@WFKCKWOh}j;n4eUC$=N`_<kZzDyteWK!7d
zjOnN7h3Dt}fl=_c)*qW|Dv>p5_e@{`XyjAt_mIhyBMxx^W&Hr}+7i83g7&a9Q`*&N
zedPwJtkE^E&mW&rU+z;;sD%)oDLW{70|<{#eG6Ao565M{NAZW_;A^6zm55MyuIkR4
zsK#AE$RC`lk|R!H$R#^W8OO83&FJsm?ZC(3*WN#~6M?c}AHFMWqMIGN_9!wjJPQc@
zv8hM>f+5SWi;t-7KBh_SgC$|6RK$=#U;X`u7b|B3onoo&3I*fkgmn&n%v7aumsc_f
zmH`G~9*C)wt8DGD6BYRPu?;FT4lJruvP+ln&(c20dLsYNCQwA~pvlblys$L3OI$6T
zm!A8DHI2?LElhU<y$LR4`x3$D7PF~)u!8yH7mmL^FxVLdS_muo(_o$sl+~^_bc&ck
zl{5}HCgz+11ZVHO<{IBT-WI}x_CMaXGL{!dU#Bik)rFZ@D^@&DFHY$Ud-X<5REiJ#
zrRjpW6rVIxlYJApVQnCJG<378;l)nZ&gzcB4i$R{{7`5=05GhXHM<`L7h{U{>=ukW
zqmq{Y1-w;pf6(Y6=>A30G(cqplpt*Lny>L+DYFn@Q<3oo1g<kd*HLbB@z*^z#_UYX
z#bSY+8H<GuFKQy7?Fz{2Mj1>;*H1F;{oCUvdU|>sV3I{}UZe?>a1&ZBVDVBb1_iY-
z@F?={PXw7|iUO+7fYkBfeDG>-iF-U-<Oa2JK2{JBeh0ufKHFoPvSjoR6ZSy=Ky$g~
zu(9ZCPc)j@3m)f+F<tnaa)K*{>%r#_jm2!naF}wVSe!<soqXRuIZ39>KgEM{3nw&*
z=GfM?eY1x1&%*&mpO(jINQ@;*4$vI}sI$gglEJT!-7RESGSb*{%2b+EUuo@gu_SV8
zZ}ohlXKkrNvn$Z+!|*{u1roIUmD&o7263VSJ$7I1@VdPMH;1|QnM$_|om_orDJuLg
z=0d4FhKb>r3H$P9K}?OW9QfEP!&l?%Dr$`PtKKb9KaW^cF4h}>z+eYRUVtLF5^2fQ
zfOa;T4VpTF0P7yo3rM66oQsBPfb?$@@aLzXJQ9MplZ+J|UCumv2ISBV+_&%4%b6*B
z<*J$EZmY(MF9C}1`~Jsnt{g%kqzFHS+ke|{|2oJVng6Q9YvrWXfATaB?n=M~O=#hu
zT>ulym5t#Y3kB70<v@FmN?}*RWI2~eXvJP8{g$~51yfg7-bcfddoKSx2><egU$C2K
z<Q#p#s{xQci!uXvv;Rp}(a*oHQUBoUXdxiGn)v9wi*MLJgoA%-s$B;DU^o4m_{gRF
zBy)qq-k<X4fAcI{eF!{4^T#88=fn6zV-J%<nB55`eb!T~OqUgYan6Lkd^UOg5#S+W
zO57`8!+bjZml#EV(%WR!Y7n<nV0U@H-S=HOhmq8|;@d^6r;~sA!&4unNjb9l|JbSe
zbc=1q)5X7ct7#XfMQ?}UzgY3Fkfh(XfOzB7_t(Gf@SpkTzxcoR)yqs2>aUQ^@Ok=`
z(t_dr;78Pjhj4wXOE&K!9l*c`Q^e04-CxuBf6IP;fngo_{w5>)YM-71HRdXCmL7Mt
z^e9_@6V(vcu+6~Udz`jbNXpt-I}CW$&;HjQtYEga0SX=iZYf<ED=K-rE8VMgI5b$g
z(e>e-UpM>z#WbPWzzw--EdKM83PeMO<W4D<&HdKIN#*_M@TdQ)Ln4l$ZIh)#$J`d*
zVG~=q8mxo~G?61)UOxaW5Q5HWGs(;UV|)M8qyRS|_iro=^S@zXE?@X1R%A*%Ik=A+
zfqsDv&YcYZXt|rA{%`5&N5AZYp1gfztO;fGTG1|Z`hxI3(WZO!Yy1Lvj-d_%|98Ch
zZ=-yeF4X-ey;j-Lpve8WywrT+hB7_>g8qRc?|#ce{^eN%V53QG@$?2QU8`uMG)fz*
z{^xA7qun<^j3|lwhjU$TWUYAoSwtms%P!t$H`(~|_<yhBH!U^nO0sD=C<TD=^16ax
zy~G3uK?_=@s=gn+D-E(+Ir#@}<I}CfXP`y>g*K~zWDhhIs_EWh2lYFO`Euj;&TA3w
z8wf>`09<98Dv{&*vs6TrPVUT1B&wXe8Gb&!2)WwUy^r68s6#@`$A?AMLJH;>u3=Op
zdtdP8qaQUS<1Lr5%8(!4bC@-0ghm=`Y}$Zm+yQvE@7>h3GM=srG+e3Beo8v?!{vQ_
ziz<w-8;Kk(@@(M5fC1?tc%c-UaouBx*6|(P@_X4`)u0S!7?S~L8sDnM7K`b7JwqwJ
zZ0l+p>eTHUf@({#*(5C0a-}T(rG)cHHKmM!&K(0X^^deUF(_Ktme06%tm;R2Pdm2R
zxI~`8buGu!OH(y8k`KsaYr$PJQ69my!J|cUw^RTRm-co#Wl(a0AuA=20Llc!fnK+M
zhw@>1{n`u|>$^PC^?61DGX`T5Fvn7JwYb*bS6!HCwpL<d<etfdaPSM|G=So|5zt7F
zXSH_rw?#Ze6LH{%7>#y0YaN52YW5r0)~B5{U-5^)(&#lKkS^dKrnv+=P1ACAJ6e?o
zPO@Nc13C9wy|H1ISYqoCVVwbJvCreVTmHq~S|9k-v;PTr$3rp3DcrmGxXF94>%)d#
zlc)W^;b#28I(=)kIjBV}Xmahvi|<i~)Ud5D{I`?=(gBDkoEKBsdIi6|G}uw>b57Ds
z(klUuOrCy_p&oK`r9xf{Dtht2zl3)8np*l-9DL3lElnFL4&!nJ=(&9@;kRqsqnpUG
z<UC^z7JWe9N>j)s)%rc~V1u=_xx1o!#U;(CV(E@96Cp}4&)4p>BK5?>Bft&(Kdrx~
zsYR?fw#j6W_agW6%1J;9WJWtChesTHoBA~PMb_jTA}?&8PZ_nES^X&H#ufLu93~tK
zS`tT?PqR`Q7{@f+R+zp_V*^`5t$nUa$|+gx`Sg47L+^%kmnGV<bTVh^F?!74E^N#y
z7Net`Xen0M(mrPG^X-n8g;`Be;c$C0Uocg+af-RGZ{Te7p@M2H0HU_vN3Bi_pk|~&
z%~vX=^hs8y-GZgAO;^%o0hG#&OY(I#s4Fij9~MH$Fc{Mecso+RSKv3W$~VUY=>FsK
z)-1_@V3|DYpQQ2mXW8ul9ai@oxHzC$Ql6u_Mi|hxDMY4Df_%oO9>`%)zI6cBs$aQ@
z1MGF)3&EoI?n<f8*g%MRA5<1ESzc=#OoXoZw_bd2e*NTcr$ijKg1%`aHkFp&y}Y+W
zBI-?7NFSX~l=sXoNua~vTf0;PrFYBmB{~sRms5UQmgnKuqTGkO&u#c&$-cGu7XU(Y
zZ@^tUO4YVJM*>U4(YFBl5m~o)7OCk)TG=-FJf=g^0KL@#600uI+gMv`!lMCs*XB-E
zNHyUS<z>q&+ibg5F5%u55;LF{knV1+ByOhAzr3bwF<s;E`GC1>iIACs)B6#n461~=
z!pVsh3b?Q4mC{nV(o5M_w|n6lnR4lfF%xxO-<XN&&Ri2ky_21pLP<HY1s{edesqY&
z<AGK@u~d2d6|ucg0C{!%=dI#kzar&}-YEdkWRiM=nlFI5H?zwdRr7nRTRpPnY98zS
zQ7V+!<r6-UawRDze9F?g6#$ir+RtOO+fC1c9Z6|Hh8{MGZJ6j)60W#dIqz82Xpp<6
zq?!CQU4krfpzVE6hgxLh!E;_;mrgtMDXN%x#F<ae18gkF+t*EI*_b^-$}C#4)6YOR
z2K@VQ?`-JLrr|(_{i#mC@EJGoMbh(XH%LeC1|%U(-SXxUrq>-m(Vl;KD5$B_bjUQA
zai&Zx%PHjeZW@z3eWLs-`$5@$|8kAuS9X=fabYI5IV@7j?Yyo^fMs0Iv^?zfCMdML
z>vKFSSgwouLM+@)-rByti?Q53qNH)si?J<Iv?iE0Ws&JU4Jh$m`k5&DEB8(n^`*v=
zbVx{asHS~8ka6q@ZZrncrmarqgt2s-=b%MucO1Zh)uRn^ygb!x1HF?fk(zq5URUm3
zO}km26ff0Bq0}qM{OQ+|V{Pj}vZ0WQ&1lPhNZ(9xD`R?04~tDuaU!(w$PK&RqQFRa
zoP;{-L1aX-fr^HcWZzMpVVsTyqWwi$U=Yl5xpGp7(?S8Y7|rX5D4*SJPF#S2vOSk1
zQdLXL5$)6sgCxC_G<Q;3Qk0|5OWMn!N`#JUD0cX?7GR~fV6e?R)f@!Tdr*OlJb?n*
zK0nVzfm6FvhUk~#<BCbkv$>^#Yqy~zf0~~p1i$-2S>e&(b6YjTSQ4)C2vd+NdX)|d
zf82NKJ3v&Y6+=G8HQ;P`PL?LE8I4%>Wy0^o81?TQIr!MpDF_w4!gy;gYdah1s5hgG
zuY)YLhji0VW)fhTQ};i@8Zf5x2FK4w$WijFRutv(jKeNhCqBRBmL(KeD+~?_Njjyl
z5jzg0dd6r~bXktym``_qsMYqN(KUQ-uo8;bW>179Y{5?v$e_aHf^5b042wH4(aMEj
zcSLmKN;pB07JRO{fpNjMPa+{<;s(OEDCD85W~BQdik{O&qu?q&1?&38^razAd|tX#
zHFL?#15j{Y3~F#)hgVz$e_b7W-+{|N2O2#xpZBd=nKI#0+2y8a)=`svCka+R>a2CP
zdVnum$fCDPa7&<@9(O+*U8yL4`}*R?@7dw6?CZKZR?@aEvd;TDt1vEDeoTyO`?N6-
z;{SePsm6(n0JvkK(NtL~v@sKT)_Cx1f2JBg(}SzOD)CfAoWO0*dB}#&SujRA8lY9(
z1Fkj2kQW06^wR<DLocT)L^Lp>71|8fw*HYq*9eJj^*g5RMx<LUqkU5><6pRu7^Dkc
zA_JtMgH66=WEw?x=-vEYw_#&WaDM?vQk^?&Vp&=GWLzu3VNEGHC*-blx{97Kji#m3
z^rv|a!akTe)x%)P!>au1vFNF0I0=M<!hMhL*S0#1Hdaa2af@p^1guUQ_||TVtW)-&
z_;hkdeA-hs*`Ry1?re{(sBFrYt85iYt<FAmksI~r=ShwG7Se|+&>7cDFReT?G<@%a
zgC}IL!h(ldk8-gRa(hIKavNKD%ZG0VDxs@s{?o7X|ICTKS1XZ`7B{ti*EZi%gn!+P
zzV-1Xq9HI3wiO+?Q$%xWsBCYo<L^7HR_>)i5qEo6(SNsIZ14<PV|<#4#5Wx5NS!G*
z1YHm^Vr<(GPS-%yEz2yF1|_;8j#JC2_q<nV{80_5s-_*4si6S2;3mSuV50FDafh;Q
z9MtLCm^7=3aZQZqE5R8M8%|D*^t|l4z~2Tp>irt$GANd6kF55%W$XX$F$_POHYCmK
zh*~4a3JuxbGJ<Ri!#$l2J;t?ct5Iet&9HQdtdh>wVl?GKtu5kXmXGlAWZXF&qXJ||
zjka~2Igy<ioip39U{g%X)=GzXYJ@49Qq^p6+B^VQV_FF)b{?v&^mIw$c2!rT6wIf8
z3YJoHaznJo-<le5waTTx>{l0(&;G;8e-557ykUYT4Jf@FTAG5JlVvoVFf-ndsO}pr
zDyALIT_3Uw`_!-<4I|J4t46A^Ijh$<*Wy#E!Tg266ou)n7aMYCCnogzorjNb-uE<|
zua>lA)SF;Ca9_Ii5hR-evkNO14h&EDtC$eq!|<6vT_d&Ml)y4P(H$~eWfR%tTC;s5
zs_@+Kgb8#ZxOQl>tK)>u3em<nrdUaR;3deZ-%Xum50j|O&)eunO~XFweaZkTgi^ZT
zwRJJ4^+4*>W|@Ne!4W%I8V59a%|3;XE_HZo1Q(LE_R1~vY`S2+7E*Y+N_{(F>3lUJ
zn<l$l<5t)<04<)q!02t)V#M_jCi-9B+zBS*jP;~edj|uvb+CB#n2DBnugCjNgzjAb
zd^KHLCqmi4n{zf+^s?E7av>W};#u%OdU<m^cd|71F)G0SjgZitjk*iJ=bhgCN|zpc
zSf%F?#l2Y=^u3+PmXKV$B%>C(TS|l1{W;}=jGafC$SP$O)`X;DUhQz6b}QqNl(wiG
zTJdTFWHlF76w~MrJf65!$^{Jpo+tKI#>AsD6G5K+lbxLWmZ2GMmn-uxN^}!9D}XC@
z&^0?XRNU=kKC?QqB;;dmaL>75E~$iw%N$er&sXh_Kap}TgXV5=W)kqi2isH&Wmk2)
zgMEpn+UB+GUYON4>q0{;bHNv0hju{(%I|LUwzH`&i#zmHujtgz(~5yJdHRHo?!k=J
ziCg2<X^CS?ltF*r(zg?7JKK!uh++n|K@mFGvc@g@b|Q9-u+gWeIZJ0xO+R8d*!9M5
zt-gy)xZpbsh<k8&I2(T2RNQ!dc)H`_hMFGc*)V-LQD?Zyw$dFx&rpC4$i+q{c_;%i
zxTpUaWS$S)tu?P-_&V%*iuL?}pl@|ZQ7uk~CN{;@f{R{lLwJ3qd*{*Rd=KpD3$b%D
z59x$xX9z7(ITnCAu4ZqEn>?YRzlNLS7wVWUfab>qx)P0z<<kVvE{!pB4976+$2YId
z0z>GyaIfy|C)>n#mUHjV-J7?}w&+ds%7;aTYn*akQw+qASI{K)1U9wEj}Z|k7Cc4`
z?2`Q@C>L(0i?H+eB+qy6dBWb|H*Y#f(xXxBOO!(-1H5jstGpyg;w8=ZCc6U*n3p9U
z=q^Xk96}rg*^bw+$<2LHNS&UKQhh|7nb&B@?B0GFqw^`F?W3-E8Bu9i9NJT6#v%T4
zB~p2%*m5TFQsmx=S8hd1AA1i8ggu8$^ebvq$W6;04*)5x8jNoXu1vVpWsVPbR<1$i
zsKv@tzIq+mC$GUa)bInZtB=i}k@IL-jWkj;7eP#HsKR;W=n40vQs9D@lK0V5k6+r+
z*pQ_wAq$<|^K5KCl|~jR&Sg}%0CD}VmGe)K!y3oj<U&4FtB?C^=?75TJ-U2IcPMBy
z#9w1TTym?~(|hfqU`1bYwi~wr2MS=AUtnz3Xl%9gj+jkdR&c<)eyv7&?`3((s%*m{
zLZa12{9eQ%*ZPv}*-zb^Z^;4=jtzTyJ*whW?d^-vsnAh4&F#v2Og1#3e@J++)IaqP
zmIu`_Uh9i+Sl~n8x?702^u3q3FOOzvIesqq>Xe6;2dQOWat?h`klyZJNH}+`iz^Td
z?nMP<J_t4QA#!Z_-+**iAKg+ZAwVj-;y<j6Gi-{J+SZkD*D|@LxuzE`1M}<?Zu2Zu
zz*(SNlwvCg`)2wc=R2Eze;5nn9!^|qwZT5C&C1wlQ8(567Q~b7w!J~aPLrGX+y|>9
z;OY~bN4UQ%IRjH2lDS>4-8v7?s*m2TC+)zqmQwb2?tG|kUs0ox<ti_H=bp&=KUn+n
zK&Jor|8+<u)JG)=l_H6Wkh@Z;T)FR~kjRzW7$S5iH@PdhHjKHCS@`6dBgb6B$UPym
z4V!Jhx60?+=kxvk`TN`3-mmxb^}LVA^U1O&2z2n@gNHwmVP_0H`Z=xm(*9Nn7w(F&
zBSiR*i1ia9;L9cYV?&qV`X&-bB{757t?JTX`;z6I9qYFG3(K&NPBoqh3BLb0)_IeF
zA5J<F<_k~x_@m^b;kx%dY$si?Rx78d+DfL-N=zz8GwJTCv2RYsaE^b6*yo-y(`sl6
zzn-MH&wNF7<)A%3tE@&|!t=l?V@$|&XzE2$sL3ORHC`R-@A!vBnx>;?sEJgCj;(S@
zhYuso8{V{lw_eSGo)qn68ynSUAAr4oPx}m&DkeYb57{;2Mupgxnu1^e;>W06?1_gL
zK!w*i!EWoQHjnm0vep$+$M&VHU9A?=v3}6aCbnKZ(fXACwjD!)GkHnNRs98Yf4r<k
zR6<?3!CzfV&3>3oWfCr#fBqf4`f0L8Z%ZlA`7|(3=N*y-EFy51nde_lpU5wl^lOuy
z`s(z;<BmY87~z!cnq9kZcd`du)!DzS=oQtDa5b!%s4tnA{sez$oh~mdj~DKW{zC8&
z*|com^!pYTDi>uF;9|E~N5P|cXl-^bVLtv%E#Vu7+BP@2w!V9;7X~gl!G$x|{irhI
zpJ{dX%5OOjri8uRc$e3mmBZ7+G{^X6s?mDs-^==Lta#Ag!$}K0q30`$qVV>Q@a6Cd
z=NE%qO7q~wP{CcGsssNDAwrT?vt+V=MQ-#wS~F@kVzK7DRO~a0TMxZF;YC0x-|=pT
zp~}tD=QpG^0dE7`(vLQhDf)W-M*5YajT}GJtpvaoyE6+Dh;}&~ePlMQQQ>^u)+k1T
zGpWaUaB9Ta{CsJm=efn%tr(>T;g?2-&cF=|V$X{$A)mrWWbs33hjzu%I)-K6Ji{SG
zbBo@rXDV3c35Z{P5MqK*=2%6NRXuW=&xG40#+ds2{g!p;Lf_yg%DN#`0mb!pT7IB`
zKL0(lpryI2<-ncrk?<<IgAy(tXJ2u?TiPSQEF~+r*{WVUJ<DP03>9%qWx9ASY$+je
z&HRV00;gtlsq)D3h0~<atUDE-&sSbJM_e~y{FK|8$q$fpZ$-2S{E;}&Zb1{OLk*9M
z9(yDDZGmF${3gUx$*RcXapNTu<oOi-5doeRIqA*}GqVmqMCBQ;jNCS3iW}w4pqA0t
zZj)nRqd}9aW=mXisCfF?Ia8~PP91c=l*P4?AZ9ov&aSJ+S1yrHL3+^sg^TMzcjknB
zX00pviI16*UtKrdxh`hi&#vj9!(9a-?+#}`us4Sta@iN5$`2e#ryG5tREQM1A-u82
zPhzW^9YCbg`ZJ*|$*-^B2C=Ilsp?8*Xk=&>>erwYY^X2i61q4iV%Wec!dS*+p#tIM
zEdHXRUz-xr&V;)0a??4<(PNwjmMMVpOZ>fM5=DM|vPULzV&m;Q)4><rZKsy>aY`dg
zh<;8g(G|o0jMq<Kd|ocjc?<#>SUcAu7hkLNVcncDH&9$D-R%L*o0;_wa3A0upoy1d
z65~9~Zj;6ZL}iJ}-6e>Y320IBdQ&ciXFuq3>%YeTPgs$vo|#pYwQc3d#lFkwuoPR|
zhF?y*5MK<+&bt1Ws0?N+pn04nSV!iJ1Uo4B&oTwel(rZBP_n#F0?_Dp?~!z8^xg3#
zB(Ocy9u603=f!f_n#}xdEeCq<`L9<3soSYr{@9y-u8n&)vxv2X1CkML$3PSR%E<!{
zHHSJFRHk0Tl3^cnBM5sy_q6{cIsgME!5^PsgbB6Ua=%?gT_YUO<<8>-{bz_6Kpga4
z4Fl5)PgTvhN;P7cxsctQK#^&0sD9>l_3S5T&-RJh>{Xb@<a`#5fQNz#iVh60g5ux)
z>uZ5t_PWj9x%zWPz-GB4ManvzO$DI$@&D`FG&cu@+wp-EHsW{ZV?2|DXBQzwyZ?ha
zzWsSwKn}h&i8(koZIqC}GwH}Zc@Y%<X(#3WYw$)ySN5_w>xtZ-Xq}&ZvzxH(-2sM{
zoX_DtMwfwx=Kpg=XA#goY;MV&!Fs~}_x~9hT8hP~teN=L!Y+y#LlKY=Cjf{$IQFld
z*#lA6L?v#o=n=4*yqWDIVEy4NQGD1(OY;fhU^i=|)X!X+bzLp_NdodmX=c(o4Bpp>
z#pe&Qi5@W8^<Mv<%>5(p#S9o7>En0dTKa`!35+Y&0YG{Q_}c7iL9C|qO)#*0eS{Z_
zl`Ood$O*Cz*g=c9Q+k?E2!W}?LT47*PbOk0%c|}qb70PPF=;IqVrP$uxAn8Z1<DPT
zn`56Oq@%d?(=qPfu0?2wB4VkDE^;5|YJCkU<=u&r_SMHq73}c&7#(`k7!uiVz>h4!
z!rImDS6;6U<({5@#&42(r;{!6_|JUg{fqShm_b{!)8<fve71g8P$YOKF!^(zqksEI
zR9nJpVLL0IBqw}{`diY%nY~)=l$5+tQXqEMyfr#aZdA~p!#rBlaZ~;|-+b+9)>?mC
zeDyBrZWccY4mHf|daIvBu1}KbqonUj+3g7aIQB=$UPyWs|04OFVpWzN(1nte#SL!F
z*vyyNmGvvp9Ulu0oPi^0>Q-(0je;ySs}6#u{@G{u#QUftK+UILlOZp#z<hGol%y9J
zlQG=$gsZ?3by{H#$Dg~pQONCY>*A-VUDqYJMD;qA2J8nlt?d9-Reo&m_LR;a)QK7a
z%I|%Us@*mXKhyg0DcwP<$Njz!ARax3GmVw53+)ADuQ_5z6pV^n9OEuwQK|{)Ei|bR
z?5kmCqILIOxjtEINEXLN0|BW0Bo_#9N`J-0q^T$wJIkISe8%qTgG>JfuB^03Flrmw
zQ^P*^EdvR(sD(#3JaGD1qY2g}C3i#b79~Q(1kF+A(r1hXK=-$HY-sP_4Rh5l4u|5^
zI4h9AI{A(<Xv6cgIe&j!8j+=U2&q!qLMRTw=J^n^r^bX@HA~Ic0dNGNds6@xZ<lPU
zVTsa1h*`}yiwAcu9#;QD)+(B55omV13Q_=hSgZ_sU$rC4z8`;ho<3oi1LW>kddtQO
zh0dX3ti7In*Pk)ssI(g;SQ+vYlI3qLD`baGSTvkI@w+DVUOxe7I|-PP%1p9%g}3fE
z5-5Tl=-LCiV7bFo^+exO{lMf`PoIdoz3g3^k9UukFUN**lS6ZQLk$3I<}ZZ?x=Luh
zgvCt&S`?*uvepwk6ex$xGJ#>R?!1YZ@QhOThm{;|slN(NYZkEYG9qw?#Pqp-;#;44
zUhaIK=YKW%XMcZkOj?&Lo0()~U<lmhdY{KJP;<hLeu*XyBR7A{_;%>4;Z24sZJz1B
zg8*AiBH>APRyc7v2!Qpx99BcQMy)}Ze@_6W*HboE6vi{hi|T<*>|9d?4@o}<0D^Um
z0Nqlaxmi$WVUTd7$R+PApjcLS)`_3aeW{!J0#Yzw?|(;s=BR^H9xpwYlr(r3W$Fs7
zBJQYwYef`(aGz-YHBB%o4gg!k=4WoE)fri&A1|oSy#znE{d@lkAAy3&wP{yOy*QgP
zZ8Or1>;qUD4nTPxMeQ)@c1Q4bjZlPI+uIBd5CJMLmIgTnVRO4cNB`mEorf0cNePmE
zKVDmP0YYY?be*u9ybJW@Up?*HZ_EJ)EV#~m77I!}Qp8XJUU}m^z%oB}SZ2qN?5BO7
zL!X^<p*sRbDGDpyKm`Ri{wsqGoa=Ng7`m+PUjF?FU>|^mVI2qmv-cXXZo%K%(aJhM
zx%3w^aq9N~H~8xAf2?5esAm;*hDny&G_bP+-nkBRMclu#BRM<syN8yxxdGVm(7yQ0
zjl6s@oCOs8@LvhX?PICf&0r-rr7{yL;V=MFYaJ%sx~~yHFY(>s-=76!;7Ov-;^0NQ
zNqZIWih)sX7#yvK;5PgVFmq@A)vp0ODWOQE^&`8XXMj5x&nrrFFqrfMfn;|80Ct9n
zgC}Y2_(V)achF@)Ko>h~-+IW=KUY)$zh!M(zmb4wUj{?Z3!2mY$a{aP>{0Xop6>SY
znpNE`{#r5|Ag_v{cJzT~z%8WiAXokDTL7-~^PA0%f6TdMQOe;0PEeKHe<?Rw1>Wl9
zo)$nGW*jNvhi9Asp4uS&_u8wTZo{%vZgtMh4C5|JHe&Y}NH+i<npyN;p3Iv1KjhM7
zXBXtI9j?sEEvPef{B5%Z&ByNF0<^!Z-hVH@hm0j&Or`?6JN&U&hX#UwJMtcIV^t<Q
zpK;IvScoN@@<}Hj7~$Px^Y>3BZ%v{*4-eWk*sEj$%v=Ns={N(>J9S5DKVL4TArBq0
z#7us266fqzI0aP5+CI)c%IAo$ZlCqR@F3U$u!T@BJzzmG%x4>8<4|kn&x+aSp|AK_
znZQYPhXxo0_S?#T-*FGF!saS56u$HlRiXYm&pKT4fVjt##x;(J18!hSYsWQ{cK2bN
zPiMcGsor@z=~6ofd&H@+u~T`ARA%Km_^W}%I%<7vHL^#l>+0OXykEC}M&(ppmTP8Q
zZnZpjOY>><Z)a`Kket}=p5D9vdDyl6dt;+*C1kViJ8A6q!k)0YpeADdIsB-^{pW%&
z_;jPb3VqPhNH_M<zS?DzHZ^hXi)M(2LklzAqeyx^<H=HWWkvDl8#K&`%p*&v*_0<m
zI7<_iZfRhj&TU}%;!pNj%kPei>&)EpG_9gKuHF<O$FqV)uhyTI?gH@EStM(o?y_@f
zAdtl~t&a)*!X%t%u36H{OlWasIsyOV^M%XqW3D1-qWK3){?m#}K<k+fCD`5E5AL+2
zaIr<3f+?kWx7UocO_sGGeQ~>n*EUXyl*~NwpDwY`ZVP3PvtuMG4|_OW+ozQotyD{$
zE@4mJ{Z&5-Tl0Wj<*@7e+2Oh;xdj>;iOIYfvGf+|%*G@NS?*UeYI#+AKnVaFnfIE<
zoq4V9%m;H?6eP~qTaT>9so80-oJ^i96LhBY9&ba6Dd;UqF)YjZDD9;XMic9_4jFp=
z>dKPO(Yq#V9K%rK!7;EJ2W&w}mGez->MwZyiDuf6u(DvpN|ltDIrM{XY^5T|dU`XY
z|EgJ{^|96q>cyt8ob*5)Exu6^PM7(ZPAFZ{jq=>7kUb|V6(_3J#nHM<(Ir=#$_N<R
zt+QNzqG$|t$9#M|_V#HZ)cs!hq(1(nh{ui2SK*J6O&mi<t9)z8bGzgMb;Z_(cKLa#
zA-?xKTUrQ|D;k(=txpG9d3VVbC6&UJ(sHj?2rMSi9Y-FO2Xa#QC6}&_^HzB28Wl5W
z{4q2~?zZ-p&=QBJ@1=`U7KY>nFU50F6jE!An7<}nts>0XaVTGzvz0L}hIDB<K3u;T
zeadL@YS$&+tgv4U(Ycx*6?6{(R1+05r^6pwK4JmMhJx?BDYXL{CL<+*#r6I)yNPK%
z<W(N;uDGR^QETKK0%?koOS3iTK0`*c+8Q8bAG@gTiWFUmZP8EPW6%0<lAt&Yt5+Gv
zrO9Z2<}QE{Va^q-OI1aCa>kV``kExUYz?fwDh%Lr&YF~KYZ^IAWY$t(n`7L5(y8O+
zJriYC{7=LW=0+?QRJ0(cw<4ym+oxKSe)R)X$u;AZOk8O5&cwn4EDn=|saqsK4e)ky
ze`+2^?uB2wog9KaJ=EXuDKK)ZcXIA?317aod)+cQAA`C;^Vi*#v)!IkZ;{cjbc1sx
zdNYjc)2DLqybi1h+bf2&5~H;Z=s)I};WYH|k+ah%_PbFLq2yFvX6?0wk_=KsDEj?)
zzAy|M6yzzWSlo<iA9yatdueJ|3_H8l;e4HQK(C8(fUw`6EJTu@@4k*0V&yhaXxeLC
z_RGDg@&nA?0%wr<J~lQW7U||H+Wnb*hD~?M$t1+!bXG?L?0^QR%K1eZ(#`VPspncr
ztek`&Zr8jOlvK+<gkYa$Oi1w*Weh|Ot+z?qKMu}2vfq$=pA}LS9H%x@BDN%{q9evx
zqh#n+6>#-kQH0b`R%J_Dy1UhoP-&n&wr+K)^n*G<h{dj1(=j?hfohB9KYl%;Aj0R6
z$0d`|$G^M}*+C1IxKBR>1>)2*+{n+)ZrfbmFMksE08%$1I>P79t?#s_Q^2IIddFdq
zznwoKaBtvBaro}MA@}~hac%q`KE$$9j|7%~hbqNfHp&_gDn3cNYT)dh_#j6()WG0&
zAwJ&*`Y3YPtB_sydxh|L7FHM6BKww5b*teWT)QGiyNR{sr{15K<&~{B&Vf$b5Dj&7
z&KW~<eLog#n_Aw+|2bADb|PDM5Apk3@B9mCr&+Ssrt345<&dI>_&cYl-ur{C=Rx!n
zXuhc{^F4ldWCjh@!&c7gKZ?|q?ryL&F|@cibubsxF<?225Xe>WJ}Z4GSk@fi8*;Rw
zvE{i+ZbJ-`FQP+IufZ|DpdXyui?g=MRIJHXOO)2oR_e+;)qbs9<->q>Wl+y?KcaDF
zfo>mLjdy#T5{1P)F8ia!dh=3}8n5nB18euMFA9CyViBgxEYWUN`0^#jjjTrSfSv)I
z!N@CC(I@RO00<n99fx5jCck2@Yp<-*o$@$VTmLnbq!#)}5I*?Oslao?Sze=~mU7=X
z4&1N3MOjo^A_vd{T${kLJW36zq&PBs)5}f4W^1pA!+1WS5B!O6FT7l2Ma5W?gXOR|
zZKIwKskL6m9*TX6HM8w*3mnGNUN{BSX;V&dSQbmWNn)jZMn~23llA!^idZEDQ_U0R
zqttlCCoRs>`=*D-4ZCY5LZ^Su+x}?iVd4u`rz&rS7%aW{_ApszI+GRT1`W9Gm?j3~
zD(b*-+2?e`?BXO*ciJz;K6OB;zy4HJXL|486uvfuD*D&@ZGm#Mh-5heP@I7}Z&k)m
zvOj0@x9uJ_4u&6%hf$J}s1cxdo-3?nF0H>+7VDx^CLee`=vy2h|BLrnwkdaFhjJ%!
z2ou@nEg7*1?D8b+Z1Uu8t#o!gbtRp%^5oC(Ihb=?Sj8jPiPmr5+lXB`svWPZ?Fah&
zV@K70{&B1;&MQhFR#2GMc^H)2&s45;%`JeFBe`Fj{Tk``JpbdR_PDq<{;54+5pS&C
zOr96v1fAgDIRmKfXAT2&J1Qz*OV1rLY5^Sd<;R!fL{RYP&U-);Ge0RPQ8P;E!A*zN
zHUmDX|7&4?%pQ>Y)NiE#3jWn<_<3HEvE1fPQ&TyEPq`m`yhz#dN}B?Zjd;9cxk0|a
z!jVX2pJN)aAEN?q{8BQS+v;)g+yDB#D=q;g@d3Yt%CxEm`2t91g=2n86bSSaWegPD
zv)HwIOLD16AkOF2YrzJB!abX9Mm-eq+d}LDS^m-+SvWqQW9@ZO(6fLU(OJEjFATgk
z?SFkMb%Dt_=#9%g3%FV}l3A@PoS@U~f4(#}>12v+{R)lq4wmSJbb&@8wM-qi>;Okv
znVkF-xfz$K#b#tBmT@6F10d#wKPirx9~8G2M+pxWIUw3UlueWvby=14@fqP`8rFno
zCimrj{}$)I>L@|~HYumY_YBsA2w%$u=gxHSw$(t_w0xJzZd6`(m|#;`LtM-Xyh0fq
zno(g@?W;Rby_W5#*0u80>yXXZF3{(9Zn#`!(I`A)xXg{b@=Cb<Ccr?~Ui~IX40rP}
zjRdM4w3qSK=aWBe@tWn=mO5n$bnd43C>thky*g<c$#s%LnVVBO-EEan>n<ICkjE;?
zrtN*Hh1PI1<=c_`SN&3I92SRiEKon5uc0W#X|<=ia@jK?JK<Gl=Cip!b;@=gFob&t
z=oJkS2ghU7LlKyX39|+tN5*j<<u64>6YO%827^**UaY`Ij4v(9t2}<xw+evC;eI9T
z2k_VK-&}Lc(s+nbAnUukxyBEJo>mfe2SBfG*JgOQ0*w#t2|gjkKYG`$&%cX5$jzFm
z4z(%|aJ}eRw-rkoT8TsH0%vwX^rr~A_XIGD%r`!+p&m6^V8c%zf~snXMJ2o>i=#Yq
z6riS(#+oeUMy#1hUNPRJ);^kl)|$m;PC$cJ)QRz$JpelDlwRgWSsK5O5g<)QU+RF!
zQgZdTb4d&VyX_`ETh3lm_;t8S;pq@RPbRzETJ_vaEXP4IKIVR(fcQy1@bk5+4;&<~
zy`cnZ0=OcliQVA6sB7SKzpKMj<lbb;on+hnF#k6MCW?}nMl*LxVK<CJ8Q^23h9U8m
z_Qj4H1AIUlm}hDw<5DG*B(pj2JfzIcOBUdE-yJsgYv8`RYqQZuYq}9t9O-BkAh%yc
z6O5H}caqqD1f1zVB$9OA+_Tvp6;LF+3AH*Ap94WZf|;p@)z&0ACa^0^?Q)V-gj#0Q
zpBQl6)8kt#Z)<%LITNeO@)(RMAy;(#7~DPrpS(Gp6rmy>8Wskqjk(t+0L+4KzxC;>
zx(T+_;DE{B#6a}F%T1z&j(=#oFZI`*M{L}==l1l8&Na0xO7jkls8OG2wOen<jqnaE
zv^lB{*_zOH=STBq3@FA0+)XrbxnxXl-0Uyj=U`J_6Wid}|Ak)B;Z>jj!1U=YUwn5i
zOkne!Iq^B1^XPUAZ~hO<{0P&$R{tZNs~T`>vJ$0c7iMf-J1ZNn^+W6E5QuY5^HppV
zNq7&gY}G8C+ti}M+1Elm;)BEVd83jaWdwDZI;dJ#W{{wyn2F3FKitSNF?VpiwdTGV
z(V0ow#+T8v9o=}COo@qVGrM&w#+sb|?IluDy=uhxstMs3{tD>C>;Ib=@I;10WXA*{
z4E136(&R(;v>xLX-7ob=7e}&_rp-@Ws{znqFn|}zV-7W;It?2a!&HZDyY(?z9?iy@
zZ<`2Gwjh7#A_tJ=&QMss7(WsfXg)3?{`NUsMK@C_EVp)9JQjWF5=CoIa7pWLmDS2t
zUwojIyWZn0_i~t>r=vFN983kP*H`>ts@!NM+Ap<U#k|0j8EL*BjrLw(ad_R2xK!DY
zWw)q)H@r3}BdX#7ijQMLsoMAIA)7v6GnNpxV!lj2%7ib4;fG{}W#n4a7Y88<`hu+N
zi{+=cW##e$MS<<pPkW0!ZJvHX>QygL(|r(g;Gw8uAISO=@qgsTX*V%!C2iYi@+1tP
z&n0<Xm_MK(d{mjsACBg-B*+pYI_#HT!J25Zbba3^<^e)7C}EyJp(eeSzRAP8<S$82
zeWC(qx;U&LEiXo-m;21LXAj!_ASz7$*oA2Ct1*|n83?Yn9Qe{yld)*w1Eft1p|hn^
zGYstjNg#x>c)F)w_lp+Jd;RY_e8AuS5F(lX5u)2|EhI4iYW-+iJ(fxM5{GPM=jJm)
z)Sc(<{+{6F(BO2>-3i<JuJA**9h=WFg>VAaXlCdkSx&Y1B+p-``D<LDmizif7)9oW
zi`Xp8)dolNuc~C~PdT#4-0Db20-@{6z3>sASHdaR43dV8uZnEanU^jmzU<oi&!J|%
zB@1jBlF;}%@>?HyH__iLUilH0LgN1<o9?JOAWP*`Q}vPf`!j(O0|!vYrpvVhh~C?}
zRS+;}fFr>5F{8Rxf(R7`m+X#a{gY3_y>BrVl;Ys9AapFk9|OwD{B<|mLHQ6V28h8j
zYCX))UBhO8Gu}~R;YqK3UmgoC>HdS$9PZ2&wYg5?r{AnFb&FoM&a9XdllI(}!^_36
z{c>$e7UKkHpX%HOH}1ShxvPXS+!gusPq`hoh;;>qn^)+%88`-dx;zt(MlfD09uZj+
z+#E1NC%&E=k494&i0QF)hGyW}IAW&Um3fCBY1c(J9}ir#@SFX+8~Cp+_||MC^WsW9
z9ZWRxAB9*ZsnFZetuvVseL+OFP3lYi7qqW0GutsLTM1kGgG^jd+!K{SOjTMMgY@MI
zk+QgQXFWpzgK=dVj?+KzS4_kz(kq!~nIwwqbV`b_34lB*iH~`$QZ0m+pRAzE61BBZ
zBdR%LXm-N=KD;kImq^l^B;^L4vtl+N^!n<VHk*3(mXZ9w<ZwHQYBRV|D~wqZpg#|I
za^sn-h8LN;_sOx(L$kmAplKGXp?Iv`%BwB|JiUP_nVBhLQ^+v1RG3U;3qQEg>Cc1-
z(GA6!6Ws2bbIhD}dTJeXwex+)7b|!-^WtFt_rXA-y5CX+S_Wkm`dKD#?gL_<(nAD&
znwv;m4-$8smk*>p*&L9XB(1>Z$7yfO8I#>ul2t42k#7jT6*Ebi3(QMou35F&t<ll#
z+Fq?S^w_#BE`vF&RhtTm0VX0ju92s0ubwKvm#_CDJugt3tlG70$Rplu{%Aw5Epx_#
zFxo)RptfTxX~s;YXKAajZn8gUDZ;3u?u13aPgi4m9Hv=ZDZ|lz@|;|TD#AcX@!G8z
zG(YGB+n<by^!r9b0~^A=NZ5W4oVA+HCGhf=?Q6Vj>~+V{|EZ9FB|~w)gk~`;bU<JG
zYefB;=-L=>5L^W<0=6;`2x53_zIKCL?5FFvXYA+lWx%)kj6%DGj18E9YjHt$$wFj_
znb>D8#gX_rdUyUzpjjnmfVV;v>C&Dd8)BJ1DRCePolY>}EekDqtS0yeC)+sm*!tBy
zj;*_|c(-2aGI^G1PPgm1>52kL9N+kzl>zLrjNS3@teW*X?LaYCUi1NoD}$1fb}x}F
z1nUdd<dT57TVXRbiyi&_!ZQxu7|E<J@-N@FE0@ERY{N+0T#xgKTiaSNVwhO^i~1I*
zY;dy~2GK+}A*OlM@GY!Q;2BqQtm>iXrC&m@m0<Z9!Dma|)5w&Jd{%<hu*9H)NAV$P
zrcp0uDs<+TK?W!;;e9l!*33IffLg-TVA$)#EX)w#ydW2^Kjn~TSZxh4a$nk0dOw#Q
zxTO8Bf)S9ESuquAp*`f$e`wDSuuc%%zr|9Q%#xqSe{W(2O)pWTFFjdMGK_ncZxQZj
zc7g*<ZwiV*1kR`t$(5t-sx0sZl178$R|Rq<@pfG&o@wvbMInC4`|T?HJlUv$#9d{|
z%kI|aoKRyx-K5DX^0m*g3HvSX3pPvt$A1lYpeK|&-ix{sbRK_aao0)GxA;n?T!35x
z*cf$*yDxnAi+ylTD9vd0GS&J*umEe*fpd$V?Mev;Ed?<@*jWy98a9<!I46^~5A~on
zkmzDsdq|JzI#bRVT8DLx6F07HcD*$JHRcqlG}X+FiBJKyM^jr{+#ydB7FXC_*Lm&!
zT-f!8>T6rf58`O*%k;}-{Q!qH=v{3lU^6lKTq?1-2?)kD^n?g~#vlp3W+O#kK-BTp
z*|s0Jk$D;1th*M#e5JVBf8OugyaKVXGEh)O`hnw6mO=TPb|u`wik|di#-MsH9CD~%
zwqG74(hXH%^cDcQ7X4ZhrkFuYmYo6D6ZNV$;+_!2_^zsurK$^rnOjN3H-Y7mN=Y*a
z24xQBTrysL;@BTTSA<)+6wRarLG?$JSMOHq8_%=rLTg?L`7iDXHcS44&T-wU4^D43
z%P~C_G(KyinTga>``|G_%!{r;%$9u1)SUWxG~S$^9YDuurQ^UD+3|s>0R`qbt-Nk4
zLAJlF|30Weg|C-k9w@I5tUWz=dTV_gG0lr$J~D2AxeN{lZSeLWR_`(VS5g9$0{WRB
z5R4mv1R2eUVwEkE0q)0>p?|Ok1xk>bnidqG7H`MK9XP<PfGzfqkxW@6D1S<vMW#CO
zzT{OBaMLy+*i-&bmB~3<GcN_&tiG>m;5<w+l&Q1D0;SA8F!K&T!TwYlLcPLU1i~}e
zCo`(}KRSBz!PZ#Z3|D5Ig);2}C#KJ5bb(#pf*iK}!iqm%hzb%sRj^z3#Xkn~S|E??
zgO35zQ<<?y6~+s|-ub%b!RU4mN_+xARR({08mJ)ZQ(915CS#%{!{H2H0fS;hWXE5b
z5L*4^zyfm7s_ipsaDh1pxZH09XwMHpnys*^`}B`)&aniW#r$zwT+!hFxnv^FURlAC
z(G5tF%qT^~51x17uOgRP|BpWWpsHhk9^oHn2dIyIUSZTSD@Q3jMRBcGl~5{2^^&SU
z;&y6X(wLrk>x*QM-f@u2tv_|eKfX3l>v|uG#WS^o?o_?1^EPTYx4E6M=29j-@LTSB
zDrCMieclk%y#IGhd=|XXD0JFtV@K2ue{Fy<)T$0@#5|pPJ<}wB(tHHu)ZFKn&${w}
zs<3|&{Ld2yvm26C8Vydn(b8FnfSb~;zz%Ye{?`GO=Y8jE$A9|3fbHEoYHh$21XiY7
zJN*;HH8xW0Q6IP@20G0c=T~;zmEEg5Pk!I2B@i2{Lh^;ov8eTcNiK=w3-=8KX#a4`
z-hf|U060t&|H)@O)7be_;f}|&lf&3O9D=o?Q!9ZIBWQFdjyeeX@w3O{bTm-nV-{J`
z<$yR3R4MUiJ^`?w`wtx}AOyLhp<!;vTCKnJC%dntz0t)}%dU8CC0w##l8<CB_IoYb
z&D(8`fI!1LH2j^~xpq1U_(0kuC;rML48d_)U?IA+!XdZJDd4WDKSRsVh2igjBl0-}
zZG7}p+~O3xF}U+<3wD1M?>@ot-_!gZinZGMhWde+m@#--FCQGBXIXyZI6_HORK`kT
zat@|eFKmI^m%X^gyfB8d640s9vZ%BSw@kDI@X}mD5ze5)bN`{+E?Hyj2Lh9VrVDQ_
z>RCx=1~FCW%xRm<sy+pQXar-$WF14)3=&=9M4e5K3c&M*bEI-;tEgOv64?5n$domj
z&K%zeGpAwEJXBYDdPWY$(}kX40=&)THR26uVkaB{eg0Wx2?n^yIS<yNL+50!a(4Jo
zSA*!4uF9tcSUwQ&$t@%`m=BCYeULf)zD{zZNNxoQ?Dz2;?s7&X%gk4N^*HwV{%_Ca
z*ZrMnZ|WUnhNKPSr;-!Z64%>5Fp{Q+xRroFC=%dyUKnA8Va42J#-le=T~ki0F*Oke
zr%&jW`_Tt)%jl0$QUX4#1hr}-7|m&})mwdbWW}1w0vGi)DmRbEv1^9EnVe-iwU*dJ
z7@F{RUo!1TsGR<mj6xPQt8~A4s=E)1M5L{dHE6*~>yTm#ar8N*`h~D1cY<#5(!R_!
zO@VMee7vZj4ksw`A!JlvRv$~kGZ`v-QHE$H{rYAUpzJ;sZQfnm&$tr~d%`676XSvy
z<#L1JYuepebJ$6kOPot8q7(FfN2C1Yt=pnNzYNr(i>w09jZB(u%=T#vCZ`g^QjZsn
z?`|Lfp;`z+c!3Henv#`wF9`#SQCd8;4ftS$ASR8;V3HGe5yO^`z^qP6>)OBwElh<9
zMkqk>?%7kd89|6TN_Wm%12ZdW=d8ht!5TXxx0P_|Md`*=8NF(u<=RZ^Un0b?`j2Ec
zO0f%^T5pszO|~{*%_~{KQP57i>*3s)F|eUBUK<kND`XB{UsG_OfsOEUQ*ty{<kl0-
zYpIFm^*4ZCwv`t9m5VYcL#9g5j}~G+j;+ovI6z0vHO@~E4L-+L(ap^AYhq@u_$x);
zK`=9mnkc4NXHq#IXy;geCsbf;TK3sae1Cnng$B|6fZxy+d18FdD=y8i`Mm+Op+=>)
za72MlxvPY1amqv?+hw6AI*@P4?Hb)z0^ER<+~Wih<MjJi)iUZgip*;%;c2EB)Ii3-
z+|0KbpJ@WtXPP*nP9#y~8m`dk6TI$$L9p-7XS!QA8wO`a8FmeGDg1ua(M9(eAeBdM
z=XL)ORNGN$r_|txrP@!APMAILv(S#>B2rpQ*btaxuuNMM9nn4`S}%F8!Y*)?g{RI<
zcVJjDv|IhPg6ljR03eH-e|NyxDnT{IvQE2|g{w*#Jcr10mh<gRKJEk_+p_^PWh7t_
z?fHe8F$-J=y=Yd6*HM}Vw0&5r<r@|_Po*4?!6`i{&ygz8&l}GXw@^s^A?i-}BHQFk
zqB0lcJuQGWiY{4*CD4u*J^k@#@_nC{Kr|~aEc>jE*c#5KozYUOYv<@c(>lzBL=B|7
zelKYtd~QpZ#7m(bVtOQe1DUuGU}PQ8qge*C)&>Uzo>iW)G8jrFwoj<L!<a19ZkrZT
zk)JPf)h)B{Y1WVGx+ujob9X^8Mhg?OG3fK$U5emb&uE?lx;71t5!3=gEwDg?F*h^%
z<+Phd!ix0uS*+;FJ9%)1|6Oqc#oXVhyi)0s)ZdbtwDIWIHIXSRNDh<E03B~$rLF3T
z7-qv<n)RAG819`9gh#c&28jas2H2RT5g2vJzMmrR8gA@{8{{w32Gc%{<ji?~hN;Ze
zbOPC2V{9Fzz|)zRv@g3U8$XYBUt`&9Q8)TcEJH>c9s?`H$K_yi>zr9ZJ1Y6e6WjG+
z?wQuNei;rQ>h>GXwGG&S+w*ONr#FTJ{XBI7AmvU<TOUuU_&&Z_!O}pO2g)V4;ROwj
z(<P)IESgDH(J~4sq5Z1hOt$f9<{Y=@{5q19yx<X114bWxo?z9#Yr59`Y0$;^D@xZ9
zsEgXE-96UW{$mS#@@mwxc$Nm3gFmvP$$c3~UG8PO-re^h(V<1lz-!Adv`{eJgp=!C
zIBp_#X;>aeBkN~2c|{huy8Bmy>j)f;Ml_2mD46UM(Wi%>`ALDHejrn=_C4DGqR~H)
zfsT8!LYIkDLoo4R1HPJ~w-L<iBNYKHIB(F7l|I}fuALF6vya0iMiM^+V~=VDR)e(W
zm+o=51qx%EzS@WP5mx+bKRw(+0WAQQeig27jz+8<?WeTbuxhui#tGXpi};XLbr($V
zRm59Jmli$boEsV#MpNUUv<=KIv@IN4QkZEId#zt>I6UHWC2wj~TGA#UCSH0adJIx;
z6ER&<WXi+cm1Sp^Q@BQH^g}MMsv?6TsJLWV3GE7jzFli4*U-7%<!S^p>Vf^?DwnTk
z)?OoP$CABUY?G@W*jH)Qpd5LR)%1}eaI)W4up&HnMQ;(2c!b^1i%+|aVbefWsxHK$
zRoqm!RsTg`E^1#CcjpxS`ukjeBSOoF7?;L~Wy*tSze#n%iUg?6Q)oV&CsL1UX*&+D
zQ3Dk4^wxkr{d(~T*WOPhEd(G#3)|wL%k4MRQ!?Hobd|kn>`W35B~Pg@CPl@fOf1H-
z%A1cC>J?xbQPAeR8ELLjqz$W2lyc461d{B86)%XBp;CW{LfJK7clU$T?L45v-_1q_
zq%0bSf2;Y$UU&_MMN*MoWzXOrw<P6Zw()}2rb>M5uS%LRShe;V6l|~|TKISV*riQb
zC^4aRe%%Gp7<lRtI<e}D7u@a;@FTrX34|aD4z<|x<<2U2eGgWwuz8)rc=261Khd8O
zT)>vwJ^J)Uc^3ZpyY6K|!cvrg0mhJ=zp_t@KS9`s)NT_&mW*njy=gpm7<0vo-_UvR
z!R!JTQZ1r@K+7w7Ket@rr~9Cy#nNQPDS`&U5`iN8tGi~l=!=!L7%kCQc?<OTK9plR
z1Y#FuDQv%4Ik+sb#Cx^EsAAnoXVLTYmQyHJpRcx(lqc`q&gcU~uD;0D_)RL%suF3K
z9E#mI0l(hrgH?=W1oS8IbIg@Yy;)8GN<H#xBN-oE+rl>L=xWn!TJ-COc__EvL_`RA
zmbuP$|5XsaC^apqdFSNwG#5Udl9~Qfm!B=ncyOw#qdD&Cp&SKK4+Ix&7Iix$vEC+5
zn3lwq1BRup9zeK%Tny*i#T#qMN&lFi$PR9sU~V{^h_Ym=SVR=54-VJO`nlqEef}NF
zUP~#K&Ew$rn(!e;J2}5gOIhYUc#ReQ;ObSCVTDrtfh9dW-{{%%6{8#0dC%-CZGF$g
zAGoFGm3o*&(ixT?q+E5DP`X2QCpdj|7_n*U{E*~8(9hH+7q<1XU3u5i&r|=&u{*ri
zdSv6hk?VacCuk!whTAe>-{g}Y7COWdrY$X@^*-nUAJ7M(<l_Ze3U8^B`)&W6aZKca
z4UIdF^*H|L>D*B_tvIsvv48WIqp8TWL6mG<REKCq?%bU28js`n`})U+7oHe>#r3@%
zCa@XS&O|C4{d^zOA!4k#;&<|p-;bI@1UriWp-t#l)qw$S7X(mHTe6Fg`a1c<9Xd+6
z6@neD*fvuB%Zu_d4^?*!S(B@u1s$B~S!Cuee)TGM-Ygm&^y~ja<3z`B82j6y7j6-r
zLwG{5szmGjHH)D|j|o!n!h@41B$TvRsk-2%i+RpTohWL_hMTFPu_k4@KSYhhN*y>i
z7qt(r3YMB@p~YY7Isv=*Qf+$JHvPc~$VSY2?jjQ-99(9<Nt{h@1ts6^ON+T!0xRc;
z435a&MKUfP;eXzrtA(S8IzmZ4J!e?mvbI%1``&j(R<ht1l1gW~1Ee;0XTy`M+?&Da
zXO(7q$Ub((Xd_d{**h45@bpla>~t)zOE}oKcTLTbsJ|9z-XAq-#mG5DHILJHJf9eW
zCWRcbEV*ub#kg>U3EK;XkH8bN@sZ3B^WHVij6+Q$#YT(S+|%7anM6KYyIh;|R&;<|
z|4(|ek9g(dO}M3|pINHm{AG?(ZYyz7dNrL95q5!-r%brRv2D@bn``cOq4kb~ldmV`
zVJjil(k;&0RgN?mwfoHw2LAm%C^Lv?_COIrXL<q(pCX2r{+EY!==>q^b<Z%=ZK-{5
zf4c;_(_WNZ)C%s*cAtvaL5S->SQE#og+&8=XWXmV^q86mfdY<l4Xbqi60cMCyZf?`
z(nm-yG~ZO8EK>`TSxa8pP7qCaT16eT^_4R|XDsbS!els?P(;^zY{)s=?nJ@?L(Mzy
z0B35^oly<6wG;+ao~p_7x09bS7}hgOO_Q8t`{Zf8@RkpzzvL^zb86psg8E!$j8~5N
z6=SUG5ygO6vc%^@<|tC^T5P_Au~*Jwi5@GhQVrts$l{TB1A)k`vEdNfb*<`c47Z+0
zj<UkOf&npYtFH}@9XA2!@&kjiU%fXBxGF{}*fZorxced5iAfll?OJN*-@PVCLd=R^
zXzwHvjBqsdxGiqJrE?;NgNerntVJL<o|Wc^)4yFDyKVJ{*x!tae7!z>$lsMi#h4vm
zAP}?~C+SjGBzmf)pPk3Xi&Mpz&oNnUAKXDno4YMbm|RupkF7WnEo`>5-aw39I?$p$
z=3JT3<21|OIM|QRryOg$s1)$bIWAun+*BxdA*sUkr=hx>onuimxPHehQFg&z3Y`Uv
zow{iI*Nq|Wj?`g@Q6(vDKN95{J1D01ka0+Es#k}Mg<mG_6c86f2ubVP-$WRtq!f$>
zTu&K<Y9=C>uj<zNtip91mYF0)$awZ*cU!y4rhoDv5{G*P`nuzR-z<n36OL-P0ni}=
zKbl^2#M#vbZpP8x1)Z>6#!G5n{HqU`q?ltj6u$H2_?Te1mAC6xaKpveZ-D7Xu19~z
z=QQ=7HdbQz!eOeKsW`5>`vfQpTvbe}#Tr}C{j8M@KD)?mm_KtUZIq|3SkxAh%0K#7
zy)kUN(=JncCBf?@&=|4dZ}${ono+8CT}gPl#}GxIZ9|U#umeD5!@Sb;y*k7ao=&M}
z7kmJgviaVrsCgjcauwKg7b8;#fTDpW472>7SJ2xq<Hep=Ym`+Uhwm}2U#MFsuVJiN
zC5WnQ-a3)YLDx>guFd-;xl+wc7!!WUSG{s7|A@=nG#!)FI4Kb}>ET-Z(Mz5A+#(BZ
zYu62g-tmV=@q}P;EAPZH{3=KCSNcnoO^o1H;R(Qgh^x>W{7-^zQtG;`rD>8LY=*D>
zIr29jF2)T#fGpp()X2WcKQ(yIY^JBF;a%P?l;wI3B=4<jbZ6UA?ufT<?xk_}(}rrb
ziryWCHrL*MC&VPTafePm0t&My9DtQ}#9H@-QSa_6K;o(7!^1~3TF}dc6f0ns*FS~8
ztu0o=^mDL;n%9%Zn8J}-QcMLO25WEK?DJ%`?%IcIEXkIrUYsGQc;}jJ@835C8hO4&
zW#vYudLs1W_dS@2_C#QAmd9^|G&C;g>R6^w<{7j^=VaMu!^$QDqDf2k?L(FgRSUn`
zVce81E)LYMxM4}AV^mJ$!?jAgg>dxc>kC_yETV7_B_v=IffmKnTA1h2b(ANn%tCZu
zpC^xnVRs+3+ExAG0DW9$ckq9ER6yp4SIK;{np^c>uNYb2EaTorfKvd>I%RAW1^j*M
ziOJVM4T4di3Bl+TM;@B&14$9j!c-J6d6NyxZvf4N!#HJ-+rOe~ASW2St{PP>AN0iv
zqS|Mk?B=zo^6tSd(mOcSPG4TpqKqoqI|Lp18njr+Ty%hFU~6WDKjnQ&xqs|h*ABIQ
zCzwE=?|j|$gdCz0lY<q`wi`1-?Q)cX7=x5%VSyj8?LgaN`P_=_a43F1B<CW#bIm#-
z@NR!$(npcKFi`k^Q&~Vqzw(X`{yU=roHd&BzwZPJlY4dom7QKB5NLD93)#tx{eS+s
z;4>NpYe7IediKBaV7GH6MG#g(Y^l10#YY&WICVukwSo8=U<qsC^&H=vF^w-TZ<mj&
zpVJ|vTAq0s=2+W5c<1RznYn&zK?SfEY$0{uA)_#Tai?hF%X$adOt}c|ZlV^(CGm=K
zG|f-vo$*<Wk!$So+vYPtU?ig`zANs0IxK_L^!#LMAX}bs!AOt=ZVSTh)sb+|Z|tvp
z5+l$uw|AdO5k)7=b>xEHyT{Q~!oiiYBT_eTQ(eIPn_3hqk!U|RGo@+vaHeKD4kzB;
zG8YuwFq^hU%zTR$s@%+xbHP(`w#Mt%-2F$&(uqAokZ~D%9rv1H4y&u;KDU7#-J|>e
zojVfQ&yY6+*2KUyoq4lq&))PR-|HSktwl!m{8cbsYF%iG*X+$1kadPU%=gT57{qIZ
zV0j<@9g<|`#LOeRn4k=26C*N3%~Za6%+KzH&j653LMA1}x(8p~`}EmN=sa%ao?o1N
zQtI5DryS%+Ls=zbKEgXuSWMU$uiafQ6VLkfDQG$#01Ot_Y3YY7IO(*+`%t}JxlSFS
zqG;bMDrbD&)`>B(``!kvR&3Fx(9uDaD<J_8h;h;Ps;$Wwt5yN0(RdlAW}JGl{3?d1
z21`e0jWE>;R}UK(hEjo@$ML4!K|Wjd#E5i@M*taEyD;{GYao!z-aokzGk<jSxj5oA
zrAkEWQo=D#r`Q}qZ|l0CL)l)qe4cU1M|Js{q<el&rhZcplb({>H3G(oGGelO;j%aD
z_rag~9Vy^&6|kdO^vprFDwhpC*8B^aM<Z>P6Au`=M)UF%H1GN1kG>S-InPb3wUQV0
zsm2FIyB{!Au!_SgdFn7WE@LU^`J~6VP-`-$!qS}l=BJD63bc9`NIuYT`ML97Eq6TW
zTMe)r)i14`7Hv-XR)Od;uW@iEn?2^!SvvHk2HZkK)9YnFfDdH*U@D-xMI-ZU+@nh|
zvlZpN0~PlO_VL30ud-QA$H6~6dYS|aDlEGqd-vnHEz4wik7WIXq`R9T21s*ls{(?L
zfF`*@Gud3wi+Y*yG9hO<OzNBJsrWl~rKU{kCi1<4x0K}-vlRaM*c2Yk-s9EzVlNB&
z8b^$~Em8cM4-`_9?t0{!x#o}R;Vz0fn&Ms==I6KeV?<S}&zAFd0=xWf8M{1u)8XhC
zd$6?dFJ0^v?PZ-s#X+an;trAJg;fvhuN2+)f;nii^?Tpb@<`0h&3Aq`3ZATxqTO;{
zcZge3?5fA&pie_JN^we!!<LVj9WnXdc=qyc%;-|_m3Kw!4jxIKip956QWNi5G`ciR
zx=1M<YQE>7LxX;CXS#7h-tD&tLegR5?Y*)6-cDvBrS0j=jp(OlEVM^31=QtoI=Loi
zK=4$?!yFGS6UbQV$!zmMcz5Z{lTWo~OW<-oSbL+ST;=tp*DTVy#`@wf!zNb=Wg=c$
zg$XklGdsgu)E}p>7sF=nW^h)!L_ID}+1#S6WI5qP^@?G04$H-;HLUl3bhoe8Au{fW
zR^}&)s@tW#Xjd1Wb)QE1QeU{KOAZ8B0HlG2-feL8v~ecLGWg5IW(`M{a&rb3mhvg7
zuIUkqv!tg9@(jt0%1PvF(UYG<sx@KyxRicobCJq}Xk!zX?$V8lP7-h0WSaNeCYf?(
zUt(@DS%Z(e0TQ-YsH_&)l!li_)wg+IT~zEduVAwSL)rS**&3na#tP~=osXl#ybK!Z
z5?y&CaDp)(#?29;JbS(jye0~~MT-R~ss(ZIXEEoYlVuC6(}LP{VrZXvd!j!r@HEqT
zEHityb}*fivh|cU*W~bex^z*zo%!?{G-yI|Gb@7Q1-mlYW<$Ucf6hmYUbFQfWlqLp
zw7)H#uqFV#J4mkBYT$BhU$J91#7$2Ht+H*>!QbN#tXo9mRTwz|Wh3eQ00waJu6!>b
zfgGIL@;iq8X+0$6fd*yaj>pnAM^di!C@xo9Cg$-DeQP_A?_>!c!^|b84tyICUs!&8
zZ#+6hZ86n8_3($&B^vU;%95NqjaQi2J8?CW&KW$Tq+7cW>oJ8KOs=Zuz^J0fVe++D
zWD}_C`2kL+_?b5z(-}k)$;w+|L179Av~vUd0=*Y`qZ95DE_!cj^8Qe*LwL<~%l9si
zn!FbszDOD6+jS&8)N8qzf6%o!w|}9cP=8ThJg)x@+A=qBngW;Hwe(5|+ZFp<1MU+0
zh&;US4rILRZMIN<s(#NoG0uV{7MUL&wxUMHs9vWP|AV0|_Z3nc8)aA@7_1X$cGtbK
zNA-r!si##WLszdQ^&1KG*S|YY7L~c%^37y+w$3`d$Rqh&dq1(=9#aq|V|^c|=3IO1
zO{s0~w0m;JH3UsJIVU$ky6s@O1)<;jf;c=jCG3sv@&UupC9Jpy)?IV#HTDgfKkD)v
zRM{%WVDHkB;iCM9yc_LL%(6AbY6F{{?&jHG#O-}?1vhif&8pkv$_sJBAdm8<gq=$5
z-s)h(D-wn7o^$-9C13`Zy{CrL&DY6%LYkW{$+R=8rsY)J%P|nwS;C!T<7#mKrX&*j
zxwlXBvSNn)!jf!t@7|AN>5l%erTZ>#m&|eZ1!trZVKp*$=Li5M-?NmU+h22pxK0b%
zx<rhKlM`V4UZ)1dV`^@0jlOiwJm__3e(6IO=JdH!HDZ*y)_}kkiq6NzQ;WkDM$<lD
zbPC?0s57aboL9G|>$|+Q4sGHd<iM8(^P`-->J7kpb4`$P?NImOKw7w^%Pgd`0@-rA
z0<RpgDW>iccXEw4;gZp(kw;M?czI604!e=0k~IK?GvKAkN)1t0<Whbtgp9-Wj7BR)
z#5Fp<4~lcV*e{c3kw2@R-kls23Z3(Oc`k+QN^~MC=!vg)JdTFogUTc@p3FTdmIyag
z>DIt4N<{67#^VCq*!j|qpu;J`>izOpx-KL&zC4gGIoBRLeL3AJ!j;z^ZqymK=yl%a
z{nZjH#uLdGo~msUp94NxxgZ#I0gy4jO;=u@eQWXg?rNm6QsRP~!c1Id?FHsc_uEv5
zOz6Dx=9r*Lbkr57r817>wTXa@28|!zi@eS|p2!TCcHV4qZkZ{SH+Du{V6IkC>z+mh
zQ0l=LHS~|1tq7+ENAlnd`c#mf^25gdbm9k9bTpF~tzcMC%E5)3?xJ<2$h<pksQG_M
zDoevhpvo5|7%rPK+gxY!QX|zo$7RCn{?|O0@y24EF$ozQ@7KnA$#56PP`4ZnSR$Nv
zB+Q^evArMSrFv@oYwfNV`Di^>EAP$gwWfp+%X`$>a_0|H`v}vUj++gVr4?dzXEa$d
zpB~d4JQBV;r-1!F=F_8FRs1eL4)4p=#6swe@*Um>!w+8gx+}w8Ddg*!G@qOrIZj;4
z<B<z|Z%X*pRTJ4N7Kw@83-g8;&G2OT{l=nX?@KqoJRg6=%er>6IYxSscQh^4c?i`@
zYSz#iyhu7xDw=(7teDj~S&YpnLU!qqX;Mewh1dJ`9LZQZc5+!cYVV_*C71o~C|t*w
z%0h>v+3Y7s_yTk2YtK6Zb~a7Wq|#ud{$+*_#3BMf!S7yG3y&Dy2mQ`E=lDYon`7-?
zaq0eCk?^I;-iq$x3N^=Cdj&L<b^%9ubxQbh&n7aHs{wBksL(<3&i90LrCKs__yFd0
zHvz0ks8?~2J$;F7PP)U@a|1OF78Av~rpV*T^;lX5qh%LfK6M3o%0u<Lx=+wMbUM>_
zX1Vf3ne$;qlf!A<8Tg|fqr;P?-&)j*Q3@$@t?`#y+>1L7H8>{X<$Z!aRpN$a9x1d0
zDoCEnb?8H46{cOS?#*87Vb>c&%eJYl({C`QtkM#?6K}O#My+`Oy8Tqmgx}NtT~d?<
z0VgMQXs!TGg^?1VOLrc5@82S1^%g56!0ZK2uh$m~8w9@i0CHhAcE?7M7rT9wkGiTC
zb3nEX7FARRz&_!)C?HaH`PYa8;Lx%An$PCQ9;)xa!v|TTbcM>*6BaIWDQh7XFZc+g
zauSxmd(Y{Z&L;CaJIIcf@H(xBOP_r4IG-0&;H+M2^0tpW#9g}gfup*!$&hMW*IZ&x
zkiwbJM~O!QlIr=FH3PrScHL1(2z%gK^yyT4f;5bh4f&is`?|byF9$@aw@IWnZKC#I
zzIg!J6V^QjAN<5GCB5bvS)rOQt0bo0nT2zHltJ!kX%)o0C>Oah3SH(0GY(HfDw17m
zfvK;{{J!TZ5p;#VidU`?^L}#{gF_XU(`-5eC>8d;&UXs^%QVAY3Q0wV6(IyES1V`6
zl;vEb`jMsS_<Cr(v;VEPaqs2>>Y*!_eDd%d-K2hGXbl|=ZL%t=)q?PyT})Z^89w&>
zwR~j1_R)Ed_YYTZbHTLxrtX0E`@2yG{PJvEUO;(<1#(&l7xP8LVnW)kM`7nTPY}y&
z9O)@;C^GROS|mmWQsKIA%HaywPM`KkP{#ZgQX?RF*<F%3P)%#HQX4uBtj~LMDeqET
z$j5_yHdyY!ldH~Yh2uX~J|IL*cHiQ%WoRh(e^RM!fJrh7wkDsQPTK+yp-u<Y_51DW
z=eo{`y`Y5VGdyie;H+2AT<M;UGN8B3oX6N7Gz{g3xjc5vwtRTZEaF56FrDl7uP8H1
z&yDLOyL9|Z!lOceJz}_jY#^z3?M1#F|9K<Xke4h^`a3_OKCq3?E}@<pj`A*(sG-H)
zx1e8(Haa0+_lV9<CX_p8@RIU|V^T>IF&jepuL{(@3SOvsSr`+x+H$E$Lhb`YX0czf
zWdS=qKK=igI}fj>(l^fIC}5$eC`wmRkd9R8A}Z2*?*joT0Stx`nu>r85RlND^bk5E
zw19y0ra))`0@4GahZ5ReW`53ZW@pdYbN1}nvwr~P-uvA5KJWW{zn`z~9EllWzIMOH
zf68#}S;ZXHsZ;$K-LeV9k!#u9E6jNwr_USgWWJ{oee-g$J<fPewk}!a-4%E@JeVzS
z`p%urY8tOp<=+y@4`INHa1D|b2WkmYl3a5S`i8{u*13I|Pxi7HpEb3|B*T6ZtHLER
z2gi@iw1w~8e3vagSNn7ub-@R%)q~@#Saz951Dg<>W#sg2E@}M5`ET0wY$=P<nKbOa
zz1uj+gV}5X?O;RUl6HNkV85^b^XLIDDmf#KRoLc;&vZS|O-j#&49Bh?-pjJ|x5P+D
zNH~4WVLNBwcJYz@F>Mb_^IA-2d9`PMwDhG_OaiKF3$KTFORiBkfM$;BrlBly&NbRj
z6Iz<l&j(>1m_obrS88TZ+yQf2yImJm;owLuS6{uO>2;2_)=qs3`n>8S%M6}|gTMiT
z-_Q%i0IhB>+_$a<r_4}ilr{DvHB0$TlE1KBL!kF^=ad8Rkgp5;>mgS^RM>E4=Nz#8
zF5Z55T(3La1`*Gmw4>&~5&Qr|psLWhyd9~x`6Y+c_oKjdt?@ahxTvdRVt~H*F4C8$
z8<7fr{j!Y~ofjB35KA55#rRnq!O|`+B3bLxCs_o(kl*;VRDIm8D55(t{iGhwijMod
z7(|AedO3`EvQS2(P)(B-*Tl|>Hll`G&AK@=cGN6Pv^|{)>fWIxzc$peb#F!q#qr!t
z79dsha5g;IhBOR^k)Lnt&aWF=XyRRp3~)F79(iuKFofeiH7$P#zcZ!QtdD!~^->6^
z`Dz(f{``DD24~th$vsv?zSnP!i*5VNq?Y-F`W~q4b|kBG+M{d%^QFaC24A+5N9FmL
zK~9x|%~w4#&8h9BmN!413LA0zp&VS~mPonpsZx<co%oZ=^NH+9VYvW1vdnXE=b_#=
zqJ+4<o6$ff5FLuMv!V;u`mj*5LW{Vy^h}BOB?R~R6A<xM!f}BY{xp&MHpw+L39alj
zV$!=>?rD#=T))wKRUx|+P^%q!maA!aPb^FuMSw?)nf!WydfS4C4ml5wyKbfj#9G*U
zQ;HXjOK{a1rjAeD_gj)3xHmr%%hZc=&yBm<O{*K9`&oq{2&!rek3X+KlsMbibTc5R
zzsIpc!~VXKX<SN1%G70Gz_l77FHgEKz7?omyp%kP7A#fhL#5V$2izja7FbNZv%YV(
zrl3ZOmE%v`eP>LSrIAaTx1ziSMrB1`9ycJwLGJ6F@#2h_t4W{X+OwOFoz=vhCQp=Y
z1P)(&9E>qP)+TC+7R+pJ{D4vq;1%2UfXzCKEKK3K-kOx3M<A?N`i{44z0(j8CUr+<
zmJ^{-KTT`cR4pe5S~cA{UBNEl&Zb$6u=1X(eMv(h{N-N-i{OYXm+oc(TIpxV<<IfN
zhKx@wPaO3mTerK96RH~2FIe$rB0ylo5!Siec8(k(!v1oYEMv5!EHTs(6`z;rp@-g+
z&&??lAU}h&pt8n4wR|SDHf8j8dxu0$_$bns*%=F$JRx-3X0dc<Y$k)%GG&?8VpR7U
z*CJt$706~eqbW4OQJW!Ptk7lEx@25ro_S=z`p1A%s@Iv-2js?GCNGY;coovk>k!S@
zePr<~7qG4tPZUI0L+(T)j8qekG{LrIntaUB`zYa(M{w>X8kB#t9dy(3$CUuLC1(<~
zGy@-KWn-awAb4s~dtcV$K}I<4s$z2cr>$yKd?A`|*s6*u)b-gs)jQQ}@YUr+;DuNG
z-Em`Ayw$S+F=SB)3U|m!c~@qa?qjZiJq@V@Kc$3gCca1575cxB9+M0c?TgS`-EQ~s
z&4ec(9)zPs_qX347gqjk{ah&1FLiIrEi{F_$6@qKIKC}$RP=b87BkjGN&wHgoD`wn
z>vT<B+nN>yzB(xTMw}Y{r2hJRN;9Ve9L*~qF_UmathA>m!uHnQJ`=CbZ1uQ@30P(x
zeRJQf*fQH!Ggb|>IhvLv)gqy)h8d?XJYONVEJBh<&46D*dZF;uZAVXW0X?XDU`tN5
z1bAEHoS<X>5*ilcAukP-qZuaK&voc3!(DbQIqBmX<p8eZ*>^>qIjhiCEvQm^Z>RF{
zPlt`wf%!nMM=?gn`&KAo<RtAe6f)m3G_%uGEp`~i*B=BW$IjLVH&Ms=(3^kO(xfNs
zQ0BYt;iZm5_kwzpV~>H6XHII2f;LDu;y{KgK#COyEg;J#S&Q%buOChPMlk_Edj7QW
z-peOjetu<(5$PADZQ}+kLN0eB8(rkUB0Rh?Kh-hOw+=`-)VJh^Mo>#xgL&UstnZFw
zI|3&eN$5mI`W}%sU5AEmr5}ksVj6+RM}xEe%aR5Tqkc`J_HZX9)S<Zg2+H=!5O(E3
z!?!J>y9M}dKbZNIhf^+U#xtO`Hi8&42P13*f07>|Y-@B@OuS7zz~$_QS1n%_F{;1o
z9<pyCyzQ(8UTdtj(ZdOCKEJAv<AHlJGRQZNuNG4*(v|6YCk~#1EvnN=MY|5;yl?lO
ziw!6XAemP2vA<;bFjJ`B-!a&cToP*u5|`^20rZo+e_c4>#Q%yZo+Mistwni3XbfNJ
z%)w>ri})zI8^RDfr;WH`1XwiarxTdU?xgDrK8r<REp(%)>rKd6Hp$5VWl7q2=MhoY
zqz+cV|8(r-jVlx{b^fw@(=_m21V$W{0eTJ+Dj>*5ncX{?P7SQ_8v(vNze$b=_ylMb
zMw&num9lHyBoPxjiuJ5+r~!Us;0!vU%Q(Z+{JWpFxglo^RBfPIDAEKgE`pVO0mO>f
zzWtBb_f;IS!D&j?1O);@*u5Wyr!L1%htjuYSX7AgXu5enN?9gGoi}hD2f{Jl@_N`=
z74Zv(4Mrw;7HgqUf>HYtTOH9jQ|y)#kfFvMfilYJ;I5weVc}m|byGZWP-5(!iM^}0
z>Nba7e>j^i3DtS<SgzE6h|Yu+&SW&fYqlSru$MZH)*HlX(#=!q{y97O+wuJa^+9W>
zYZ0rI&(rNK`CCg8E|JRgbZuV&-O)fuiiIy|@<lzX!r>Rz5wsp^_5O|4UIclY^t2?;
zHpN9Qdnr)WP@)T1Tv$KpIg!_!e1jesYTygAIY#aYRdktFs2kXO8SVPKmFODteCRKK
zGonH$D*gj|q#Q!vG%(~_v5*0Q9>(xkaMobGa_Ck*Q%i2O&D90y1vrC^6)yfEss&~e
z|D8YFYhpfceZV|29g-q#EQb@)LTPHjO;FA^3{uajXtixu+3d-v&Nc)Aaefw4^Q^D2
zl}}lg4`|yLo8?0F6Sq4$);13&0+{aaedcH9=;7$`a5D0Rus`tlPc-)5{t)0cnC`gN
zUd`q|r{g=0dvQa+c$_akX+zX22|!7+L1q9g%ZTX}&4|#1D$4wL+{LZ8Skg%Psjdwz
zfTyr2wR|ss)H>wS*?8%2Vw-^alL?^4fJ^zu#Q<93s6x!#kE7|()Tr))51F@0n)_|V
z)rw)tdC0M=vaoswqts<7<dMApgTY1Rt?sS#AZ+@m_Sl32aEFJuwN_*hN9>>ESeD}o
z6c0~3O+Z;-Uq)FPr_R58`JecP8yvsJCvV$Xks%nl{lWV}?@c*tLa!n<Km8ocnb}=b
zDjk0l->s_?$GZf`v*Qr$pqcL>D#VT9_ERJEO4QjF5UX3{-w`peL%P*Z=jUa>W8SzA
zjAwr(%WS;*Rp{3lkSVe^%=%#-A?b4s0=g0budm!51??-2@4xVFa9V@p0f>^dKQur{
zbA7(%9`77`Cd7gNJE!=OQNDdrXU@+CCzM3o6qV&?Ju;<H#7;*Lv0KDemsgB!Xp}o=
zU?X+>hwH=f*L^+^E3H)4kqRyos_*|U>5u0Ods`@l0!t&NsPQB~4j{L&P-1f?KdWG4
zVd|9B#Lion6=Jj;wbmQkO!k-pkDxWt(vSVhvp?npeU|N<m_~5I7K}UWF?!rP9diPJ
zcFaF?=IQk=`I>^8%d@7pp=NaVp?A6I+qUO?lP!xW8UV33Ag4e6b*HZvu4n1O;{++|
z9F>ew&R@4A1fJJ()VH0<h-^K+kfZk4$8j!ARF6g7ZQw+DvhN?+wHmgaK&uXq0;Zo*
z7?V@K5`q5v^eW#mD#%+~8dmuHkj;Cl&$21Gz@B@$v<5RE(_1X20Ak<7mt~pQhmefK
zw%S&rPn1l8mYTsfzj9ChTiKHRz;t^Zh1pnc50HYAA7@#Gvo1#$baRrf2mGmt3*DdH
zb!7WV*R~F5<J!Rm_UeYmvM>L{8v)n(S4I6|4gjVH>c3B@{!B&xt1SL<^;5j``=t^6
zMI!kB_}4Lo@vbDF10JloB>uSd%wJl~|92zM|J_9OTUaVT<+L0g|ESrc#%>%g4v1-q
zLAt<P{p!0#-O2cnl3zJR{~hX9GRoa)?XA08Q}h1!egtT9>KbTrS!X24z22y$D018>
zWg63cLZ9K*uL5ebc1*ZyEPZL1FJHFb74_VMBT|l=RBZ+*Gh1)DnWR3CUWwVG1&AvF
z3U&G&%#14Ix94kAEK2vwN5dn~*>z3S9e*H7{ytT%Y(aNM=U9E#s~OF}bF)V}G+D0$
z#G4<E0N03cvZgZo2`&<%Ia|qgSuD(S{ki81n~3+^T>uUqRt^xx`pfy3`r>2*edx;s
zTVbH=eSa|U@$!9$8j{9`xqT|2-Ul5E6I#Ol#9{osG;h7PGr)fkafjrL&HGuE%;wT0
z$=~p$LpV~SAHl39hHypMq;`?{njPnXGx=N;SUGRGe#mE!;`cg#qGSGk72mGxutvRl
zx?sdh&rSm?fyX(9&NSG$4fvEE4u25&j(*Y-ylGUv`kC8HE{c@{>o-yQv?T`JF<6%Y
zIk2mjt#J<Pa&LVuki@+N18_>VPNQ}5BmR{NK>kuLF;aPla+5=9_cJm-nN`#5HvNk9
zjR<HAS7*4{*3(Q{*xeuljQ_@P2q6BmoH%J35KFu58Kv{<mL_v7)i;*&@;Q2YWl;n`
zn>xkQzdhYb*A6rgS^VbcJu|XhZ^<bpKqs=jd_ESRHi}w(vpDPfs9-5NV&_fz(yb9>
zhwLc(_SwN%SWRZ5<5HwQrnGWE(CB#%8?Z(ce3+@D#bndMsweCt*ko-`BkN60EW~HA
z=VgRK{v^2k{f7VK0!JRMa30T<1q{^Rl>!H9UH?6#Aw!1CxfY$bhYZ4$Nox~NG@mhg
z(#U1nRvy|`Mz;Gt`s}zq&O~4OwlaJ5etov-IVw5j2#ym@*6=Od&f+BWfhT&&^K(bF
zzpK`0@lb*3M8=2Ldv03G+QjnIrj3&|n^vyWwNrD%V>#C)l?5JlHzuZLt5ko_)_-I2
z3&Hp+u!P(D?}N}z`_(DQrB?J=--ke>m+1|mUy~S-T&E|kk)xb4jcaJ<q696lqyawC
zUk0=ve%k&3_sU;x3f2={AUz<z{Tb;J$GroVy67@=()W1kMlAnG1t?ljCpnU*9Hi2S
z&{g{%$jslDxu*<uxx6&IKqBU0ZvA2~)0SnJ`iCv+?u*D2d0w;m(KT^oy<3>*;Y%b0
z_WP5ivq9gRWRfP}{Xw2@@RUUDSq&CaW$qzl#+WygCPbvT>FODb3sguS*C|nxrtEZa
zn^(GxpMK~LjnK}Hx)z)x=d{lJ9V>ea2%rxFKF`EhZZkco5KjCPqH{2k=1r4-|Ik%G
ziT?fBlDXXvZJ+plg;f0|4Vly_AwIjVpB-|l_@>>(-`PJwqZ?DwLpk2bTCUI<+BSTN
z?>&=m(^f4c{`mont>Hpu)GOP&Oxc9qcFPLF>SLMN-S*^CbuGzGjRGZMw@7|p*@a*j
zAud3+PK_{7T?yS^d|A=Em83z{O_V;+CoQC8*&Cl4Z+h|74_zY{w|YpKpGVAnOhAmM
z11PM^iHnNXN#?!l#ErOfLD1ge96Mj%per>^Le@|JM92K?BlETOOyKDaJEQNM{r&@Z
zI_hGFCT0e2u27n@v_i%jVLzO5?#!zUUb?_4z#t1;RxsJ)VhZ~zSVE{@Wa^7!&WaRb
zo?dBa<{&!j_aBU+_Dei+G_L|a*YjaT#S(#AJ*+3TY*6iB7U45C0mZ-FGVZ>NL_q06
zc+Q3}4QI4w$rYeNWei<xD#nJ&^fXw6o6amu(T}Ax{1tZh-&NULyfcH_N=!~zqw?C~
z;&pk5Yl}u$Xi(G1QN^u@J*~5?0u|6Vw(k%du0@7yY1!<n^uEO@vbXmQMsA#?gEg(J
z;`nl+l$dshZ79FUxrMDiUTmT)-)`q&L1vSfD+c_gHeAh%5rb7E9;pEGCzl}`SKl)I
zxKC0+eK#&fP*1gW{cD}Jvwp2M-g%GlnNx%9u9K;(uzm=@UaOX1)t;rc)9SqiG$EY_
zDQkB$G}-Jw>KoYaP#tdM-r{kd;2}pIJQW&Tdu-YuOxfV2X!b>kX)HiF$Yr8J&ro8_
znLUg{GEWheFm-lWEuFOj=tD{{rT$7~UHahsXA6<z<aKhi%&a^^Qiu{$(iq>;9K53v
z=%)t1--%$Cy=~U?UF=!Y%@OnbIichvq!Bvs81CbgoD(YajX9uL+9R>h_dz(vfD*Gy
zWXuOAy@>r@|8KS5oC2zxVn^+pJxCX7UuaFQHQQc~`d5S8_HC={BkgJH;HFax%B$1;
zAuLD&dqyYw(B^`+*jXM9m!XC{7GBNRW{h%B>xhyv`)X9_Q=x$cHFTF3tk%FlqMB}V
zrosO(vbswoUv9|+$5}&9ZJTYH6HaR9MY}lG$Y$dYQu#%1D0`CH)N#J$hG4$^pZPP!
zr3hN;rb+Vht77Ff;UH|Ep^turMm;Ie!wqQuy>FT4tUb1Is`Ax*f(xj1`_T2)Mbr*R
z_dV%3|JHat`2c9<Y+y#PY?Er`XSWs{3CZ&O(OHjn9#&wUmYwJ$op{<eat|w2cBC;{
z(+8W0J`mG@YETW8`djm#0SW<;vM~O^Xd^eHij<L2I)#6&124_`ezsC~bs{8$`kKz^
zQ#ajp8RlyxeL6>!T~WCFuO^(rRbzTJrWpr76S?<i2Ntiz1V}-EEv*DT5i=wN`4#Q{
zf8IGhY5bNaIy)i7l2u1?bX?fwGpRmW;#3{VTN>>A-nmh6ilX$FWAra|+iEDClyjn|
zYG+IAA4<8|x%ya?06ua%R7kb8=~(y{;AZ;ea^yP2_j2lA`naL|TBl%sOJ74nmpbdl
zUV{ift!fml>d^eLPBpq-{>zKxYF7*mh99GjaT%ww!cpA#Wjy~&CubgU>^pc^>er7~
z-B&7lI?svU2}y6tZtCx)@0g|zyxV)+eRVHKGT`P=0Ld-n$Sg1?XHg{Ctlj}$fJ?*u
zbmpX}{KqjRPzGP!|Cg3W8j@D*50DHRV?UaPd)RA0q4bYC@|9G)MXJByu)X7*-GD8f
zew!rirF%3c3gG=ef??+Ub0jO45p5{Wc_X;)_@)AeoG2{KMotyXpZ|dYLCq3|>f7Rg
z{NaDNGCvx&QsJYWjp}%;*3|bK_q=9CD~4v{97gv&bg7Ck+(tb+u<WphselVBf7`N#
zyrDsV-)&6(Z34c;f?T)jK2u{o;?@>V`T<b%C+BjV1NvlND@3IeMimZI4rWpV*`8!q
z9rpvuS!g8!mx-Hm7Nz(Hv<&{^y*2b%gQqr5rK%EdHTR^-qyZsCN2T?o&e?YbS_PRk
zkV46t0$Y?Z?`q}T0LOu+VR;CS<JDm@JzzCc2-R6!JH~8`DkMr9g8i}OVV3#-#Yg>7
zM;{H(<SY3+6g2nODzx;r?6K0p5dg^62E68;eA|is*Uz1I9xUQEvlE=zw7nN7=C*sh
z>0cCjX_0i?4;?OLx(S>E$f&A3Qq;H1uMVq2oqqYB{qr9iB~UrDX0d5SKv9zPF~Yoh
zqtF~fE;O$?s7}J+llkjcs$xNFT?``WHZ@7ryKr;)q9cj^IRN+})ZVPN+J@zGYoBbE
zoKY1q_J7!u+k1_Sizey&FWzBd^=t51KC+SWoPt&j*IOJG5XgO-5X+(TQFjtS2I8}J
z$EUgpPP_-|^?Uxl3s0^!uRVY#83iUfipy<mRSgC06)u2WWB1xYy9R6l2H+sTloZa>
z=dmI{+F^lo^aqtW9g0F+*9!E<9kx5FnPo64>??s%W3JU0{AXLU#HdXwAkLwsu#+s+
z?zq^1C|okALN4{;HpWDIAR+}d3G-`ekOq{Nz<giu{H%?rm2mHDKH+{Pg23Wu(X&dw
z9Xyg6d3ez*;sYX_N=9Sv=LHe(sZ8XBoqEf`7&ZKhZJ=t~43t`J7(!q{eKsN(1CD^l
znwVYtzw9$R=Kr*M{-LQoaR(ID3C@#KWA*OMQ{ls?@(+tTEBM^nnm2`V7lqo>RvH%1
zgmImzJwTX?;p;hLU$i;Z4=EBRC1<<h-4b46{UjQkfM=1}VFgn(?Sjmm0atGW{4(8P
zP0^OTLs@0byhS5H4DWnzt|uW)9}6Y+ZB89vvK<y@KNL~n^S23U&mY>L5k>{QSoF+m
zQLAmsG8?lK=P!AaY>mWr&VLaaM~tp_yPFi{OJHuyQ{$uZ+lh>VMis{!&9MUzsBpY#
zVe(E#TEZaU@u)=Na_69E$I?Qnsd+EEwItI}QK7^KTZGB>n}ZgCMR0}P(ve;V!G-Nb
z%SzaBCUyR`lnaBs^~+wfeUuf)*nokhDHOEPgRrX&uK7Z!hAe`l0_D$s*W0H8j;;_s
zM3co)i3M8KP__CWfwOZLHX>pRL)I5gN*j3)T_0;;R?n@GujPZIqxk!g0N{E%d#|jd
zAtCe}Wza+txr|o3h)zD0@Yp08wyZ!p>;K~JOTeIZrt{vWEa$Z%44+Zb+VkW^9x_5U
zIZ2^|Uvgwg;_Njj#r<J?wCUV6D|kMk=EMFpMp1M~#^%J4QnA^`giDm5c?JGX2*`;A
zKAZ?KF-nY0H^hMLFfRoootcDB!`UqPDvmCfyZer;NnCafAy)Zu85qT!6U9e)%u(tw
z4a#*VSy%OB9M9c<OG`Ovu`M-EX~ZV<s9qGTgWGjS_-k3wpu>^@>&8sxVft$Luv-3B
zTyB9}AotM3KKP{2>a7rfBbJT+IH(-F7mog~DfW*852gb3G>MP*4CmeCZp{mx0ZykH
zocWD0z(o?NKJM#9^l{gJh$yL+J-g8LA-!&^6nOPZS^I4A9gP47>dnb!horqGWgO}I
zZ`C<juFAkqB06dsem2=#4D8J5c=Nd&59&)9tu55A`0rIOw&%rLCJar)T=4Wh#c)Pu
z=`zEcMz=N|uf*GwIK`oPR3}pFI^@art8;=_u^glY;COxEe*~3uf@KyRCyG1^VLdy?
zWLQiXkC>_}*^J+Q9C1yL`sAdmN#ghEd|vX8LlAv{?W5NQe>l_fa0|{d6u%C@{&bb+
zj|CYV-u1pNMi-!`>F-#B#2rIm5m;}Fsp%<`Agpj&4a}x!%fegotd7Po`GlgUEwLwY
zlwc_pXhI#d+BUg2pXKHpA?x2@;d)W9C8)>RVj}87$rPO?i6c^ISb2oAaU#`d0&u#&
zT3g?qQA7S*x_os!<atA_QMWKfiKjo$0wr_2!ty1jkW+7CR`-(%d+S#iqz51`;$S3!
zD({uI2Ycj{XEzWuOi0*{?R|XKJV>V$7za>LaN3NtcuaiSf-PLrsBrOCp*n8W`mf))
zXHLA=_umD+V~u6FK?Zm>Ls`CQ1nVt#!li?A;tjU5t`_$9U*@~Tv8M<1E|$tcRyKSg
zj@qHnqK=!m>3)W_$FYew&BZns(+2l6^W&!j?d1L5DD<s-@~M>@$tEgN$awczX@xux
zx!99P<EV!KU^2%~wi^bmWe2w;@}R=t^&;QzW=7blt%NY@JSD39snQ^S+s@^f3)00E
zn0Mz4Pf=XIw*zHkDM_brDJGA7RS5p`g<YryoVZ3SOR@y;zn<L`RX+LN=3cNzCa86D
zsxv?2tl@>!vyEszq0aOIV0XQAsmdCb)biWcwPtNcp{723RYS(P)h**Z4UzP0i@NU|
zb+t~p))jM1Rk^t5dx?+*52uL`SD#%qp<L)&s#mY1Aa`lBFw;d`ts1l~mb4)>-b1y>
zd|#iMa_~5x1C<rsYxNrQvZL|7QorPbJrAMIW)H>v<=UV_OrLHBYUw{tINjl+1$pn`
zH{Il5og84G9b<aDB9!v^LhQuZ9YvHiiB_sCAl!5{boTq6r20Of&CLf`o+LRZHre#T
z8W+r=Q)5b_>oau#9PssR9^!cHEvB}Ej&f~}yZ&lR#?Z0WQ2LS+e#4^w@Aj*g(<zQS
zzoBXH_hh5~usiw|CorGCu@-JFi{u#M;5Ej&)di{uF1p`K+Sv$p=*n35K_R@54kPwm
z$dhaf#aM7+ZbvJfdQ(_S_}Gf*v^#4U<1M3p9d;By@BxKfqttCM+qCWfXw5{vwClQA
zWtM`n$%4*;e57gK=A%Y0j`rO|f~`&*Z0Iu4L%`GK<QyH(K2ELLda3Gqo?5}u<mQHZ
zP)dr;I1w;s?&Zf?M(IgkfxgBviXxSaQzZwmB-v=1=F{Zs?v_!H|G4saV`()*xeYlt
zZE5rESpyB{p0?l*3g<cdrjGX$-Hx;w72F30vaHOr{{51-d<=0lL069-5BnNcOWH@2
z$5X5wCgLLrCQ|0Gi6yhpEBm<tZ&nnm<u|46EmkgWwipOlaW4&eb^7&+)tjRNqst4d
zxCPeJq+0m*{aqCR3v4-g)_)@HMWr+v!^H>8KIfoT(X&hSw^k3fVr}#j_7&tJQoI()
z9;F*vN0xIH%iAa>ioZz5zYb@GS%FOuF12=<RxLDRX)_3T0cR5dZC(D7!m&ZsMzqzN
z$i?r+FHBB;*Issg%q)FM>^nUN7><S_;qTqp3H|MQ;rn>v>hT>zrvN$R%N0k2m2Abr
z(R`K<>G|HE*Kw+_boasP*dE8z%>)K}cDdE}-Pi13Bvm)FQ(ynl8lUXfhB8WBiTiX$
z8b#QG;~RVufo5>mT^5GVJ#GrTfg27&KpGOcW&;y=V71ZdTraVOC(Fob06jcOwjgyM
zb=!V?75u+y|4E3r5u1r`s~0ppuoXn{Mep4&=Zv7MdWX-B8++>El*HD|fZ5orfaa-}
z<UjWl)h?an`bb9uK05%Lgdv`$i2a{0+gkx}C~X=YWJ!v3$DA`l9|bWnK8UD7SUt&V
z>VKSHe=BS}hxQO1uwS2&-Kt;U9PseHD&m~MshO_7OS^#>4~max*oqB>b{QN^{dG+T
z{jn@*_8Fm+-)##C*Gvlld*BJa1}?W7mga!y`=0Gvv=aMh9LAIIFzvkc?*F{g`TP9r
z*TeqXH1n@b*8d;grp{;jNzXn9Yjhqkc18W(D~rAi47|k`mvkhw3Z`Y_nU9a84frQ+
zcP{bP_RDKOE(6)jo0{Cu_@>~0MkBArsv5^^_ugUjEnhMx2`a9;km#8aBhj`&ZJO06
zsllTz_SB#By|pn{&i+Zz7f4>N8CN&hIZK1B9?WOhF-Caf!Oor8aadqFeB<h!JX=44
zI%&M?(S}Eq{HlLFb;cX1P{tGQlfkH4^{B+V4H2HVF`cCQnCHB9hBz)q<dz1DziZ2$
zG`X;~EOY(UKFBc7Z8YqD$cf&i;Dth3_y?v2ui$rgO8rP&fHeQ3g_&wrt?N5|E?l;}
zP_30Tww8~uXF>V$$6u3niQs;K1_J(krMh1=tI+?0?64`(kNTqkpkxq(0IWtsWbDd{
zprh(USD5+Qu44Q3Z37e{5#2R4>>f7w30aBi9Lw}9iVJLV>u@tKPGJA4p0^a$)5BH8
zt-He2&WwaV_2~!vNb#aG+g!%o)<5}8hV#NldJJ@}WXvv$+N*&q^7*a&>j&;AU18gG
ziMra^gh$x3<syw*pXLElmjcPOfqDNB+ZSTX5s_yNHP}{GD@P;}Gd+T(t++-ZRUA2z
zJ<sS2`*EISL0I}3SdwRe-33FpulGJ1XBQgrWkDeCu3TAM?Enp)ho%T2^;5B4t|MQV
zO@=W#aQ#@yR5j+z*;nGaR)zDJ_2ZkDC_b_L(l^KlZ`zF)G5`q>&2OjoJ=^@FU&Q}0
zNdV?7wOc;Q`J<LnUj}WwVjY+#|3E6UT>I$nz9C~w+xRM*{KTV43f*O7KQq>4O*$?9
zC<1GK2}%B(ODwfyQ(m8NG|jt`Q2hA9YlEG*yKefM0;vuUQ)=lAr<d+mJz;#23+|Jh
z4_cfhJ}yq^riRF|8y3S(X9@&fZ*4n!D0rIU3H;Y|w{o49ON{M4PN>E=0hGO1BCWN8
zE7sdi9plSyS%RF&zrKI+IgDL=(zEsDIY&N}Bga5;8A@J#7o%HN$>%*Y7GNY|Mu^1=
zfs=RC^ejMx5c$1BQ<J({1ABvA-`FcgU9l}!$vTsQj;6w9TqBN3*wr>~59V`*Y9J?Q
zv{(q($?ONO_^e_tdNR^>Trb!B@&zLm4~t5+_XG2kd|A!NCJ{$n$-uennp{<<1nfaO
z%MVrYz-WDSI)(hjvIOR=u`O0U$p{gNc<2C$Kk|`^aSz&pw9_Lk37nqaW)k!HEZ+W}
z+EDdN?xV}yiJ2KCyann`EJZQ!W?Eg>*rFk=f>j7cZq!i4A9}0GpS#=mvh0_F`c$2i
z<;R~<1)>$$8rOK#<M_`*`NT1{ZOwtrJn61`Oh;^PMH3u(hu35oEe#BLcLq=ihgj6_
zj!rV%F>U3eF@45~=QUS!HoFUGe3cd#p`Dq6=>%H0Nd~6y`d!<Fc+~TY1NwA73UBr(
z+^JI7@-!rAsj)MxNax#@HWq#m8IXDwJ{=>{d2U)mhOz5>Z&Os;^WtKOilY%+;*_82
z`QQ4pZ-y2=r8mqOC{ke$1WuGm^3E&T^KI{Aex$sL#(HYE=8kxEYfKzwG)I)ob|wx;
zt+;S{;o$>q$lwMy<&CkkOZVorOUJM3R%x>ZVXsa}!9ju2B1dy~;HsevQIEs>*USf&
z@<J_gQ>V_n?UDH2nH+PMJ_jUEC2|z7Se@{CvpmZLyxBvOZW1!B$6*G2C*n|pQUy7x
z5Llh{T9F<r4*0<M(beN_rVT%~!PR6@E2{YIj0raw%W!YxW;dFD-y#H`f7?Gr&}d$J
zSPj*Yv~N>vnj$T4%B<JwyoK(Ok|&9qfrH9zwL7=Wl2Lxg0Z*}4X{di6%^NDIQe(qA
zXPWrWyK;d0K4$eHN0SNbh<OVHoX8qGG5si3Z^+sAP@*+tT;iTdkF)O>BYbK4MSL|E
zHNK`b)mMP>Wy!Z+v<>xUR0fy6{|g-*@)m%x?>W#YeqRD)Fnsikcb)knx&NL;Gw#!3
zfTKx?4qV9f(|Kq#iyvA=S_TJN`N+#)43+&37(%*LAI^EYM9q;^<He-Xvjub{Sr;V}
zDBpqXQ^*}}t^fh@<g1C9N)-)bH1-7w9p!Qx_d!qbU+)BAA$cz5x5VG2X<QA1rDTb8
ztM^O73HECEav>v72Z`1!USGh7=;#>rz7$f$o$d-Bkfy}Mzjka-(ctRRUXl^5{K1!N
zx#(gG70pGNfPzh1FGHtClL*h}#|!6vw313QQM&I9WcbE6*sH0nlx@TIYOF&{3r%w%
z4zS{|p|(b+iU|;*MR$C;M`OY9>fCzg3>k2nwKQ*PBzDV=6YXVye?F26+V4Ch0L(a@
z^WDZpTt8fn|AKbQF%7TQ(dg19HOGQ*I9aO|9vxyutJ3uw@t=sNDv&LEA_ceZ!>bct
z6MyoiRPmO&G3G+mP*qP0@@ca|?jMb53vEjDU@S~}6&O;AqN+C_6$&p7!*tmv$`hw9
zOT$$ktHi4#o<+f_2RmP%mlKHfC{}mU_ci1%PFLBg9E5s#73sGsR;lx*x`hY9XUh4B
zq!cY1DFImtUAY<6O!rdhLF7ABvTHG-<4x-q@Tz+d_9ui*8XP47P2#p6XuE=;?Y@T`
zbe`gmM+9DDBtQ-8nc7<y^~U^7QsM+Ij1J6WS+X>emClhymT_~!!zyB`w&SevhS}R{
zmBd@~pB&Nh*^=1-n_cDV`=Y!s*GhZk#)Sci^G8jc@3Tjo<bpOa6Ct1}3F9AP%E@L8
zC4IFw?msDGJALF)+mWQ#UX4fu3RsigP?RIpetf`_4wX;WKd|~{w1*9>hF$g2SgZN*
z<I0(7rRDlA;?D7$ot#zZq3^Zwn~CcCI_M^%6pIwzuao)b4zD95>zr(jj9Hd_iwln=
zk*23?1-sMv+Em<a_A+z~92LCcW?bpw5w>W|b<V@Q7jAOFU+J3NUO~9PaY}p1;iux`
zR}GMW)9-mRYf%QH18z3{r9@2=54OSM$a@Fo=?bAk$H>-qmLdDTpR=fm+VfDe*z#QB
zu(4$4L7iO<{I{>hzk(xf+&ZgH4e*|RUwzR@l~1cXSgYj8u@XBCNW!8mDs0veS9+pB
zW}Y1>LEHmk;)iRed<K#y*51mF;IfW-f5@8b?A`?88(Bw&_&%sLE!wcPJ5ul4IWOI+
zasxtjstUyUMSqFnNE|YDbwZ+YPI4hMhENLx#@<4+?Won)&fd;^<V#!i$|5mxkCs?k
zwZmg#v;=Q5{^R?qE(wWbkrWUxhPviP<15raA}`&QK26S5gA`+~;1ZL>6yNrv(nLtf
zd7`yUU8aGb9rr&qIH@*#6Nxu1aQnVop5`h!8K*swnO*c*HRo`pyYSpXV<N#Zj9_15
zGVU(XdrvaB+ME|z`ocTYRb(mIy0^?i1H-0fmp~ievBi0mpUFFt*rEe?bziJqo}j>`
z31b<)mxT#<^fOu1KM?MHAMAt=2FIBexjt-yLL*X<U=o|CN(y+YDn5)gKV>_C<w$tz
zdmvgsy}%)R+OKiOr_TkKyX0b$hq5s)lAi-xi+)>=J<n3=GF@yg2;i|Dq>sC*z1qj#
z?{>a>y@_<R2Lx7k5+p(}a1SYJY*pGZ=SvHRGH`Wf3#+ruI9Ag;9k=yWgkj79T(s&3
zi3caL+r>S9U15h&lxttrn2aIZgpX3AQnWJ#bYSd~#UiclcC7d`0Rbqg)n0Y9ZUEx|
z{)AB2-v;aC?M0l060WOI4#IHVI;4VFI#Qy|5cmGk3xd7~o3avH4$Oy3+jC9@Pi44m
z`_(Hvak{-su0Ig{$LnC4G(}^d3-T1p{!O+&WD+g2f5h_TFa-sYu_`*=5iC>RzZZ~1
z)vE4|+=q*QTQztzx|iNr7(<5aOAQNp?&aCu9itj2?1-4T%YJi%k~c)zI89yTx?tH>
z{ikC@(0atxHF8c-=eB~hy@KYJ2p~NzP@k`${iIQ~Jk)1rK_N`_>&(kN%!<>uXRePy
z{H&o?GW(}fY`H57F|Bm@^-!&$km4>NUk9@BX?fBA(I9yERs{P;jnz@U(>W(ntBTq`
z^#u@f0bgq?t?Psnfx(R2Ujl<0IRjhMp*vKsmf0TbqLm^}11%UD2<1A_E?}XEqE3$U
z4zz}PP~z(N7Xl$hjvHGFfJ|cS)kn_hj@20n1U}eyafHXyT5QC*;sE>}AS!f0Exox1
zM6CYt?YbrDn&7)RT@$aeF9<uWANNco;w3>ivuS^~Y;~?V&-N|ZB7U$Pb85(DVj!M8
zd!HpsPoeP{J5PE4Pf5e6+7f9_$r`RVeUcGmdriD~zO>=egb3Mwf^Df>z2h1(N}_+-
zDMpM?EZONPzElds_?X|zvOvhnK{ZxyR%rCyw)#D0mg+}Yz$@#N9#^kD)lOLkiYlD6
zvl&M6s|hMNry%l>;8-Lx&hqG62leYj3pUgk06AEc(=YMPsA3wD{Mr7%@9nhERSCQL
zbG;Q7bNlM^RyK~s<6CtGI2lr$>-X%QwrwLuDx1dd^J%{~?oE1&PbqC=<2^Lvz?c1E
zF_;t|i@CA(J_b<}w-<@6F_Me^!ZO7DXA$dnSC8C>IQbcldje9ymYXAjUXZXZi#kJT
z>``At)zZzg%eC1_6IxC+Lyy@dd+HP{B0*JM@}_(qO`rHn1+zRdOTZa>VGGMo<uq4u
zz~gIuxyq_l#J9N@xwxyI&l#|?)H?<72Wu5<UL@|6ch^KTffDOONxqU|=zyJlWNU((
zi6b5)<<%FUHjU#sDcDHcryBX@thILwd`Zm5?x!6|t%IUq7z+P=7)Dc)oFiC#T%u$Z
zs#kw6l6bAdFUiia7g&ewm=xvW3$yYd6z)r#|A};%Jm1us6ohS($?Vy_s3Ci+*Pcc&
zMz~x<bEts;Xn#wgu+pwli_;?RNF#efZ?*up-Tqkd0bAC_WWzO3S`pu_Y+maCx}ID7
z_`cpeARsH=yk80cx-EKL^ELgAsvmF5;0p-->8lC)5ja2uQt5;@gyn~u0DHai&KI1q
zo_doL2elC_Rj=QjQxVHcWW(_Z@^~}2&y?KXyt|z+SuojDsnb=ixkBsx{eykXz~?t|
z;9I0tH{=yLH{>;=Eqh7tkJZl`E<1|a=)cpK2u)4idu^$yrZ<hIEwSKUR5tP;{J0$W
zQO1s)1&yJT!wswQM-OP9E#%+4yMpQ&1u~~V<BTbZBW(esawF;t3FA)2x5KN*pQhNA
zW({4p-`0iSil*wl8qjXFB4o?%Z+HBsu%ZH315o_>lA8?yMUlZwzo{C{c?hTBDt}kh
z5OJrg+Zh1Eo}*PC9wq~2waIg9c!<pj->ek>3=`k$)6E)~tafWYcdl--<IwWMYQ&c9
z{reF{134YW6aI@XK?8NPz6kN`mJcuHY3C9Pj*J9kM3x`8?(3-ubRO2}3$*&ETmI+_
zTjnmvHP6OYBw7ZOOBTE4pZ~cmdIrnw1g(|^+rQdfXTldc&c8ll6_otXdg!zBymEQ!
zXkxapo+I@B;Gg}#Eh73(KphpXSrG3_lSh=z`=SV6U~gDow+r1Z(6kCb+1^I6D}fzE
zE!c))2(VT2&@vA0Ba)Vzmf(Cv4Y2sI01+X-Cd!k{_7T`;RpO;GjOO8dR=1Ztx8jva
zP`Cb5Ue)ImcRCO=2Ml)EE8+<>hF)!vWq>XxpKVE;#>1<EIu%Dcs2)NFh$&?HekXv+
za|r4kj7Wf<ww?Tm82M>{s>-=*J_gWx*DCQgE}AHre?0e}GIFRhl0=c8WTxFd>lQT|
z;?EiThx@7T{2%V8Z=x7AX?UC5Tx7%LcvFt@hBv?cDyquG@pu}W4!hCcpcyepg#g>E
zHy8r5!x_oP&F`{G9}3_xBjTr$H<QoNVI6i#+{?nZO9sDeSew_m;IL-^+Ze{*Q6tjH
z*&^e%%XKEcSawTF+iRm=u`Y=#gEI$|cRX&VH#Oa==ppNjksnp24nPpj>RQbGa}tMb
z&i8v~c;gKeaAWFEP*4;KHYl)!I_qX1tDj@3%3uOtG|3C9cQ=W4NZiIHl3iZCJrs1@
z@DmNO28b|2gff;)`sW8#HcBmER(NODpNriHzshY6j6kI0g`tp$&`=?M=ag8#cbbZe
zE_p@RRx8)}wDeZ4Wy@5W(bua%)zGJmZ_a|EzNcI4F8B^^lY4UFtj$fKNrZa}P4^6-
zUk$S&-r3!c+)I*dJVbqYZdiGAM+DR&;*laD)f%a`O24DCI(glalQea~^?V02Ho(g_
zDaU&!3rIfP2D{UZ+M00C!(1NAxH;7cpS7?-o1qSw{7}o==!mSPb-{TQ(x6^pC8KTS
zIijbVsmFH52`BJQwk3sJAUZ!sgXsd+$eo?e18U@cR-w9^76~}AJ#CJc@AC6&K?62J
z@jvSspM;!W5)NGL`jBu-=&|axJiN_zq7(Y4fS>Mk*Nnuvfb&~?{#nf7tz*So0d@9t
zh9CIs^KE;M7-LinK5*Y>{fQ=rP~{^u$O`uf__DUZ7hSNVGo5DxM7QL-{krBnEpz7D
zJq4hhr~aE8@Zix!OS=1~zTm$%IH?R-ZazC+Z_;X?8+@!AIs9|6B;k%RCPUwFg<u4F
z-AW`4=bX-=Z<A)ROW4~7^`h8K&^HNnQ`-QYt~tm6r&ghSertY|EnB&eoo~C{f?D08
z)i)7<dET3=1ZaSQ{b6Ho`u6%tO~)VPvAkdD@r*aXJc8pOO_)eNL{!ywWIvW1IF#)=
z%E>zr7EgCt0s(1&<S%!R3%gzsEsXX(E&m+OKM;|O*nWZ7=FbD`O9rBjcEdo{9bMa#
z>&_T<!d$NX)L~@e%8fJ+m{f~`vy)txCl+T@QO#3ic8jkRY}9N~I3WS<rnT8kf<)BW
zsL5||fPTZ<JvA1L`7lHk;p&t>)Y0f}bp<Y|QZ_!X>X69R`h6vKK$aZYYnL|Xvh)$$
z?cQZK##migU6_{a`t_%}kb16dUr!Od!p}ydwAFU-!EFuq&E)f6r&D8YhAT+Aw4uU0
zT#ewHMQLAnj8|uTqRv0(R!2sX*UT@#{p<O2^*ej^SO;F0oSRO6fN=HiIWzyDif9o}
z+_}}Xcg4tf;)X`DCXOT`ZKQ&6t>=l}OG3Y3Q|p?Zfy<+bf&6Qqi_96>i)?ap>&jY-
z$2HaLrROV~YJ`%(b1P=P{7Z*fXdE)wS>%lH)odd(i0mjZF8Zu-4>~N8J!a}?BCEhO
zX`DB$e;oR8@;dFHM@IPo^?bRYq)LPocqd0bBC&Ced+FZf{vmG+ge2qGOL;i#0Yv<a
z%6CCd3U|=jpuPIIw8E;FWxtz=@W(laqr>**4a<6iPsR!6nhrQ!l>tQcvPAnDE`hki
z+h}<KyLIDASZWbKAyvWh1x-H!JD15BiDg?Pmb=trB_#l`v!=qUPqVO;fTYh)eKIf;
zl+*WzcEe39lzZkYV)jg#1*j>|62FcZ?_I@(cYGZ=H8LIp`zG&rV8<gIaYTO=88V%*
zEfvwz>RV37^fyC@1$8#Dn{fOht0Q~oS;c$1q*Y48k=F)#u_<$dSpJBV7qB)26t*_`
z67XO&zd?7-!7n4ipRWYZ4jSGHZkL2aP#nGvZO>A|KU#orR*ik!Qj3N>)B5(*C3-1u
z8aA5n7!F2S%^56IN%i>G)8rH=fiH-U4>2k?e7iIz$hqjx(K><-o6urf>MeIUJp8nu
ztvlz5^s;=-m_b-ujZWVNxpu)cdfaK|?&eM(vIY@qB4zRAA8`WItNX?sw{bB0c!@D+
zdqu5f@1>CyU}uaZ>TJ?ED~!LiZJrNdJN;^BQzl_O;nJq!f#EfRwRjV-0-#nQ7CAPl
z7e;9(Vky=XfAvWhCF^c3R5)4A4BXjd!0JXC-|j@o-sw$Qj#a+42mvUI)aW?$*0ulI
zTnJrYa<J}c$id_(AD31}ld4?9_tEK&6)y5f_;Uylzjbr|1S!4{rA*Jh5#h^BmESAB
zvNX;-2sOpV#34})fa2On2)EcQou}rRItU8yNC8|@n<1X@R)~(4*r0nSIm%xP(jR4G
z1*4xFioj>47bx5>@Wu;}H26S!1X8K6;@fi+lF`2gI;rawrA|ZdW-4<}jhmGz+b39N
zRMAsj>|&8EJ<d(wp0}<jH(-~Oz0nG2m%B0krSoavUVslPxol!ODj30bp~XPM%~t(7
zGP{E++~va1O>;}9(Q`h?!---er^v1asT-|Y>`}^S0M=VW*H$*=UD&!m`1D;3>qn*&
zMXu{rJ%D9JmX>+KLoxOR@P!)cMeD;s%o}GY+%tY{p4y)5{3b4Em_t4NkuEm=m^^23
zVw>>}djp@o7Vj>>yrB6B@ETx_BwFICJ8UENPJ9Es+nu)EKWwPaOR#?OzW=f0&v@y-
zi}XM0e&FB`1^}qF&r<Z`+|j0UZr?H1)OKFJd0r_jTqQu%=|n*UF8$JHQ@Pq#PSYi9
z?dcbUQUCTe{ZNhYs0J4?4Uzt)W5l&?x)r`2W%pU0JO>0X)1MMfJKD)zUhEcLrf50y
zFZtwO8pQvLguNTlx+m*(OjeyEXXcCWfg$YEbhl9`uclZ>V>aj#aMUVZpx&`GzM7a>
zst$ZD&F)z-3f5bVO0UMwWmEA8y&EJN-7FiGP_fN&8`XfEMsWhux|b#YU^Bg@dGBOr
zv-8A6myMP~x$kqe;Nr4Nl&@@m;n3$3>|TvpLLZQkOhGg*5!nq`=XLb8jxHZCh}%1V
zxifS66@dF`U{&dg<1Ayu3te#7jlD!_pw5^4UFKvkc-{9O<Gt%<>cyjjH}v|lDNikI
z2tUQXcdp5-@y%1$3yhTnN3ArMC2v$QQ_2B?20&2%56cl;$NBfH0sfUJR8K`;sdt@v
zBCDU3w!BpWTryr*J5W$vtgVr<%r1&-ra)yCdp9;u)GX_9H`;ISvPxw{nM1C}Lz{<)
zgt_*CMu-Z(`JHa)yR{mSt^qtDu<zrYzA=>HC~)q7_z}W$ww@ktHm7a{u*cM*H#OqS
zW6WIvP+EM}=(Bk<V=K<)Z1u2##d<Y+HUHiF0Vh+A_3c|&REs{2kJr8vnH@6YSscQE
z)QtPVJ5FD&8cg0#p>ziBqQT{M-~i4tH5)*=p|gDA#k{g#WAj9V!1k!-4XO$a($1Yo
zFuHiq1b_^2$8<-xT+IU~nj1oV7Y_4K7LQe&OrII!e#C$h8R6ZLRUd+&E=$W%Pjb2&
zq~RTM72Efnqc-04NEaG2%dI4##DtOrqTer<1A)9u8cwF<fYZPY71sU7!^qGJ?lLXW
zF%;{GQi<*ajlS0JRb_i(AmJ8u^#X5GD`}{+@zF(8y!JZ49~|tveRVcQcclDDH(I?z
z<5NsQk4fL|S5wCy4HFx8boB~3l85kFzbS3z`gzsF8=6ZfCsa$SY<5}4QFv9od(WHa
z2w=YWnAL|_%5^Hxj^Sf^QJ)+u)G~b(HJs#GUc)8YAQiPeKpP~Jp&Dbx!$$w2ouA=5
z(93mlEgH+3acS_!0JqAKB<f_RDw262PI^3@f`DkG7^XE;%Ph`Rohux^J>Fdww8-FW
zrwC*Npp?W8KIBJHu8{SC_J!<%)@%N$(T92%8k3({hw6KiOx8JES&4DN#dO|g`<TDs
zdG>W1%*e1q4%=zheA+XW%dXH#&%-}!)S&^De_^MBZ-=<hQK!LeAY?!+(pfU*(&LLo
zNDp<ses67w35Nv=xg`nBz8fih03KSwP8}JgE{zkJ*)!C(P})n{c@bf=n_ZqfaV5Id
zGH{hINOf@Rh=_AK-OjkgA1{f@KZJBTc>vW>wpbUT+L7s9Dq+T0s7YzYz||W)N4*kz
zM_?%{BadsuW8jR7fJf5AJ8`ZvV(C_c(m@w1Y}ff6EG3Nvq7k!+cFm0l_X*&z5+6g;
z)(1C>C!8~t^@w@laQ#?R?xIU<$2-sJ8o$FG<~+6S6m05htVzl>=Xhyon=?$2S77t?
zOGz5T8iV9h2H91LD=LCodP@cveR$EJ;?$vTsyl2v<UGQtWso~}2q5714!sAC1ux?C
ziD$mp@AF4P4!uTUT9F$qq`rdf;AAxD)#wUS(8QFBvQap$Ja^#CVwh%;IRm>8QXL+z
zThDbhlhCW_+jX>Re5=24I=d37W6ExP#~`}Nahxx!R7{Q^5GGOxZ~U`(qs~nvxeM#3
zK8=Y-G$Do4O7ZazI?q71WpZNe2c`Yf6Ij|PNiRH==PS}dqmX24af}Af;wx)mE#YyC
zfbTWBJ17A`-bkKmFHk8Ote@F)7TxOPXKEgQo3SW%B|N*F{c}93ghl#E?9>R#-lA!>
zZ&0S1?u73%@N&Y7ZC!a;Znn%#*=QSVnik6S40ks<pX5%>mvv{5Z^)u`SK>L&_Q(<=
z4;y=dQj0N(_!BxrNb@BnbSeGep1gkPpAVg<q{~Mg-y~~^d14BT$-`R^Gdt@qJGZ^f
zbDR2+P`ax~cqj5|p7QZ@AAIRde)N{@noaNE%+@ECue3~O8S{Ei2yQua<b>K&8H{<N
zzu#{_{6q%rWAf^KG)ukafOwlxqaNF>CqB{TdDRSLH?3l6jU8j~`4Av<n~UpqdZ=gH
zm2Em1V*?S_{>e(m!iwnyd#l#nBQIPu_&Dct8$io3`Qp3XleTl>h5he`{ZA!e)|ZjK
zt*<c01jnF)%kd&g5&p~v786(KP6<B`=W$SyVR%;2MbE(^bdG&!2-qg}nk)@WnW3zq
z@6|1epH$<vIL902U$+~G<Og^<-F->Z;B;}TAhw0c=B}B(V2tSN*0xZFvy6u5eCT2n
zWkngt)Fl3jy|<XWuEV2k>x$ZdJbid9HHp#SQOj>(pT(7U$Aq9DX$pN@CCb9ThgF&&
z@@`Ip>mx1Uyl>N}@_aW8t=2trLz`bXq9dPZkf*?%`TLW{BHsjZjc<Wd-2LtY%k1;S
z1Y1zSK%%Yf`zuCbc@h>@#nS0W6~kPjftAfpV7z+1vzX91zC!Iz+9BL_n)nnZ;FQsF
zvm<bCC?*ts_2eh|mCk1damJTFlJ*{?m4Wm0)l+U!zRT)M$6IoQr<>%q9?&#NFgz=m
zxGrm207WTJ^rYtXn7=k)Q#Y(YYV_bRumYbKW}yM=)&dha4_#<}`JLDrozaA(2NF3C
ziuF6LO$hOs!d3kHRUH@2iw2)(i1|M3dzyR+FrHuD6e$XCLz&!~?Ge7fqiD7)G1zo-
zK%j>a$;;rJSqIKA@sdl;!-c<c8Z=XYxW!@&;ls*5KLA{hc&+Y??feutO)gs%P~#}D
zDeqMcm=!hA$vIvK+C9VsFwjJCS>4D)#&ED%X2ge>hUb^q%aZw+yLTF-cSmV}n=pC!
z4`;<kPf7;Sot}>$sLkVPa(cwbpeGDP^UsNwd6LW%mi?tz8*tMs88(j1mlusOV&10)
zp6V{e_M_S>k~$@|OfM4B(R)zW8g<A>_Uh7om1v*ih-Jvhy|()`aQahzs|KMpbd!Rq
z_hFqu?XRVx;_d<Yc^5_{RLyL=--d*7yfp_%x&LE{I{CpMy>TcxaN`n-iwc|HL`+LQ
z`=n(`xVcB|WuukrXDdHVO-`{@zkXuPu2qV0?@F3`uI6$9H6Oq@R~l(S(t{o8xAq>;
zJzUPyuR@o0BFH;bY<3PQ<9d{O%f&pV8#*qlUdC)b8DrO1M`hWklATdjfpVXGb_ecK
z^O<PAeCp||FSBlj-3<A8>qk=}`<kugcXa*lgg%(d#?y{zz|NZoUtQu<{q*?d<)_D0
zCqKEl`;gq~a?z9KUdv8ieR=uGRL;ZPp1!};#VeOH9tKV?f`bpS?<pxSZ$p&IdY|Ca
zvx9WJFE6{R8?UW9eRXQ^ll{wmPxmB<Dud=}+(f^hV*%=1H~annWG2{-k;WOo%Oziy
zi=8^KB&c%p8lO6wtuAbr<gV|J?(^eWwm;Iy)pvjNJdGI|>qW$@QkgERPdRb*W$LHi
z-HYz4FYlkfXxa4B+QNt4ztfr)t|orEZ26gQyS<-GU8MAK*J6ixx>^(E?<~Gm@4r$j
zTq$09z7{(V=D7qNz;##mB30H;dHFIpWx)auHnnM|`j<~XJ-fBMJ@ruBvaDa5%kS#?
zi}>-%f8PEueapV~u6GkxU-o`-^Tu~g*H5!%*+=f@Oj`Uj_$_cl?0&;Di7X7*ED>9i
zr>`}6_2p$J?4Ivd@0$DmnC}$x<@c52rKivOcRe_yR#NV)`DrPoh+5U>30Hrf31E<5
z#Mlq2pjNygN`YB*-i1%=JU=B%FPoK6I;+O|C&#{b2Uk6tImM2r!K|eJ>Z8Oj5v6v*
zYm!(ndxA609L$oKbj;aXc-gXJp0#B`Gh=l3yT{FrQCdG`#s1UFP6aM!U#%^Xe3dsT
z`SMwb)#pl@Lhra>b;+vbFFyt^zAVMP?9|nlON|QBe^mYvsob2is%Gs1k3K(*DO>$+
zmb89)n|ZS-X6v3!nxF2!EuWY0RpX#mo&ZLv0lYi&<R+odMXMHHYuUXt(D$;f$Jx`X
zx|+^!ecbib^smwCldjJ;&-=gdQ1z3npC*-?m$>YUjnFyYr|;qSInrw3kv$K*_J4S_
z{`h^}*mAKG%RV0c)WsKi`ZO@@`u*I{{#u)L*PXjXC7a~DfP0AV8M}U4SrvBcXT$3U
zn5o&vVC7-2@XA%wUo2}9`dPShZkV3E-b{_#Z~p+3srfR$$>!?*QyP<OMGn|H-u!gw
z1ozrUyN>x!x&BVGU+?q0m7lhL{J8zseckxkS*KT~`s+<oe>V@f1Wfw4|0MIn-(E6U
zSlLgo#_)c@+-dhB6}*%0|NZWH`AL>%;hW#PpGq%1$Gu|HioJ^ue2I`<wLEii`pv>!
zwKuCyF*#$NilO{szyF-HxG+-zyG!eH^))7%pI+`N|B^iqGZ`hgh@Pm|*8!?H_2l^F
zFWt*eJvlo`)5u_-!?Nnr%!@IT@9;h+1JoHG_(MUC+g^UhnkTt0xk6>9`0zM@WN-v5
zLmWowH3SZC84Wv7u0%94K$nivCRZG6|Mw&Lp25{imvbY5XMQ#yiocpaljnbBTQzN7
z-f7^K2uO?dm4erYZr{Gj4Y>IPcyBJmSx<!T8ee5w^Q->uyj5brEm#M%>kfjvz`&r%
z0=#Nh|Gq0|j0$)kFb8n-FK%BqsMF8DaADbr|MFjN^LBRZXx$GI@O1TaS?83{1ON(x
B0lxqM

literal 0
HcmV?d00001

diff --git a/docs/faq/basics/images/mention-escape.png b/docs/faq/basics/images/mention-escape.png
new file mode 100644
index 0000000000000000000000000000000000000000..92797806155b8396211d6b0014d4f0e8d2aadfa9
GIT binary patch
literal 19611
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

literal 0
HcmV?d00001

diff --git a/docs/faq/basics/images/snowflake.png b/docs/faq/basics/images/snowflake.png
new file mode 100644
index 0000000000000000000000000000000000000000..816a10eee07e156ec4e27ee90a000512b1f12463
GIT binary patch
literal 73062
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
XrU2O)WYlV=ATMnV1NF+Mj{p7##ChBc

literal 0
HcmV?d00001

diff --git a/docs/faq/basics/samples/cast.cs b/docs/faq/basics/samples/cast.cs
new file mode 100644
index 000000000..73ef5237f
--- /dev/null
+++ b/docs/faq/basics/samples/cast.cs
@@ -0,0 +1,15 @@
+public async Task MessageReceivedHandler(SocketMessage msg)
+{
+   // Option 1:
+   // Using the `as` keyword, which will return `null` if the object isn't the desired type.
+   var usermsg = msg as SocketUserMessage;
+   // We bail when the message isn't the desired type.
+   if (msg == null) return;
+   
+   // Option 2:
+   // Using the `is` keyword to cast (C#7 or above only)
+   if (msg is SocketUserMessage usermsg) 
+   {
+      // Do things
+   }
+}
\ No newline at end of file
diff --git a/docs/faq/basics/samples/emoji-others.cs b/docs/faq/basics/samples/emoji-others.cs
new file mode 100644
index 000000000..dd3e6317f
--- /dev/null
+++ b/docs/faq/basics/samples/emoji-others.cs
@@ -0,0 +1,18 @@
+// bail if the message is not a user one (system messages cannot have reactions)
+var usermsg = msg as IUserMessage;
+if (usermsg == null) return;
+
+// standard Unicode emojis
+Emoji emoji = new Emoji("👍");
+// or
+// Emoji emoji = new Emoji("\uD83D\uDC4D");
+
+// custom guild emotes
+Emote emote = Emote.Parse("<:dotnet:232902710280716288>");  
+// using Emote.TryParse may be safer in regards to errors being thrown;
+// please note that the method does not verify if the emote exists,
+// it simply creates the Emote object for you.
+
+// add the reaction to the message
+await usermsg.AddReactionAsync(emoji); 
+await usermsg.AddReactionAsync(emote); 
\ No newline at end of file
diff --git a/docs/faq/basics/samples/emoji-self.cs b/docs/faq/basics/samples/emoji-self.cs
new file mode 100644
index 000000000..cd4cff171
--- /dev/null
+++ b/docs/faq/basics/samples/emoji-self.cs
@@ -0,0 +1,17 @@
+// capture the message you're sending in a variable
+var msg = await channel.SendMessageAsync("This will have reactions added.");
+
+// standard Unicode emojis
+Emoji emoji = new Emoji("👍");
+// or
+// Emoji emoji = new Emoji("\uD83D\uDC4D");
+
+// custom guild emotes
+Emote emote = Emote.Parse("<:dotnet:232902710280716288>");  
+// using Emote.TryParse may be safer in regards to errors being thrown;
+// please note that the method does not verify if the emote exists,
+// it simply creates the Emote object for you.
+
+// add the reaction to the message
+await msg.AddReactionAsync(emoji); 
+await msg.AddReactionAsync(emote); 
\ No newline at end of file
diff --git a/docs/faq/commands/dependency-injection.md b/docs/faq/commands/dependency-injection.md
new file mode 100644
index 000000000..0a5de3e32
--- /dev/null
+++ b/docs/faq/commands/dependency-injection.md
@@ -0,0 +1,54 @@
+---
+uid: FAQ.Commands.DI
+title: Questions about Dependency Injection with Commands
+---
+
+# Dependency-injection-related Questions
+
+In the following section, you will find common questions and answers
+to utilizing dependency injection with @Discord.Commands, as well as
+common troubleshooting steps regarding DI.
+
+## What is a service? Why does my module not hold any data after execution?
+
+In Discord.Net, modules are created similarly to ASP.NET, meaning
+that they have a transient nature; modules are spawned whenever a
+request is received, and are killed from memory when the execution
+finishes. In other words, you cannot store persistent
+data inside a module. Consider using a service if you wish to
+workaround this.
+
+Service is often used to hold data externally so that they persist
+throughout execution. Think of it like a chest that holds
+whatever you throw at it that won't be affected by anything unless
+you want it to. Note that you should also learn Microsoft's
+implementation of [Dependency Injection] \([video]) before proceeding,
+as well as how it works in [Discord.Net](xref:Guides.Commands.DI#usage-in-modules).
+
+A brief example of service and dependency injection can be seen below.
+
+[!code-csharp[DI](samples/DI.cs)]
+
+[Dependency Injection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection
+[video]: https://www.youtube.com/watch?v=QtDTfn8YxXg
+
+## Why is my `CommandService` complaining about a missing dependency?
+
+If you encounter an error similar to `Failed to create MyModule,
+dependency MyExternalDependency was not found.`, you may have
+forgotten to add the external dependency to the dependency container.
+
+Starting from Discord.Net 2.0, all dependencies required by each
+module must be present when the module is loaded into the
+[CommandService]. This means when loading the module, you must pass a
+valid [IServiceProvider] with the dependency loaded before the module
+can be successfully registered.
+
+For example, if your module, `MyModule`, requests a `DatabaseService`
+in its constructor, the `DatabaseService` must be present in the
+[IServiceProvider] when registering `MyModule`.
+
+[!code-csharp[Missing Dependencies](samples/missing-dep.cs)]
+
+[IServiceProvider]: xref:System.IServiceProvider
+[CommandService]: xref:Discord.Commands.CommandService
diff --git a/docs/faq/commands/general.md b/docs/faq/commands/general.md
new file mode 100644
index 000000000..fb6fe39b6
--- /dev/null
+++ b/docs/faq/commands/general.md
@@ -0,0 +1,142 @@
+---
+uid: FAQ.Commands.General
+title: General Questions about Commands
+---
+
+# Command-related Questions
+
+In the following section, you will find commonly asked questions and
+answered regarding general command usage when using @Discord.Commands.
+
+## How can I restrict some of my commands so only specific users can execute them?
+
+Based on how you want to implement the restrictions, you can use the
+built-in [RequireUserPermission] precondition, which allows you to
+restrict the command based on the user's current permissions in the
+guild or channel (*e.g., `GuildPermission.Administrator`,
+`ChannelPermission.ManageMessages`*).
+
+If, however, you wish to restrict the commands based on the user's
+role, you can either create your custom precondition or use
+Joe4evr's [Preconditions Addons] that provides a few custom
+preconditions that aren't provided in the stock library.
+Its source can also be used as an example for creating your
+custom preconditions.
+
+[RequireUserPermission]: xref:Discord.Commands.RequireUserPermissionAttribute
+[Preconditions Addons]: https://github.com/Joe4evr/Discord.Addons/tree/master/src/Discord.Addons.Preconditions
+
+## Why am I getting an error about `Assembly.GetEntryAssembly`?
+
+You may be confusing @Discord.Commands.CommandService.AddModulesAsync*
+with @Discord.Commands.CommandService.AddModuleAsync*. The former
+is used to add modules via the assembly, while the latter is used to
+add a single module.
+
+## What does [Remainder] do in the command signature?
+
+The [RemainderAttribute] leaves the string unparsed, meaning you
+do not have to add quotes around the text for the text to be
+recognized as a single object. Please note that if your method has
+multiple parameters, the remainder attribute can only be applied to
+the last parameter.
+
+[!code-csharp[Remainder](samples/Remainder.cs)]
+
+[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute
+
+## Discord.Net keeps saying that a `MessageReceived` handler is blocking the gateway, what should I do?
+
+By default, the library warns the user about any long-running event
+handler that persists for **more than 3 seconds**. Any event
+handlers that are run on the same thread as the gateway task, the task
+in charge of keeping the connection alive, may block the processing of
+heartbeat, and thus terminating the connection.
+
+In this case, the library detects that a `MessageReceived`
+event handler is blocking the gateway thread. This warning is
+typically associated with the command handler as it listens for that
+particular event. If the command handler is blocking the thread, then
+this **might** mean that you have a long-running command.
+
+> [!NOTE]
+> In rare cases, runtime errors can also cause blockage, usually
+> associated with Mono, which is not supported by this library.
+
+To prevent a long-running command from blocking the gateway
+thread, a flag called [RunMode] is explicitly designed to resolve
+this issue.
+
+There are 2 main `RunMode`s.
+
+1. `RunMode.Sync`
+2. `RunMode.Async`
+
+`Sync` is the default behavior and makes the command to be run on the
+same thread as the gateway one. `Async` will spin the task off to a
+different thread from the gateway one.
+
+> [!IMPORTANT]
+> While specifying `RunMode.Async` allows the command to be spun off
+> to a different thread, keep in mind that by doing so, there will be
+> **potentially unwanted consequences**. Before applying this flag,
+> please consider whether it is necessary to do so.
+>
+> Further details regarding `RunMode.Async` can be found below.
+
+You can set the `RunMode` either by specifying it individually via
+the `CommandAttribute` or by setting the global default with
+the [DefaultRunMode] flag under `CommandServiceConfig`.
+
+# [CommandAttribute](#tab/cmdattrib)
+
+[!code-csharp[Command Attribute](samples/runmode-cmdattrib.cs)]
+
+# [CommandServiceConfig](#tab/cmdconfig)
+
+[!code-csharp[Command Service Config](samples/runmode-cmdconfig.cs)]
+
+***
+
+***
+
+[RunMode]: xref:Discord.Commands.RunMode
+[CommandAttribute]: xref:Discord.Commands.CommandAttribute
+[DefaultRunMode]: xref:Discord.Commands.CommandServiceConfig.DefaultRunMode
+
+## How does `RunMode.Async` work, and why is Discord.Net *not* using it by default?
+
+`RunMode.Async` works by spawning a new `Task` with an unawaited
+[Task.Run], essentially making the task that is used to invoke the
+command task to be finished on a different thread. This design means
+that [ExecuteAsync] will be forced to return a successful
+[ExecuteResult] regardless of the actual execution result.
+
+The following are the known caveats with `RunMode.Async`,
+
+1. You can potentially introduce a race condition.
+2. Unnecessary overhead caused by the [async state machine].
+3. [ExecuteAsync] will immediately return [ExecuteResult] instead of
+ other result types (this is particularly important for those who wish
+ to utilize [RuntimeResult] in 2.0).
+4. Exceptions are swallowed.
+
+However, there are ways to remedy some of these.
+
+For #3, in Discord.Net 2.0, the library introduces a new event called
+[CommandExecuted], which is raised whenever the command is
+**successfully executed**. This event will be raised regardless of
+the `RunMode` type and will return the appropriate execution result.
+
+For #4, exceptions are caught in [CommandService.Log] event under
+[LogMessage.Exception] as [CommandException].
+
+[Task.Run]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task.run
+[async state machine]: https://www.red-gate.com/simple-talk/dotnet/net-tools/c-async-what-is-it-and-how-does-it-work/
+[ExecuteAsync]: xref:Discord.Commands.CommandService.ExecuteAsync*
+[ExecuteResult]: xref:Discord.Commands.ExecuteResult
+[RuntimeResult]: xref:Discord.Commands.RuntimeResult
+[CommandExecuted]: xref:Discord.Commands.CommandService.CommandExecuted
+[CommandService.Log]: xref:Discord.Commands.CommandService.Log
+[LogMessage.Exception]: xref:Discord.LogMessage.Exception*
+[CommandException]: xref:Discord.Commands.CommandException
\ No newline at end of file
diff --git a/docs/faq/commands/samples/DI.cs b/docs/faq/commands/samples/DI.cs
new file mode 100644
index 000000000..ce4454bc2
--- /dev/null
+++ b/docs/faq/commands/samples/DI.cs
@@ -0,0 +1,28 @@
+public class MyService
+{
+	public string MyCoolString { get; set; }
+}
+public class Setup
+{
+	public IServiceProvider BuildProvider() => 
+			new ServiceCollection()
+			.AddSingleton<MyService>()
+			.BuildServiceProvider();
+}
+public class MyModule : ModuleBase<SocketCommandContext>
+{
+	// Inject via public settable prop
+	public MyService MyService { get; set; }
+	
+	// ...or via the module's constructor
+
+	// private readonly MyService _myService;
+	// public MyModule (MyService myService) => _myService = myService;
+	
+	[Command("string")]
+	public Task GetOrSetStringAsync(string input)
+	{
+		if (string.IsNullOrEmpty(_myService.MyCoolString)) _myService.MyCoolString = input;
+		return ReplyAsync(_myService.MyCoolString);
+	}
+}
\ No newline at end of file
diff --git a/docs/faq/commands/samples/Remainder.cs b/docs/faq/commands/samples/Remainder.cs
new file mode 100644
index 000000000..337fb6e45
--- /dev/null
+++ b/docs/faq/commands/samples/Remainder.cs
@@ -0,0 +1,20 @@
+//	Input: 
+//		!echo Coffee Cake
+
+//	Output:
+//		Coffee Cake
+[Command("echo")]
+public Task EchoRemainderAsync([Remainder]string text) => ReplyAsync(text);  
+
+//	Output:
+//		CommandError.BadArgCount
+[Command("echo-hassle")]
+public Task EchoAsync(string text) => ReplyAsync(text);
+
+//	The message would be seen as having multiple parameters, 
+//	while the method only accepts one. 
+//	Wrapping the message in quotes solves this.
+//	This way, the system knows the entire message is to be parsed as a 
+//	single String.
+//	e.g., 
+//		!echo "Coffee Cake"
\ No newline at end of file
diff --git a/docs/faq/commands/samples/missing-dep.cs b/docs/faq/commands/samples/missing-dep.cs
new file mode 100644
index 000000000..d3fb9085b
--- /dev/null
+++ b/docs/faq/commands/samples/missing-dep.cs
@@ -0,0 +1,29 @@
+public class MyModule : ModuleBase<SocketCommandContext>
+{
+    private readonly DatabaseService _dbService;
+    public MyModule(DatabaseService dbService)
+        => _dbService = dbService;
+}
+public class CommandHandler
+{
+    private readonly CommandService _commands;
+    private readonly IServiceProvider _services;
+    public CommandHandler(DiscordSocketClient client)
+    {
+        _services = new ServiceCollection()
+            .AddService<CommandService>()
+            .AddService(client)
+            // We are missing DatabaseService!
+            .BuildServiceProvider();
+    }
+    public async Task RegisterCommandsAsync()
+    {
+        // ...
+        // The method fails here because DatabaseService is a required
+        // dependency and cannot be resolved by the dependency
+        // injection service at runtime since the service is not
+        // registered in this instance of _services.
+        await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
+        // ...
+    }
+}
\ No newline at end of file
diff --git a/docs/faq/commands/samples/runmode-cmdattrib.cs b/docs/faq/commands/samples/runmode-cmdattrib.cs
new file mode 100644
index 000000000..253acc4a9
--- /dev/null
+++ b/docs/faq/commands/samples/runmode-cmdattrib.cs
@@ -0,0 +1,7 @@
+[Command("process", RunMode = RunMode.Async)]
+public async Task ProcessAsync(string input)
+{
+	// Does heavy calculation here.
+	await Task.Delay(TimeSpan.FromMinute(1));
+	await ReplyAsync(input);
+}
\ No newline at end of file
diff --git a/docs/faq/commands/samples/runmode-cmdconfig.cs b/docs/faq/commands/samples/runmode-cmdconfig.cs
new file mode 100644
index 000000000..11d9cc295
--- /dev/null
+++ b/docs/faq/commands/samples/runmode-cmdconfig.cs
@@ -0,0 +1,10 @@
+public class Setup
+{
+	private readonly CommandService _command;
+	
+	public Setup()
+	{
+		var config = new CommandServiceConfig{ DefaultRunMode = RunMode.Async };
+		_command = new CommandService(config);
+	}
+}
\ No newline at end of file
diff --git a/docs/faq/misc/glossary.md b/docs/faq/misc/glossary.md
new file mode 100644
index 000000000..95bdbaa03
--- /dev/null
+++ b/docs/faq/misc/glossary.md
@@ -0,0 +1,82 @@
+---
+uid: FAQ.Glossary
+title: Common Terminologies / Glossary
+---
+
+# Glossary
+
+This is an additional chapter for quick references to various common
+types that you may see within Discord.Net. To see more information
+regarding each type of object, click on the object to navigate
+to our API documentation page where you might find more explanation
+about it.
+
+## Common Types
+
+* A **Guild** ([IGuild]) is an isolated collection of users and
+channels, and are often referred to as "servers".
+	- Example: [Discord API](https://discord.gg/jkrBmQR)
+* A **Channel** ([IChannel]) represents a generic channel.
+	- Example: #dotnet_discord-net
+	- See [Channel Types](#channel-types)
+	
+[IGuild]: xref:Discord.IGuild
+[IChannel]: xref:Discord.IChannel
+
+## Channel Types
+
+### Message Channels
+* A **Text Channel** ([ITextChannel]) is a message channel from a
+Guild.
+* A **DM Channel** ([IDMChannel]) is a message channel from a DM.
+* A **Group Channel** ([IGroupChannel]) is a message channel from a
+Group.
+	- This is rarely used due to the bot's inability to join groups.
+* A **Private Channel** ([IPrivateChannel]) is a DM or a Group.
+* A **Message Channel** ([IMessageChannel]) can be any of the above.
+
+### Misc Channels
+* A **Guild Channel** ([IGuildChannel]) is a guild channel in a guild.
+	- This can be any channels that may exist in a guild.
+* A **Voice Channel** ([IVoiceChannel]) is a voice channel in a guild.
+* A **Category Channel** ([ICategoryChannel]) (2.0+) is a category that
+holds one or more sub-channels.
+* A **Nested Channel** ([INestedChannel]) (2.0+) is a channel that can
+exist under a category.
+
+[INestedChannel]: xref:Discord.INestedChannel
+[IGuildChannel]: xref:Discord.IGuildChannel
+[IMessageChannel]: xref:Discord.IMessageChannel
+[ITextChannel]: xref:Discord.ITextChannel
+[IGroupChannel]: xref:Discord.IGroupChannel
+[IDMChannel]: xref:Discord.IDMChannel
+[IPrivateChannel]: xref:Discord.IPrivateChannel
+[IVoiceChannel]: xref:Discord.IVoiceChannel
+[ICategoryChannel]: xref:Discord.ICategoryChannel
+
+## Emoji Types
+
+* An **Emote** ([Emote]) is a custom emote from a guild.
+	- Example: `<:dotnet:232902710280716288>`
+* An **Emoji** ([Emoji]) is a Unicode emoji.
+	- Example: `👍`
+
+[Emote]: xref:Discord.Emote
+[Emoji]: xref:Discord.Emoji
+
+## Activity Types
+
+* A **Game** ([Game]) refers to a user's game activity.
+* A **Rich Presence** ([RichGame]) refers to a user's detailed
+gameplay status.
+	- Visit [Rich Presence Intro] on Discord docs for more info.
+* A **Streaming Status** ([StreamingGame]) refers to user's activity
+for streaming on services such as Twitch.
+* A **Spotify Status** ([SpotifyGame]) (2.0+) refers to a user's
+activity for listening to a song on Spotify.
+
+[Game]: xref:Discord.Game
+[RichGame]: xref:Discord.RichGame
+[StreamingGame]: xref:Discord.StreamingGame
+[SpotifyGame]: xref:Discord.SpotifyGame
+[Rich Presence Intro]: https://discordapp.com/developers/docs/rich-presence/best-practices
\ No newline at end of file
diff --git a/docs/faq/misc/legacy.md b/docs/faq/misc/legacy.md
new file mode 100644
index 000000000..5931579d3
--- /dev/null
+++ b/docs/faq/misc/legacy.md
@@ -0,0 +1,29 @@
+---
+uid: FAQ.Legacy
+title: Questions about Legacy Versions
+---
+
+# Legacy Questions
+
+This section refers to legacy library-related questions that do not
+apply to the latest or recent version of the Discord.Net library.
+
+## X, Y, Z does not work! It doesn't return a valid value anymore.
+
+If you are currently using an older version of the stable branch,
+please upgrade to the latest pre-release version to ensure maximum
+compatibility. Several features may be broken in older
+versions and will likely not be fixed in the version branch due to
+their breaking nature.
+
+Visit the repo's [release tag] to see the latest public pre-release.
+
+[release tag]: https://github.com/RogueException/Discord.Net/releases
+
+## I came from an earlier version of Discord.Net 1.0, and DependencyMap doesn't seem to exist anymore in the later revision? What happened to it?
+
+The `DependencyMap` has been replaced with Microsoft's
+[DependencyInjection] Abstractions. An example usage can be seen
+[here](https://github.com/foxbot/DiscordBotBase/blob/csharp/src/DiscordBot/Program.cs#L36).
+
+[DependencyInjection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection
\ No newline at end of file
diff --git a/docs/faq/toc.yml b/docs/faq/toc.yml
new file mode 100644
index 000000000..393e948f6
--- /dev/null
+++ b/docs/faq/toc.yml
@@ -0,0 +1,18 @@
+- name: Basic Concepts
+  items:
+    - name: Getting Started
+      topicUid: FAQ.Basics.GetStarted
+    - name: Basic Operations
+      topicUid: FAQ.Basics.BasicOp
+    - name: Client Basics
+      topicUid: FAQ.Basics.ClientBasics
+- name: Commands
+  items: 
+    - name: General
+      topicUid: FAQ.Commands.General
+    - name: Dependency Injection
+      topicUid: FAQ.Commands.DI
+- name: Glossary
+  topicUid: FAQ.Glossary
+- name: Legacy or Upgrade
+  topicUid: FAQ.Legacy
diff --git a/docs/filterConfig.yml b/docs/filterConfig.yml
index 715b39606..410a80d25 100644
--- a/docs/filterConfig.yml
+++ b/docs/filterConfig.yml
@@ -1,11 +1,7 @@
 apiRules:
 - exclude:
-    uidRegex: ^Discord\.API$
+    uidRegex: ^Discord\.Net\..*$
+    type: Namespace
 - exclude:
-    uidRegex: ^Discord\.API.*$
-- exclude:
-    uidRegex: ^Discord\.Net\.Converters$
-- exclude:
-    uidRegex: ^Discord\.Net.*$
-- exclude:
-    uidRegex: ^RegexAnalyzer$
\ No newline at end of file
+    uidRegex: ^Discord\.Analyzers$
+    type: Namespace
\ No newline at end of file
diff --git a/docs/guides/commands/commands.md b/docs/guides/commands/commands.md
deleted file mode 100644
index 2b012af0e..000000000
--- a/docs/guides/commands/commands.md
+++ /dev/null
@@ -1,343 +0,0 @@
-# The Command Service
-
-[Discord.Commands](xref:Discord.Commands) provides an Attribute-based
-command parser.
-
-## Setup
-
-To use Commands, you must create a [Command Service] and a Command
-Handler.
-
-Included below is a very barebone Command Handler. You can extend your
-Command Handler as much as you like; however, the below is the bare
-minimum.
-
-The `CommandService` will optionally accept a [CommandServiceConfig],
-which _does_ set a few default values for you. It is recommended to
-look over the properties in [CommandServiceConfig] and their default
-values.
-
-[!code-csharp[Command Handler](samples/command_handler.cs)]
-
-[Command Service]: xref:Discord.Commands.CommandService
-[CommandServiceConfig]: xref:Discord.Commands.CommandServiceConfig
-
-## With Attributes
-
-In 1.0, Commands can be defined ahead of time with attributes, or at
-runtime with builders.
-
-For most bots, ahead-of-time Commands should be all you need, and this
-is the recommended method of defining Commands.
-
-### Modules
-
-The first step to creating Commands is to create a _module_.
-
-A Module is an organizational pattern that allows you to write your
-Commands in different classes and have them automatically loaded.
-
-Discord.Net's implementation of Modules is influenced heavily from
-ASP.NET Core's Controller pattern. This means that the lifetime of a
-module instance is only as long as the Command is being invoked.
-
-**Avoid using long-running code** in your modules wherever possible.
-You should **not** be implementing very much logic into your modules,
-instead, outsource to a service for that.
-
-If you are unfamiliar with Inversion of Control, it is recommended to
-read the MSDN article on [IoC] and [Dependency Injection].
-
-To begin, create a new class somewhere in your project and inherit the
-class from [ModuleBase]. This class **must** be `public`.
-
->[!NOTE]
->[ModuleBase] is an _abstract_ class, meaning that you may extend it
->or override it as you see fit. Your module may inherit from any
->extension of ModuleBase.
-
-By now, your module should look like this:
-
-[!code-csharp[Empty Module](samples/empty-module.cs)]
-
-[IoC]: https://msdn.microsoft.com/en-us/library/ff921087.aspx
-[Dependency Injection]: https://msdn.microsoft.com/en-us/library/ff921152.aspx
-[ModuleBase]: xref:Discord.Commands.ModuleBase`1
-
-### Adding Commands
-
-The next step to creating Commands is actually creating the Commands.
-
-To create a Command, add a method to your module of type `Task`.
-Typically, you will want to mark this method as `async`, although it
-is not required.
-
-Adding parameters to a Command is done by adding parameters to the
-parent Task.
-
-For example, to take an integer as an argument from the user, add `int
-arg`; to take a user as an argument from the user, add `IUser user`.
-In 1.0, a Command can accept nearly any type of argument; a full list
-of types that are parsed by default can be found in the below section
-on _Type Readers_.
-
-Parameters, by default, are always required. To make a parameter
-optional, give it a default value. To accept a comma-separated list,
-set the parameter to `params Type[]`.
-
-Should a parameter include spaces, it **must** be wrapped in quotes.
-For example, for a Command with a parameter `string food`, you would
-execute it with `!favoritefood "Key Lime Pie"`.
-
-If you would like a parameter to parse until the end of a Command,
-flag the parameter with the [RemainderAttribute]. This will allow a
-user to invoke a Command without wrapping a parameter in quotes.
-
-Finally, flag your Command with the [CommandAttribute]. (you must
-specify a name for this Command, except for when it is part of a
-Module Group - see below)
-
-[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute
-[CommandAttribute]: xref:Discord.Commands.CommandAttribute
-
-### Command Overloads
-
-You may add overloads to your Commands, and the Command parser will
-automatically pick up on it.
-
-If for whatever reason, you have two Commands which are ambiguous to
-each other, you may use the @Discord.Commands.PriorityAttribute to
-specify which should be tested before the other.
-
-The `Priority` attributes are sorted in ascending order; the higher
-priority will be called first.
-
-### Command Context
-
-Every Command can access the execution context through the [Context]
-property on [ModuleBase]. `ICommandContext` allows you to access the
-message, channel, guild, and user that the Command was invoked from,
-as well as the underlying Discord client that the Command was invoked
-from.
-
-Different types of Contexts may be specified using the generic variant
-of [ModuleBase]. When using a [SocketCommandContext], for example, the
-properties on this context will already be Socket entities, so you
-will not need to cast them.
-
-To reply to messages, you may also invoke [ReplyAsync], instead of
-accessing the channel through the [Context] and sending a message.
-
-> [!WARNING]
->Contexts should **NOT** be mixed! You cannot have one module that
->uses `CommandContext` and another that uses `SocketCommandContext`.
-
-[Context]: xref:Discord.Commands.ModuleBase`1#Discord_Commands_ModuleBase_1_Context
-[SocketCommandContext]: xref:Discord.Commands.SocketCommandContext
-[ReplyAsync]: xref:Discord.Commands.ModuleBase`1#Discord_Commands_ModuleBase_1_ReplyAsync_System_String_System_Boolean_Discord_Embed_Discord_RequestOptions_
-
-### Example Module
-
-At this point, your module should look comparable to this example:
-[!code-csharp[Example Module](samples/module.cs)]
-
-#### Loading Modules Automatically
-
-The Command Service can automatically discover all classes in an
-Assembly that inherit [ModuleBase] and load them.
-
-To opt a module out of auto-loading, flag it with
-[DontAutoLoadAttribute].
-
-Invoke [CommandService.AddModulesAsync] to discover modules and
-install them.
-
-[DontAutoLoadAttribute]: xref:Discord.Commands.DontAutoLoadAttribute
-[CommandService.AddModulesAsync]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_AddModulesAsync_Assembly_
-
-#### Loading Modules Manually
-
-To manually load a module, invoke [CommandService.AddModuleAsync] by
-passing in the generic type of your module and optionally, a
-dependency map.
-
-[CommandService.AddModuleAsync]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_AddModuleAsync__1
-
-### Module Constructors
-
-Modules are constructed using Dependency Injection. Any parameters
-that are placed in the Module's constructor must be injected into an
-@System.IServiceProvider first. Alternatively, you may accept an
-`IServiceProvider` as an argument and extract services yourself.
-
-### Module Properties
-
-Modules with `public` settable properties will have the dependencies
-injected after the construction of the Module.
-
-### Module Groups
-
-Module Groups allow you to create a module where Commands are
-prefixed. To create a group, flag a module with the
-@Discord.Commands.GroupAttribute.
-
-Module groups also allow you to create **nameless Commands**, where
-the [CommandAttribute] is configured with no name. In this case, the
-Command will inherit the name of the group it belongs to.
-
-### Submodules
-
-Submodules are Modules that reside within another one. Typically,
-submodules are used to create nested groups (although not required to
-create nested groups).
-
-[!code-csharp[Groups and Submodules](samples/groups.cs)]
-
-## With Builders
-
-**TODO**
-
-## Dependency Injection
-
-The Command Service is bundled with a very barebone Dependency
-Injection service for your convenience. It is recommended that you use
-DI when writing your modules.
-
-### Setup
-
-First, you need to create an @System.IServiceProvider; you may create
-your own one if you wish.
-
-Next, add the dependencies that your modules will use to the map.
-
-Finally, pass the map into the `LoadAssembly` method. Your modules
-will be automatically loaded with this dependency map.
-
-[!code-csharp[IServiceProvider Setup](samples/dependency_map_setup.cs)]
-
-### Usage in Modules
-
-In the constructor of your Module, any parameters will be filled in by
-the @System.IServiceProvider that you've passed into `LoadAssembly`.
-
-Any publicly settable properties will also be filled in the same
-manner.
-
->[!NOTE]
-> Annotating a property with a [DontInjectAttribute] attribute will prevent the
-property from being injected.
-
->[!NOTE]
->If you accept `CommandService` or `IServiceProvider` as a parameter
-in your constructor or as an injectable property, these entries will
-be filled by the `CommandService` that the Module is loaded from and
-the `ServiceProvider` that is passed into it respectively.
-
-[!code-csharp[ServiceProvider in Modules](samples/dependency_module.cs)]
-
-[DontInjectAttribute]: xref:Discord.Commands.DontInjectAttribute
-
-# Preconditions
-
-Precondition serve as a permissions system for your Commands. Keep in
-mind, however, that they are not limited to _just_ permissions and can
-be as complex as you want them to be.
-
->[!NOTE]
->There are two types of Preconditions.
-[PreconditionAttribute] can be applied to Modules, Groups, or Commands;
-[ParameterPreconditionAttribute] can be applied to Parameters.
-
-[PreconditionAttribute]: xref:Discord.Commands.PreconditionAttribute
-[ParameterPreconditionAttribute]: xref:Discord.Commands.ParameterPreconditionAttribute
-
-## Bundled Preconditions
-
-Commands ship with four bundled Preconditions; you may view their
-usages on their respective API pages.
-
-- @Discord.Commands.RequireContextAttribute
-- @Discord.Commands.RequireOwnerAttribute
-- @Discord.Commands.RequireBotPermissionAttribute
-- @Discord.Commands.RequireUserPermissionAttribute
-
-## Custom Preconditions
-
-To write your own Precondition, create a new class that inherits from
-either [PreconditionAttribute] or [ParameterPreconditionAttribute]
-depending on your use.
-
-In order for your Precondition to function, you will need to override
-the [CheckPermissions] method.
-
-Your IDE should provide an option to fill this in for you.
-
-If the context meets the required parameters, return 
-[PreconditionResult.FromSuccess], otherwise return 
-[PreconditionResult.FromError] and include an error message if 
-necessary.
-
-[!code-csharp[Custom Precondition](samples/require_owner.cs)]
-
-[CheckPermissions]: xref:Discord.Commands.PreconditionAttribute#Discord_Commands_PreconditionAttribute_CheckPermissions_Discord_Commands_ICommandContext_Discord_Commands_CommandInfo_IServiceProvider_
-[PreconditionResult.FromSuccess]: xref:Discord.Commands.PreconditionResult#Discord_Commands_PreconditionResult_FromSuccess
-[PreconditionResult.FromError]: xref:Discord.Commands.PreconditionResult#Discord_Commands_PreconditionResult_FromError_System_String_
-
-# Type Readers
-
-Type Readers allow you to parse different types of arguments in
-your commands.
-
-By default, the following Types are supported arguments:
-
-- bool
-- char
-- sbyte/byte
-- ushort/short
-- uint/int
-- ulong/long
-- float, double, decimal
-- string
-- DateTime/DateTimeOffset/TimeSpan
-- IMessage/IUserMessage
-- IChannel/IGuildChannel/ITextChannel/IVoiceChannel/IGroupChannel
-- IUser/IGuildUser/IGroupUser
-- IRole
-
-### Creating a Type Readers
-
-To create a `TypeReader`, create a new class that imports @Discord and
-@Discord.Commands and ensure the class inherits from
-@Discord.Commands.TypeReader.
-
-Next, satisfy the `TypeReader` class by overriding the [Read] method.
-
->[!NOTE]
->In many cases, Visual Studio can fill this in for you, using the
->"Implement Abstract Class" IntelliSense hint.
-
-Inside this task, add whatever logic you need to parse the input
-string.
-
-If you are able to successfully parse the input, return 
-[TypeReaderResult.FromSuccess] with the parsed input, otherwise return
-[TypeReaderResult.FromError] and include an error message if 
-necessary.
-
-[TypeReaderResult]: xref:Discord.Commands.TypeReaderResult
-[TypeReaderResult.FromSuccess]: xref:Discord.Commands.TypeReaderResult#Discord_Commands_TypeReaderResult_FromSuccess_Discord_Commands_TypeReaderValue_
-[TypeReaderResult.FromError]: xref:Discord.Commands.TypeReaderResult#Discord_Commands_TypeReaderResult_FromError_Discord_Commands_CommandError_System_String_
-[Read]: xref:Discord.Commands.TypeReader#Discord_Commands_TypeReader_Read_Discord_Commands_ICommandContext_System_String_IServiceProvider_
-
-#### Sample
-
-[!code-csharp[TypeReaders](samples/typereader.cs)]
-
-### Installing TypeReaders
-
-TypeReaders are not automatically discovered by the Command Service
-and must be explicitly added.
-
-To install a TypeReader, invoke [CommandService.AddTypeReader].
-
-[CommandService.AddTypeReader]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_AddTypeReader__1_Discord_Commands_TypeReader_
diff --git a/docs/guides/commands/dependency-injection.md b/docs/guides/commands/dependency-injection.md
new file mode 100644
index 000000000..5dc5b02d2
--- /dev/null
+++ b/docs/guides/commands/dependency-injection.md
@@ -0,0 +1,47 @@
+---
+uid: Guides.Commands.DI
+title: Dependency Injection
+---
+
+# Dependency Injection
+
+The Command Service is bundled with a very barebone Dependency
+Injection service for your convenience. It is recommended that you use
+DI when writing your modules.
+
+## Setup
+
+1. Create a @Microsoft.Extensions.DependencyInjection.ServiceCollection.
+2. Add the dependencies to the service collection that you wish
+ to use in the modules.
+3. Build the service collection into a service provider.
+4. Pass the service collection into @Discord.Commands.CommandService.AddModulesAsync* / @Discord.Commands.CommandService.AddModuleAsync* , @Discord.Commands.CommandService.ExecuteAsync* .
+
+### Example - Setting up Injection
+
+[!code-csharp[IServiceProvider Setup](samples/dependency-injection/dependency_map_setup.cs)]
+
+## Usage in Modules
+
+In the constructor of your module, any parameters will be filled in by
+the @System.IServiceProvider that you've passed.
+
+Any publicly settable properties will also be filled in the same
+manner.
+
+> [!NOTE]
+> Annotating a property with a [DontInjectAttribute] attribute will
+> prevent the property from being injected.
+
+> [!NOTE]
+> If you accept `CommandService` or `IServiceProvider` as a parameter
+> in your constructor or as an injectable property, these entries will
+> be filled by the `CommandService` that the module is loaded from and
+> the `IServiceProvider` that is passed into it respectively.
+
+### Example - Injection in Modules
+
+[!code-csharp[Injection Modules](samples/dependency-injection/dependency_module.cs)]
+[!code-csharp[Disallow Dependency Injection](samples/dependency-injection/dependency_module_noinject.cs)]
+
+[DontInjectAttribute]: xref:Discord.Commands.DontInjectAttribute
\ No newline at end of file
diff --git a/docs/guides/commands/intro.md b/docs/guides/commands/intro.md
new file mode 100644
index 000000000..c815175bd
--- /dev/null
+++ b/docs/guides/commands/intro.md
@@ -0,0 +1,221 @@
+---
+uid: Guides.Commands.Intro
+title: Introduction to Command Service
+---
+
+# The Command Service
+
+[Discord.Commands](xref:Discord.Commands) provides an attribute-based
+command parser.
+
+## Get Started
+
+To use commands, you must create a [Command Service] and a command
+handler.
+
+Included below is a barebone command handler. You can extend your
+command handler as much as you like; however, the below is the bare
+minimum.
+
+> [!NOTE]
+> The `CommandService` will optionally accept a [CommandServiceConfig],
+> which *does* set a few default values for you. It is recommended to
+> look over the properties in [CommandServiceConfig] and their default
+> values.
+
+[!code-csharp[Command Handler](samples/intro/command_handler.cs)]
+
+[Command Service]: xref:Discord.Commands.CommandService
+[CommandServiceConfig]: xref:Discord.Commands.CommandServiceConfig
+
+## With Attributes
+
+Starting from 1.0, commands can be defined ahead of time with
+attributes, or at runtime with builders.
+
+For most bots, ahead-of-time commands should be all you need, and this
+is the recommended method of defining commands.
+
+### Modules
+
+The first step to creating commands is to create a _module_.
+
+A module is an organizational pattern that allows you to write your
+commands in different classes and have them automatically loaded.
+
+Discord.Net's implementation of "modules" is influenced heavily by the
+ASP.NET Core's Controller pattern. This means that the lifetime of a
+module instance is only as long as the command is being invoked.
+
+Before we create a module, it is **crucial** for you to remember that
+in order to create a module and have it automatically discovered,
+your module must:
+
+* Be public
+* Inherit [ModuleBase]
+
+By now, your module should look like this:
+
+[!code-csharp[Empty Module](samples/intro/empty-module.cs)]
+
+> [!NOTE]
+> [ModuleBase] is an `abstract` class, meaning that you may extend it
+> or override it as you see fit. Your module may inherit from any
+> extension of ModuleBase.
+
+[IoC]: https://msdn.microsoft.com/en-us/library/ff921087.aspx
+[Dependency Injection]: https://msdn.microsoft.com/en-us/library/ff921152.aspx
+[ModuleBase]: xref:Discord.Commands.ModuleBase`1
+
+### Adding/Creating Commands
+
+> [!WARNING]
+> **Avoid using long-running code** in your modules wherever possible.
+> You should **not** be implementing very much logic into your
+> modules, instead, outsource to a service for that.
+>
+> If you are unfamiliar with Inversion of Control, it is recommended
+> to read the MSDN article on [IoC] and [Dependency Injection].
+
+The next step to creating commands is actually creating the commands.
+
+For a command to be valid, it **must** have a return type of `Task`
+or `Task<RuntimeResult>`. Typically, you might want to mark this
+method as `async`, although it is not required.
+
+Then, flag your command with the [CommandAttribute]. Note that you must
+specify a name for this command, except for when it is part of a
+[Module Group](#module-groups).
+
+### Command Parameters
+
+Adding parameters to a command is done by adding parameters to the
+parent `Task`.
+
+For example:
+
+* To take an integer as an argument from the user, add `int num`.
+* To take a user as an argument from the user, add `IUser user`.
+* ...etc.
+
+Starting from 1.0, a command can accept nearly any type of argument;
+a full list of types that are parsed by default can
+be found in @Guides.Commands.TypeReaders.
+
+[CommandAttribute]: xref:Discord.Commands.CommandAttribute
+
+#### Optional Parameters
+
+Parameters, by default, are always required. To make a parameter
+optional, give it a default value (i.e., `int num = 0`).
+
+#### Parameters with Spaces
+
+To accept a comma-separated list, set the parameter to `params Type[]`.
+
+Should a parameter include spaces, the parameter **must** be
+wrapped in quotes. For example, for a command with a parameter
+`string food`, you would execute it with
+`!favoritefood "Key Lime Pie"`.
+
+If you would like a parameter to parse until the end of a command,
+flag the parameter with the [RemainderAttribute]. This will
+allow a user to invoke a command without wrapping a
+parameter in quotes.
+
+[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute
+
+### Command Overloads
+
+You may add overloads to your commands, and the command parser will
+automatically pick up on it.
+
+If, for whatever reason, you have two commands which are ambiguous to
+each other, you may use the @Discord.Commands.PriorityAttribute to
+specify which should be tested before the other.
+
+The `Priority` attributes are sorted in ascending order; the higher
+priority will be called first.
+
+### Command Context
+
+Every command can access the execution context through the [Context]
+property on [ModuleBase]. `ICommandContext` allows you to access the
+message, channel, guild, user, and the underlying Discord client
+that the command was invoked from.
+
+Different types of `Context` may be specified using the generic variant
+of [ModuleBase]. When using a [SocketCommandContext], for example, the
+properties on this context will already be Socket entities, so you
+will not need to cast them.
+
+To reply to messages, you may also invoke [ReplyAsync], instead of
+accessing the channel through the [Context] and sending a message.
+
+> [!WARNING]
+> Contexts should **NOT** be mixed! You cannot have one module that
+> uses `CommandContext` and another that uses `SocketCommandContext`.
+
+[Context]: xref:Discord.Commands.ModuleBase`1.Context
+[SocketCommandContext]: xref:Discord.Commands.SocketCommandContext
+[ReplyAsync]: xref:Discord.Commands.ModuleBase`1.ReplyAsync*
+
+> [!TIP]
+> At this point, your module should look comparable to this example:
+> [!code-csharp[Example Module](samples/intro/module.cs)]
+
+#### Loading Modules Automatically
+
+The Command Service can automatically discover all classes in an
+`Assembly` that inherit [ModuleBase] and load them. Invoke
+[CommandService.AddModulesAsync] to discover modules and
+install them.
+
+To opt a module out of auto-loading, flag it with
+[DontAutoLoadAttribute].
+
+[DontAutoLoadAttribute]: xref:Discord.Commands.DontAutoLoadAttribute
+[CommandService.AddModulesAsync]: xref:Discord.Commands.CommandService.AddModulesAsync*
+
+#### Loading Modules Manually
+
+To manually load a module, invoke [CommandService.AddModuleAsync] by
+passing in the generic type of your module and optionally, a
+service provider.
+
+[CommandService.AddModuleAsync]: xref:Discord.Commands.CommandService.AddModuleAsync*
+
+### Module Constructors
+
+Modules are constructed using @Guides.Commands.DI. Any parameters
+that are placed in the Module's constructor must be injected into an
+@System.IServiceProvider first.
+
+> [!TIP]
+> Alternatively, you may accept an
+> `IServiceProvider` as an argument and extract services yourself,
+> although this is discouraged.
+
+### Module Properties
+
+Modules with `public` settable properties will have the dependencies
+injected after the construction of the module. See @Guides.Commands.DI
+to learn more.
+
+### Module Groups
+
+Module Groups allow you to create a module where commands are
+prefixed. To create a group, flag a module with the
+@Discord.Commands.GroupAttribute.
+
+Module Groups also allow you to create **nameless Commands**, where
+the [CommandAttribute] is configured with no name. In this case, the
+command will inherit the name of the group it belongs to.
+
+### Submodules
+
+Submodules are "modules" that reside within another one. Typically,
+submodules are used to create nested groups (although not required to
+create nested groups).
+
+[!code-csharp[Groups and Submodules](samples/intro/groups.cs)]
\ No newline at end of file
diff --git a/docs/guides/commands/post-execution.md b/docs/guides/commands/post-execution.md
new file mode 100644
index 000000000..28f63659b
--- /dev/null
+++ b/docs/guides/commands/post-execution.md
@@ -0,0 +1,122 @@
+---
+uid: Guides.Commands.PostExecution
+title: Post-command Execution Handling
+---
+
+# Post-execution Handling for Commands
+
+When developing commands, you may want to consider building a
+post-execution handling system so you can have finer control
+over commands. Discord.Net offers several post-execution workflows
+for you to work with.
+
+If you recall, in the [Command Guide], we have shown the following
+example for executing and handling commands,
+
+[!code[Command Handler](samples/intro/command_handler.cs)]
+
+You may notice that after we perform [ExecuteAsync], we store the
+result and print it to the chat, essentially creating the most
+fundamental form of a post-execution handler.
+
+With this in mind, we could start doing things like the following,
+
+[!code[Basic Command Handler](samples/post-execution/post-execution_basic.cs)]
+
+However, this may not always be preferred, because you are
+creating your post-execution logic *with* the essential command
+handler. This design could lead to messy code and could potentially
+be a violation of the SRP (Single Responsibility Principle).
+
+Another major issue is if your command is marked with
+`RunMode.Async`, [ExecuteAsync] will **always** return a successful
+[ExecuteResult] instead of the actual result. You can learn more
+about the impact in the [FAQ](xref:FAQ.Commands.General).
+
+## CommandExecuted Event
+
+Enter [CommandExecuted], an event that was introduced in
+Discord.Net 2.0. This event is raised whenever a command is
+successfully executed **without any run-time exceptions** or **any
+parsing or precondition failure**. This means this event can be
+used to streamline your post-execution design, and the best thing
+about this event is that it is not prone to `RunMode.Async`'s
+[ExecuteAsync] drawbacks.
+
+Thus, we can begin working on code such as:
+
+[!code[CommandExecuted demo](samples/post-execution/command_executed_demo.cs)]
+
+So now we have a streamlined post-execution pipeline, great! What's
+next? We can take this further by using [RuntimeResult].
+
+### RuntimeResult
+
+`RuntimeResult` was initially introduced in 1.0 to allow
+developers to centralize their command result logic.
+In other words, it is a result type that is designed to be
+returned when the command has finished its execution.
+
+However, it wasn't widely adopted due to the aforementioned
+[ExecuteAsync] drawback. Since we now have access to a proper
+result-handler via the [CommandExecuted] event, we can start
+making use of this class.
+
+The best way to make use of it is to create your version of
+`RuntimeResult`. You can achieve this by inheriting the `RuntimeResult`
+class.
+
+The following creates a bare-minimum required for a sub-class
+of `RuntimeResult`,
+
+[!code[Base Use](samples/post-execution/customresult_base.cs)]
+
+The sky is the limit from here. You can add any additional information
+you would like regarding the execution result.
+
+For example, you may want to add your result type or other
+helpful information regarding the execution, or something
+simple like static methods to help you create return types easily.
+
+[!code[Extended Use](samples/post-execution/customresult_extended.cs)]
+
+After you're done creating your [RuntimeResult], you can
+implement it in your command by marking the command return type to
+`Task<RuntimeResult>`.
+
+> [!NOTE]
+> You must mark the return type as `Task<RuntimeResult>` instead of
+> `Task<MyCustomResult>`. Only the former will be picked up when
+> building the module.
+
+Here's an example of a command that utilizes such logic:
+
+[!code[Usage](samples/post-execution/customresult_usage.cs)]
+
+And now we can check for it in our [CommandExecuted] handler:
+
+[!code[Usage](samples/post-execution/command_executed_adv_demo.cs)]
+
+## CommandService.Log Event
+
+We have so far covered the handling of various result types, but we
+have not talked about what to do if the command enters a catastrophic
+failure (i.e., exceptions). To resolve this, we can make use of the
+[CommandService.Log] event.
+
+All exceptions thrown during a command execution are caught and sent
+to the Log event under the [LogMessage.Exception] property
+as a [CommandException] type. The [CommandException] class allows
+us to access the exception thrown, as well as the context
+of the command.
+
+[!code[Logger Sample](samples/post-execution/command_exception_log.cs)]
+
+[CommandException]: xref:Discord.Commands.CommandException
+[LogMessage.Exception]: xref:Discord.LogMessage.Exception
+[CommandService.Log]: xref:Discord.Commands.CommandService.Log
+[RuntimeResult]: xref:Discord.Commands.RuntimeResult
+[CommandExecuted]: xref:Discord.Commands.CommandService.CommandExecuted
+[ExecuteAsync]: xref:Discord.Commands.CommandService.ExecuteAsync*
+[ExecuteResult]: xref:Discord.Commands.ExecuteResult
+[Command Guide]: xref:Guides.Commands.Intro
\ No newline at end of file
diff --git a/docs/guides/commands/preconditions.md b/docs/guides/commands/preconditions.md
new file mode 100644
index 000000000..44b10c513
--- /dev/null
+++ b/docs/guides/commands/preconditions.md
@@ -0,0 +1,83 @@
+---
+uid: Guides.Commands.Preconditions
+title: Preconditions
+---
+
+# Preconditions
+
+Preconditions serve as a permissions system for your Commands. Keep in
+mind, however, that they are not limited to _just_ permissions and can
+be as complex as you want them to be.
+
+There are two types of Preconditions you can use:
+
+* [PreconditionAttribute] can be applied to Modules, Groups, or Commands.
+* [ParameterPreconditionAttribute] can be applied to Parameters.
+
+You may visit their respective API documentation to find out more.
+
+[PreconditionAttribute]: xref:Discord.Commands.PreconditionAttribute
+[ParameterPreconditionAttribute]: xref:Discord.Commands.ParameterPreconditionAttribute
+
+## Bundled Preconditions
+
+@Discord.Commands ships with several bundled Preconditions for you
+to use.
+
+* @Discord.Commands.RequireContextAttribute
+* @Discord.Commands.RequireOwnerAttribute
+* @Discord.Commands.RequireBotPermissionAttribute
+* @Discord.Commands.RequireUserPermissionAttribute
+* @Discord.Commands.RequireNsfwAttribute
+
+## Using Preconditions
+
+To use a precondition, simply apply any valid precondition candidate to
+a command method signature as an attribute.
+
+### Example - Using a Precondition
+
+[!code-csharp[Precondition usage](samples/preconditions/precondition_usage.cs)]
+
+## ORing Preconditions
+
+When writing commands, you may want to allow some of them to be
+executed when only some of the precondition checks are passed.
+
+This is where the [Group] property of a precondition attribute comes in
+handy. By assigning two or more preconditions to a group, the command
+system will allow the command to be executed when one of the
+precondition passes.
+
+### Example - ORing Preconditions
+
+[!code-csharp[OR Precondition](samples/preconditions/group_precondition.cs)]
+
+[Group]: xref:Discord.Commands.PreconditionAttribute.Group
+
+## Custom Preconditions
+
+To write your own Precondition, create a new class that inherits from
+either [PreconditionAttribute] or [ParameterPreconditionAttribute]
+depending on your use.
+
+In order for your Precondition to function, you will need to override
+the [CheckPermissionsAsync] method.
+
+If the context meets the required parameters, return
+[PreconditionResult.FromSuccess], otherwise return
+[PreconditionResult.FromError] and include an error message if
+necessary.
+
+> [!NOTE]
+> Visual Studio can help you implement missing members
+> from the abstract class by using the "Implement Abstract Class"
+> IntelliSense hint.
+
+### Example - Creating a Custom Precondition
+
+[!code-csharp[Custom Precondition](samples/preconditions/require_owner.cs)]
+
+[CheckPermissionsAsync]: xref:Discord.Commands.PreconditionAttribute.CheckPermissionsAsync*
+[PreconditionResult.FromSuccess]: xref:Discord.Commands.PreconditionResult.FromSuccess*
+[PreconditionResult.FromError]: xref:Discord.Commands.PreconditionResult.FromError*
diff --git a/docs/guides/commands/samples/command_handler.cs b/docs/guides/commands/samples/command_handler.cs
deleted file mode 100644
index da2453aa8..000000000
--- a/docs/guides/commands/samples/command_handler.cs
+++ /dev/null
@@ -1,63 +0,0 @@
-using System;
-using System.Threading.Tasks;
-using System.Reflection;
-using Discord;
-using Discord.WebSocket;
-using Discord.Commands;
-using Microsoft.Extensions.DependencyInjection;
-
-public class Program
-{
-    private CommandService _commands;
-    private DiscordSocketClient _client;
-    private IServiceProvider _services;
-
-    private static void Main(string[] args) => new Program().StartAsync().GetAwaiter().GetResult();
-
-    public async Task StartAsync()
-    {
-        _client = new DiscordSocketClient();
-        _commands = new CommandService();
-
-        // Avoid hard coding your token. Use an external source instead in your code.
-        string token = "bot token here";
-
-        _services = new ServiceCollection()
-            .AddSingleton(_client)
-            .AddSingleton(_commands)
-            .BuildServiceProvider();
-
-        await InstallCommandsAsync();
-
-        await _client.LoginAsync(TokenType.Bot, token);
-        await _client.StartAsync();
-
-        await Task.Delay(-1);
-    }
-
-    public async Task InstallCommandsAsync()
-    {
-        // Hook the MessageReceived Event into our Command Handler
-        _client.MessageReceived += HandleCommandAsync;
-        // Discover all of the commands in this assembly and load them.
-        await _commands.AddModulesAsync(Assembly.GetEntryAssembly());
-    }
-
-    private async Task HandleCommandAsync(SocketMessage messageParam)
-    {
-        // Don't process the command if it was a System Message
-        var message = messageParam as SocketUserMessage;
-        if (message == null) return;
-        // Create a number to track where the prefix ends and the command begins
-        int argPos = 0;
-        // Determine if the message is a command, based on if it starts with '!' or a mention prefix
-        if (!(message.HasCharPrefix('!', ref argPos) || message.HasMentionPrefix(_client.CurrentUser, ref argPos))) return;
-        // Create a Command Context
-        var context = new SocketCommandContext(_client, message);
-        // Execute the command. (result does not indicate a return value, 
-        // rather an object stating if the command executed successfully)
-        var result = await _commands.ExecuteAsync(context, argPos, _services);
-        if (!result.IsSuccess)
-            await context.Channel.SendMessageAsync(result.ErrorReason);
-    }
-}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/dependency-injection/dependency_map_setup.cs b/docs/guides/commands/samples/dependency-injection/dependency_map_setup.cs
new file mode 100644
index 000000000..118c032ed
--- /dev/null
+++ b/docs/guides/commands/samples/dependency-injection/dependency_map_setup.cs
@@ -0,0 +1,62 @@
+public class Initialize
+{
+	private readonly CommandService _commands;
+	private readonly DiscordSocketClient _client;
+
+	public Initialize(CommandService commands = null, DiscordSocketClient client = null)
+	{
+		_commands = commands ?? new CommandService();
+		_client = client ?? new DiscordSocketClient();
+	}
+
+	public IServiceProvider BuildServiceProvider() => new ServiceCollection()
+		.AddSingleton(_client)
+		.AddSingleton(_commands)
+		// You can pass in an instance of the desired type
+		.AddSingleton(new NotificationService())
+		// ...or by using the generic method.
+		//
+		// The benefit of using the generic method is that 
+		// ASP.NET DI will attempt to inject the required
+		// dependencies that are specified under the constructor 
+		// for us.
+		.AddSingleton<DatabaseService>()
+		.AddSingleton<CommandHandler>()
+		.BuildServiceProvider();
+}
+public class CommandHandler
+{
+	private readonly DiscordSocketClient _client;
+	private readonly CommandService _commands;
+	private readonly IServiceProvider _services;
+
+	public CommandHandler(IServiceProvider services, CommandService commands, DiscordSocketClient client)
+	{
+		_commands = commands;
+		_services = services;
+		_client = client;
+	}
+
+	public async Task InitializeAsync()
+	{
+		// Pass the service provider to the second parameter of
+		// AddModulesAsync to inject dependencies to all modules 
+		// that may require them.
+		await _commands.AddModulesAsync(
+			assembly: Assembly.GetEntryAssembly(), 
+			services: _services);
+		_client.MessageReceived += HandleCommandAsync;
+	}
+
+	public async Task HandleCommandAsync(SocketMessage msg)
+	{
+		// ...
+		// Pass the service provider to the ExecuteAsync method for
+		// precondition checks.
+		await _commands.ExecuteAsync(
+			context: context, 
+			argPos: argPos, 
+			services: _services);
+		// ...
+	}
+}
diff --git a/docs/guides/commands/samples/dependency-injection/dependency_module.cs b/docs/guides/commands/samples/dependency-injection/dependency_module.cs
new file mode 100644
index 000000000..f0625e503
--- /dev/null
+++ b/docs/guides/commands/samples/dependency-injection/dependency_module.cs
@@ -0,0 +1,37 @@
+// After setting up dependency injection, modules will need to request
+// the dependencies to let the library know to pass 
+// them along during execution.
+
+// Dependency can be injected in two ways with Discord.Net.
+// You may inject any required dependencies via...
+// the module constructor
+// -or-
+// public settable properties
+
+// Injection via constructor
+public class DatabaseModule : ModuleBase<SocketCommandContext>
+{
+    private readonly DatabaseService _database;
+    public DatabaseModule(DatabaseService database)
+    {
+        _database = database;
+    }
+
+    [Command("read")]
+    public async Task ReadFromDbAsync()
+    {
+        await ReplyAsync(_database.GetData());
+    }
+}
+
+// Injection via public settable properties
+public class DatabaseModule : ModuleBase<SocketCommandContext>
+{
+    public DatabaseService DbService { get; set; }
+
+    [Command("read")]
+    public async Task ReadFromDbAsync()
+    {
+        await ReplyAsync(_database.GetData());
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/dependency-injection/dependency_module_noinject.cs b/docs/guides/commands/samples/dependency-injection/dependency_module_noinject.cs
new file mode 100644
index 000000000..48cd52308
--- /dev/null
+++ b/docs/guides/commands/samples/dependency-injection/dependency_module_noinject.cs
@@ -0,0 +1,29 @@
+// Sometimes injecting dependencies automatically with the provided
+// methods in the prior example may not be desired.
+
+// You may explicitly tell Discord.Net to **not** inject the properties
+// by either...
+// restricting the access modifier
+// -or-
+// applying DontInjectAttribute to the property
+
+// Restricting the access modifier of the property
+public class ImageModule : ModuleBase<SocketCommandContext>
+{
+    public ImageService ImageService { get; }
+    public ImageModule()
+    {
+        ImageService = new ImageService();
+    }
+}
+
+// Applying DontInjectAttribute
+public class ImageModule : ModuleBase<SocketCommandContext>
+{
+    [DontInject]
+    public ImageService ImageService { get; set; }
+    public ImageModule()
+    {
+        ImageService = new ImageService();
+    }
+}
diff --git a/docs/guides/commands/samples/dependency_map_setup.cs b/docs/guides/commands/samples/dependency_map_setup.cs
deleted file mode 100644
index a36925904..000000000
--- a/docs/guides/commands/samples/dependency_map_setup.cs
+++ /dev/null
@@ -1,18 +0,0 @@
-private IServiceProvider _services;
-private CommandService _commands;
-
-public async Task InstallAsync(DiscordSocketClient client)
-{
-	// Here, we will inject the ServiceProvider with 
-	// all of the services our client will use.
-	_services = new ServiceCollection()
-		.AddSingleton(client)
-		.AddSingleton(_commands)
-		// You can pass in an instance of the desired type
-		.AddSingleton(new NotificationService())
-		// ...or by using the generic method.
-		.AddSingleton<DatabaseService>()
-		.BuildServiceProvider();
-	// ...
-	await _commands.AddModulesAsync(Assembly.GetEntryAssembly());
-}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/dependency_module.cs b/docs/guides/commands/samples/dependency_module.cs
deleted file mode 100644
index 561b0f6ac..000000000
--- a/docs/guides/commands/samples/dependency_module.cs
+++ /dev/null
@@ -1,40 +0,0 @@
-using Discord;
-using Discord.Commands;
-using Discord.WebSocket;
-
-public class ModuleA : ModuleBase
-{
-    private readonly DatabaseService _database;
-
-    // Dependencies can be injected via the constructor
-    public ModuleA(DatabaseService database)
-    {
-        _database = database;
-    }
-
-    public async Task ReadFromDb()
-    {
-        var x = _database.getX();
-        await ReplyAsync(x);
-    }
-}
-
-public class ModuleB
-{
-
-    // Public settable properties will be injected
-    public AnnounceService { get; set; }
-
-    // Public properties without setters will not
-    public CommandService Commands { get; }
-
-    // Public properties annotated with [DontInject] will not
-    [DontInject]
-    public NotificationService { get; set; }
-
-    public ModuleB(CommandService commands)
-    {
-        Commands = commands;
-    }
-
-}
diff --git a/docs/guides/commands/samples/empty-module.cs b/docs/guides/commands/samples/empty-module.cs
deleted file mode 100644
index 6483c7cd2..000000000
--- a/docs/guides/commands/samples/empty-module.cs
+++ /dev/null
@@ -1,6 +0,0 @@
-using Discord.Commands;
-
-public class InfoModule : ModuleBase<SocketCommandContext>
-{
-    
-}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/intro/command_handler.cs b/docs/guides/commands/samples/intro/command_handler.cs
new file mode 100644
index 000000000..e4531fa41
--- /dev/null
+++ b/docs/guides/commands/samples/intro/command_handler.cs
@@ -0,0 +1,63 @@
+public class CommandHandler
+{
+    private readonly DiscordSocketClient _client;
+    private readonly CommandService _commands;
+
+    public CommandHandler(DiscordSocketClient client, CommandService commands)
+    {
+        _commands = commands;
+        _client = client;
+    }
+    
+    public async Task InstallCommandsAsync()
+    {
+        // Hook the MessageReceived event into our command handler
+        _client.MessageReceived += HandleCommandAsync;
+
+        // Here we discover all of the command modules in the entry 
+        // assembly and load them. Starting from Discord.NET 2.0, a
+        // service provider is required to be passed into the
+        // module registration method to inject the 
+        // required dependencies.
+        //
+        // If you do not use Dependency Injection, pass null.
+        // See Dependency Injection guide for more information.
+        await _commands.AddModulesAsync(assembly: Assembly.GetEntryAssembly(), 
+                                        services: null);
+    }
+
+    private async Task HandleCommandAsync(SocketMessage messageParam)
+    {
+        // Don't process the command if it was a system message
+        var message = messageParam as SocketUserMessage;
+        if (message == null) return;
+
+        // Create a number to track where the prefix ends and the command begins
+        int argPos = 0;
+
+        // Determine if the message is a command based on the prefix
+        if (!(message.HasCharPrefix('!', ref argPos) || 
+            message.HasMentionPrefix(_client.CurrentUser, ref argPos)))
+            return;
+
+        // Create a WebSocket-based command context based on the message
+        var context = new SocketCommandContext(_client, message);
+
+        // Execute the command with the command context we just
+        // created, along with the service provider for precondition checks.
+        
+        // Keep in mind that result does not indicate a return value
+        // rather an object stating if the command executed successfully.
+        var result = await _command.ExecuteAsync(
+            context: context, 
+            argPos: argPos,
+            services: null);
+
+        // Optionally, we may inform the user if the command fails
+        // to be executed; however, this may not always be desired,
+        // as it may clog up the request queue should a user spam a
+        // command.
+        // if (!result.IsSuccess)
+        // await context.Channel.SendMessageAsync(result.ErrorReason);
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/intro/empty-module.cs b/docs/guides/commands/samples/intro/empty-module.cs
new file mode 100644
index 000000000..db62032c2
--- /dev/null
+++ b/docs/guides/commands/samples/intro/empty-module.cs
@@ -0,0 +1,8 @@
+using Discord.Commands;
+
+// Keep in mind your module **must** be public and inherit ModuleBase.
+// If it isn't, it will not be discovered by AddModulesAsync!
+public class InfoModule : ModuleBase<SocketCommandContext>
+{
+    
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/groups.cs b/docs/guides/commands/samples/intro/groups.cs
similarity index 52%
rename from docs/guides/commands/samples/groups.cs
rename to docs/guides/commands/samples/intro/groups.cs
index 5f96c34e8..e117a52da 100644
--- a/docs/guides/commands/samples/groups.cs
+++ b/docs/guides/commands/samples/intro/groups.cs
@@ -4,15 +4,22 @@ public class AdminModule : ModuleBase<SocketCommandContext>
     [Group("clean")]
     public class CleanModule : ModuleBase<SocketCommandContext>
     {
-        // ~admin clean 15
+        // ~admin clean
         [Command]
-        public async Task Default(int count = 10) => Messages(count);
+        public async Task DefaultCleanAsync()
+        {
+            // ...
+        }
 
         // ~admin clean messages 15
         [Command("messages")]
-        public async Task Messages(int count = 10) { }
+        public async Task CleanAsync(int count)
+        {
+            // ...
+        }
     }
     // ~admin ban foxbot#0282
     [Command("ban")]
-    public async Task Ban(IGuildUser user) { }
+    public Task BanAsync(IGuildUser user) => 
+        Context.Guild.AddBanAsync(user);
 }
\ No newline at end of file
diff --git a/docs/guides/commands/samples/module.cs b/docs/guides/commands/samples/intro/module.cs
similarity index 58%
rename from docs/guides/commands/samples/module.cs
rename to docs/guides/commands/samples/intro/module.cs
index 1e3555501..e5fe70534 100644
--- a/docs/guides/commands/samples/module.cs
+++ b/docs/guides/commands/samples/intro/module.cs
@@ -1,24 +1,25 @@
 // Create a module with no prefix
-public class Info : ModuleBase<SocketCommandContext>
+public class InfoModule : ModuleBase<SocketCommandContext>
 {
-	// ~say hello -> hello
+	// ~say hello world -> hello world
 	[Command("say")]
 	[Summary("Echoes a message.")]
-	public async Task SayAsync([Remainder] [Summary("The text to echo")] string echo)
-	{
-		// ReplyAsync is a method on ModuleBase
-		await ReplyAsync(echo);
-	}
+	public Task SayAsync([Remainder] [Summary("The text to echo")] string echo)
+		=> ReplyAsync(echo);
+		
+	// ReplyAsync is a method on ModuleBase 
 }
 
 // Create a module with the 'sample' prefix
 [Group("sample")]
-public class Sample : ModuleBase<SocketCommandContext>
+public class SampleModule : ModuleBase<SocketCommandContext>
 {
 	// ~sample square 20 -> 400
 	[Command("square")]
 	[Summary("Squares a number.")]
-	public async Task SquareAsync([Summary("The number to square.")] int num)
+	public async Task SquareAsync(
+		[Summary("The number to square.")] 
+		int num)
 	{
 		// We can also access the channel from the Command Context.
 		await Context.Channel.SendMessageAsync($"{num}^2 = {Math.Pow(num, 2)}");
@@ -31,9 +32,12 @@ public class Sample : ModuleBase<SocketCommandContext>
 	// ~sample userinfo 96642168176807936 --> Khionu#8708
 	// ~sample whois 96642168176807936 --> Khionu#8708
 	[Command("userinfo")]
-	[Summary("Returns info about the current user, or the user parameter, if one passed.")]
+	[Summary
+	("Returns info about the current user, or the user parameter, if one passed.")]
 	[Alias("user", "whois")]
-	public async Task UserInfoAsync([Summary("The (optional) user to get info for")] SocketUser user = null)
+	public async Task UserInfoAsync(
+		[Summary("The (optional) user to get info from")]
+		SocketUser user = null)
 	{
 		var userInfo = user ?? Context.Client.CurrentUser;
 		await ReplyAsync($"{userInfo.Username}#{userInfo.Discriminator}");
diff --git a/docs/guides/commands/samples/post-execution/command_exception_log.cs b/docs/guides/commands/samples/post-execution/command_exception_log.cs
new file mode 100644
index 000000000..2956a0203
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/command_exception_log.cs
@@ -0,0 +1,13 @@
+public async Task LogAsync(LogMessage logMessage)
+{
+    // This casting type requries C#7
+    if (logMessage.Exception is CommandException cmdException)
+    {
+        // We can tell the user that something unexpected has happened
+        await cmdException.Context.Channel.SendMessageAsync("Something went catastrophically wrong!");
+
+        // We can also log this incident
+        Console.WriteLine($"{cmdException.Context.User} failed to execute '{cmdException.Command.Name}' in {cmdException.Context.Channel}.");
+        Console.WriteLine(cmdException.ToString());
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/command_executed_adv_demo.cs b/docs/guides/commands/samples/post-execution/command_executed_adv_demo.cs
new file mode 100644
index 000000000..1ce40c51d
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/command_executed_adv_demo.cs
@@ -0,0 +1,13 @@
+public async Task OnCommandExecutedAsync(CommandInfo command, ICommandContext context, IResult result)
+{
+    switch(result)
+    {
+        case MyCustomResult customResult:
+            // do something extra with it
+            break;
+        default:
+            if (!string.IsNullOrEmpty(result.ErrorReason))
+                await context.Channel.SendMessageAsync(result.ErrorReason);
+            break;
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/command_executed_demo.cs b/docs/guides/commands/samples/post-execution/command_executed_demo.cs
new file mode 100644
index 000000000..8d8fb911b
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/command_executed_demo.cs
@@ -0,0 +1,38 @@
+public async Task SetupAsync()
+{
+    await _command.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
+    // Hook the execution event
+    _command.CommandExecuted += OnCommandExecutedAsync;
+    // Hook the command handler
+    _client.MessageReceived += HandleCommandAsync;
+}
+public async Task OnCommandExecutedAsync(CommandInfo command, ICommandContext context, IResult result)
+{
+    // We have access to the information of the command executed,
+    // the context of the command, and the result returned from the
+    // execution in this event.
+
+    // We can tell the user what went wrong
+    if (!string.IsNullOrEmpty(result?.ErrorReason))
+    {
+        await context.Channel.SendMessageAsync(result.ErrorReason);
+    }
+
+    // ...or even log the result (the method used should fit into
+    // your existing log handler)
+    await _log.LogAsync(new LogMessage(LogSeverity.Info, "CommandExecution", $"{command?.Name} was executed at {DateTime.UtcNow}."));
+}
+public async Task HandleCommandAsync(SocketMessage msg)
+{
+    var message = messageParam as SocketUserMessage;
+    if (message == null) return;
+    int argPos = 0;
+    if (!(message.HasCharPrefix('!', ref argPos) || message.HasMentionPrefix(_client.CurrentUser, ref argPos))) return;
+    var context = new SocketCommandContext(_client, message);
+    var result = await _commands.ExecuteAsync(context, argPos, _services);
+    // Optionally, you may pass the result manually into your
+    // CommandExecuted event handler if you wish to handle parsing or
+    // precondition failures in the same method.
+
+    // await OnCommandExecutedAsync(null, context, result);
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/customresult_base.cs b/docs/guides/commands/samples/post-execution/customresult_base.cs
new file mode 100644
index 000000000..895a370c7
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/customresult_base.cs
@@ -0,0 +1,6 @@
+public class MyCustomResult : RuntimeResult
+{
+    public MyCustomResult(CommandError? error, string reason) : base(error, reason)
+    {
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/customresult_extended.cs b/docs/guides/commands/samples/post-execution/customresult_extended.cs
new file mode 100644
index 000000000..6754c96aa
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/customresult_extended.cs
@@ -0,0 +1,10 @@
+public class MyCustomResult : RuntimeResult
+{
+    public MyCustomResult(CommandError? error, string reason) : base(error, reason)
+    {
+    }
+    public static MyCustomResult FromError(string reason) =>
+        new MyCustomResult(CommandError.Unsuccessful, reason);
+    public static MyCustomResult FromSuccess(string reason = null) =>
+        new MyCustomResult(null, reason);
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/customresult_usage.cs b/docs/guides/commands/samples/post-execution/customresult_usage.cs
new file mode 100644
index 000000000..44266cfb4
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/customresult_usage.cs
@@ -0,0 +1,10 @@
+public class MyModule : ModuleBase<SocketCommandContext>
+{
+    [Command("eat")]
+    public async Task<RuntimeResult> ChooseAsync(string food)
+    {
+        if (food == "salad")
+            return MyCustomResult.FromError("No, I don't want that!");
+        return MyCustomResult.FromSuccess($"Give me the {food}!").
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/post-execution/post-execution_basic.cs b/docs/guides/commands/samples/post-execution/post-execution_basic.cs
new file mode 100644
index 000000000..19c7bed59
--- /dev/null
+++ b/docs/guides/commands/samples/post-execution/post-execution_basic.cs
@@ -0,0 +1,11 @@
+var result = await _commands.ExecuteAsync(context, argPos, _services);
+if (result.CommandError != null)
+	switch(result.CommandError)
+	{
+		case CommandError.BadArgCount:
+			await context.Channel.SendMessageAsync("Parameter count does not match any command's.");
+			break;
+		default:
+			await context.Channel.SendMessageAsync($"An error has occurred {result.ErrorReason}");
+			break;
+	}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/preconditions/group_precondition.cs b/docs/guides/commands/samples/preconditions/group_precondition.cs
new file mode 100644
index 000000000..bae102b9a
--- /dev/null
+++ b/docs/guides/commands/samples/preconditions/group_precondition.cs
@@ -0,0 +1,9 @@
+// The following example only requires the user to either have the
+// Administrator permission in this guild or own the bot application.
+[RequireUserPermission(GuildPermission.Administrator, Group = "Permission")]
+[RequireOwner(Group = "Permission")]
+public class AdminModule : ModuleBase<SocketCommandContext>
+{
+    [Command("ban")]
+    public Task BanAsync(IUser user) => Context.Guild.AddBanAsync(user);
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/preconditions/precondition_usage.cs b/docs/guides/commands/samples/preconditions/precondition_usage.cs
new file mode 100644
index 000000000..eacee932a
--- /dev/null
+++ b/docs/guides/commands/samples/preconditions/precondition_usage.cs
@@ -0,0 +1,3 @@
+[RequireOwner]
+[Command("echo")]
+public Task EchoAsync(string input) => ReplyAsync(input);
\ No newline at end of file
diff --git a/docs/guides/commands/samples/require_owner.cs b/docs/guides/commands/samples/preconditions/require_owner.cs
similarity index 66%
rename from docs/guides/commands/samples/require_owner.cs
rename to docs/guides/commands/samples/preconditions/require_owner.cs
index 3611afab8..f17b7d9a7 100644
--- a/docs/guides/commands/samples/require_owner.cs
+++ b/docs/guides/commands/samples/preconditions/require_owner.cs
@@ -1,4 +1,5 @@
-// (Note: This precondition is obsolete, it is recommended to use the RequireOwnerAttribute that is bundled with Discord.Commands)
+// (Note: This precondition is obsolete, it is recommended to use the
+// RequireOwnerAttribute that is bundled with Discord.Commands)
 
 using Discord.Commands;
 using Discord.WebSocket;
@@ -10,10 +11,13 @@ using System.Threading.Tasks;
 public class RequireOwnerAttribute : PreconditionAttribute
 {
     // Override the CheckPermissions method
-    public async override Task<PreconditionResult> CheckPermissions(ICommandContext context, CommandInfo command, IServiceProvider services)
+    public async override Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
     {
+        // Get the client via Depedency Injection
+        var client = services.GetRequiredService<DiscordSocketClient>();
         // Get the ID of the bot's owner
-        var ownerId = (await services.GetService<DiscordSocketClient>().GetApplicationInfoAsync()).Owner.Id;
+        var appInfo = await client.GetApplicationInfoAsync().ConfigureAwait(false);
+        var ownerId = appInfo.Owner.Id;
         // If this command was executed by that user, return a success
         if (context.User.Id == ownerId)
             return PreconditionResult.FromSuccess();
diff --git a/docs/guides/commands/samples/typereaders/typereader-register.cs b/docs/guides/commands/samples/typereaders/typereader-register.cs
new file mode 100644
index 000000000..292caea6f
--- /dev/null
+++ b/docs/guides/commands/samples/typereaders/typereader-register.cs
@@ -0,0 +1,29 @@
+public class CommandHandler
+{
+    private readonly CommandService _commands;
+    private readonly DiscordSocketClient _client;
+    private readonly IServiceProvider _services;
+
+    public CommandHandler(CommandService commands, DiscordSocketClient client, IServiceProvider services)
+    {
+        _commands = commands;
+        _client = client;
+        _services = services;
+    }
+
+    public async Task SetupAsync()
+    {
+        _client.MessageReceived += CommandHandleAsync;
+
+        // Add BooleanTypeReader to type read for the type "bool"
+        _commands.AddTypeReader(typeof(bool), new BooleanTypeReader());
+
+        // Then register the modules
+        await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
+    }
+
+    public async Task CommandHandleAsync(SocketMessage msg)
+    {
+        // ...
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/commands/samples/typereader.cs b/docs/guides/commands/samples/typereaders/typereader.cs
similarity index 74%
rename from docs/guides/commands/samples/typereader.cs
rename to docs/guides/commands/samples/typereaders/typereader.cs
index d2864a4c7..a2a4627d2 100644
--- a/docs/guides/commands/samples/typereader.cs
+++ b/docs/guides/commands/samples/typereaders/typereader.cs
@@ -1,10 +1,11 @@
-// Note: This example is obsolete, a boolean type reader is bundled with Discord.Commands
+// Note: This example is obsolete, a boolean type reader is bundled 
+// with Discord.Commands
 using Discord;
 using Discord.Commands;
 
 public class BooleanTypeReader : TypeReader
 {
-    public override Task<TypeReaderResult> Read(ICommandContext context, string input, IServiceProvider services)
+    public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
     {
         bool result;
         if (bool.TryParse(input, out result))
diff --git a/docs/guides/commands/typereaders.md b/docs/guides/commands/typereaders.md
new file mode 100644
index 000000000..f942c9341
--- /dev/null
+++ b/docs/guides/commands/typereaders.md
@@ -0,0 +1,70 @@
+---
+uid: Guides.Commands.TypeReaders
+title: Type Readers
+---
+
+# Type Readers
+
+Type Readers allow you to parse different types of arguments in
+your commands.
+
+By default, the following Types are supported arguments:
+
+* `bool`
+* `char`
+* `sbyte`/`byte`
+* `ushort`/`short`
+* `uint`/`int`
+* `ulong`/`long`
+* `float`, `double`, `decimal`
+* `string`
+* `enum`
+* `DateTime`/`DateTimeOffset`/`TimeSpan`
+* Any nullable value-type (e.g. `int?`, `bool?`)
+* Any implementation of `IChannel`/`IMessage`/`IUser`/`IRole`
+
+## Creating a Type Reader
+
+To create a `TypeReader`, create a new class that imports @Discord and
+@Discord.Commands and ensure the class inherits from
+@Discord.Commands.TypeReader. Next, satisfy the `TypeReader` class by
+overriding the [ReadAsync] method.
+
+Inside this Task, add whatever logic you need to parse the input
+string.
+
+If you are able to successfully parse the input, return
+[TypeReaderResult.FromSuccess] with the parsed input, otherwise return
+[TypeReaderResult.FromError] and include an error message if
+necessary.
+
+> [!NOTE]
+> Visual Studio can help you implement missing members
+> from the abstract class by using the "Implement Abstract Class"
+> IntelliSense hint.
+
+[TypeReaderResult]: xref:Discord.Commands.TypeReaderResult
+[TypeReaderResult.FromSuccess]: xref:Discord.Commands.TypeReaderResult.FromSuccess*
+[TypeReaderResult.FromError]: xref:Discord.Commands.TypeReaderResult.FromError*
+[ReadAsync]: xref:Discord.Commands.TypeReader.ReadAsync*
+
+### Example - Creating a Type Reader
+
+[!code-csharp[TypeReaders](samples/typereaders/typereader.cs)]
+
+## Registering a Type Reader
+
+TypeReaders are not automatically discovered by the Command Service
+and must be explicitly added.
+
+To register a TypeReader, invoke [CommandService.AddTypeReader].
+
+> [!IMPORTANT]
+> TypeReaders must be added prior to module discovery, otherwise your
+> TypeReaders may not work!
+
+[CommandService.AddTypeReader]: xref:Discord.Commands.CommandService.AddTypeReader*
+
+### Example - Adding a Type Reader
+
+[!code-csharp[Adding TypeReaders](samples/typereaders/typereader-register.cs)]
\ No newline at end of file
diff --git a/docs/guides/concepts/connections.md b/docs/guides/concepts/connections.md
index 30e5e55cd..3d7b77cb8 100644
--- a/docs/guides/concepts/connections.md
+++ b/docs/guides/concepts/connections.md
@@ -1,51 +1,50 @@
 ---
+uid: Guides.Concepts.ManageConnections
 title: Managing Connections
 ---
 
+# Managing Connections with Discord.Net
+
 In Discord.Net, once a client has been started, it will automatically
-maintain a connection to Discord's gateway, until it is manually
+maintain a connection to Discord's gateway until it is manually
 stopped.
 
-### Usage
+## Usage
 
 To start a connection, invoke the `StartAsync` method on a client that
-supports a WebSocket connection.
-
-These clients include the [DiscordSocketClient] and 
-[DiscordRpcClient], as well as Audio clients.
-
-To end a connection, invoke the `StopAsync` method. This will
-gracefully close any open WebSocket or UdpSocket connections.
+supports a WebSocket connection; to end a connection, invoke the
+`StopAsync` method, which gracefully closes any open WebSocket or
+UdpSocket connections.
 
 Since the Start/Stop methods only signal to an underlying connection
-manager that a connection needs to be started, **they return before a 
-connection is actually made.**
+manager that a connection needs to be started, **they return before a
+connection is made.**
 
-As a result, you will need to hook into one of the connection-state
+As a result, you need to hook into one of the connection-state
 based events to have an accurate representation of when a client is
 ready for use.
 
 All clients provide a `Connected` and `Disconnected` event, which is
 raised respectively when a connection opens or closes. In the case of
-the DiscordSocketClient, this does **not** mean that the client is
+the [DiscordSocketClient], this does **not** mean that the client is
 ready to be used.
 
-A separate event, `Ready`, is provided on DiscordSocketClient, which
+A separate event, `Ready`, is provided on [DiscordSocketClient], which
 is raised only when the client has finished guild stream or guild
-sync, and has a complete guild cache.
+sync and has a completed guild cache.
 
 [DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[DiscordRpcClient]: xref:Discord.Rpc.DiscordRpcClient
 
 ### Samples
 
 [!code-csharp[Connection Sample](samples/events.cs)]
 
-### Tips
+## Reconnection
 
-Avoid running long-running code on the gateway! If you deadlock the
-gateway (as explained in [events]), the connection manager will be
-unable to recover and reconnect.
+> [!TIP]
+> Avoid running long-running code on the gateway! If you deadlock the
+> gateway (as explained in [events]), the connection manager will
+> **NOT** be able to recover and reconnect.
 
 Assuming the client disconnected because of a fault on Discord's end,
 and not a deadlock on your end, we will always attempt to reconnect
@@ -53,6 +52,6 @@ and resume a connection.
 
 Don't worry about trying to maintain your own connections, the
 connection manager is designed to be bulletproof and never fail - if
-your client doesn't manage to reconnect, you've found a bug!
+your client does not manage to reconnect, you have found a bug!
 
-[events]: events.md
\ No newline at end of file
+[events]: xref:Guides.Concepts.Events
diff --git a/docs/guides/concepts/entities.md b/docs/guides/concepts/entities.md
index 3a5d5496b..7415f043a 100644
--- a/docs/guides/concepts/entities.md
+++ b/docs/guides/concepts/entities.md
@@ -1,23 +1,26 @@
 ---
+uid: Guides.Concepts.Entities
 title: Entities
 ---
 
->[!NOTE]
-This article is written with the Socket variants of entities in mind,
-not the general interfaces or Rest/Rpc entities.
+# Entities in Discord.Net
+
+> [!NOTE]
+> This article is written with the Socket variants of entities in mind,
+> not the general interfaces or Rest/Rpc entities.
 
 Discord.Net provides a versatile entity system for navigating the
 Discord API.
 
-### Inheritance
+## Inheritance
 
 Due to the nature of the Discord API, some entities are designed with
 multiple variants; for example, `SocketUser` and `SocketGuildUser`.
 
 All models will contain the most detailed version of an entity
-possible, even if the type is less detailed. 
+possible, even if the type is less detailed.
 
-For example, in the case of the `MessageReceived` event, a 
+For example, in the case of the `MessageReceived` event, a
 `SocketMessage` is passed in with a channel property of type
 `SocketMessageChannel`. All messages come from channels capable of
 messaging, so this is the only variant of a channel that can cover
@@ -28,44 +31,36 @@ But that doesn't mean a message _can't_ come from a
 retrieve information about a guild from a message entity, you will
 need to cast its channel object to a `SocketTextChannel`.
 
-### Navigation
+You can find out various types of entities in the @FAQ.Misc.Glossary
+page.
+
+## Navigation
 
 All socket entities have navigation properties on them, which allow
 you to easily navigate to an entity's parent or children. As explained
 above, you will sometimes need to cast to a more detailed version of
 an entity to navigate to its parent.
 
-### Accessing Entities
+## Accessing Entities
 
 The most basic forms of entities, `SocketGuild`, `SocketUser`, and
 `SocketChannel` can be pulled from the DiscordSocketClient's global
 cache, and can be retrieved using the respective `GetXXX` method on
 DiscordSocketClient.
 
->[!TIP]
-It is **vital** that you use the proper IDs for an entity when using
-a GetXXX method. It is recommended that you enable Discord's
-_developer mode_ to allow easy access to entity IDs, found in
-Settings > Appearance > Advanced
+> [!TIP]
+> It is **vital** that you use the proper IDs for an entity when using
+> a `GetXXX` method. It is recommended that you enable Discord's
+> _developer mode_ to allow easy access to entity IDs, found in
+> Settings > Appearance > Advanced. Read more about it in the
+> [FAQ](xref:FAQ.Basics.GetStarted) page.
 
 More detailed versions of entities can be pulled from the basic
-entities, e.g. `SocketGuild.GetUser`, which returns a 
-`SocketGuildUser`, or `SocketGuild.GetChannel`, which returns a 
+entities, e.g., `SocketGuild.GetUser`, which returns a
+`SocketGuildUser`, or `SocketGuild.GetChannel`, which returns a
 `SocketGuildChannel`. Again, you may need to cast these objects to get
 a variant of the type that you need.
 
-### Samples
-
-[!code-csharp[Entity Sample](samples/entities.cs)]
-
-### Tips
-
-Avoid using boxing-casts to coerce entities into a variant, use the
-[`as`] keyword, and a null-conditional operator instead.
-
-This allows you to write safer code and avoid [InvalidCastExceptions].
-
-For example, `(message.Author as SocketGuildUser)?.Nickname`.
+## Sample
 
-[`as`]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/as
-[InvalidCastExceptions]: https://msdn.microsoft.com/en-us/library/system.invalidcastexception(v=vs.110).aspx
\ No newline at end of file
+[!code-csharp[Entity Sample](samples/entities.cs)]
\ No newline at end of file
diff --git a/docs/guides/concepts/events.md b/docs/guides/concepts/events.md
index 47db49aa8..293b5dc72 100644
--- a/docs/guides/concepts/events.md
+++ b/docs/guides/concepts/events.md
@@ -1,16 +1,19 @@
 ---
+uid: Guides.Concepts.Events
 title: Working with Events
 ---
 
+# Events in Discord.Net
+
 Events in Discord.Net are consumed in a similar manner to the standard
 convention, with the exception that every event must be of the type
-`System.Threading.Tasks.Task` and instead of using `EventArgs`, the
-event's parameters are passed directly into the handler.
+@System.Threading.Tasks.Task and instead of using @System.EventArgs,
+the event's parameters are passed directly into the handler.
 
 This allows for events to be handled in an async context directly
 instead of relying on `async void`.
 
-### Usage
+## Usage
 
 To receive data from an event, hook into it using C#'s delegate
 event pattern.
@@ -18,7 +21,7 @@ event pattern.
 You may either opt to hook an event to an anonymous function (lambda)
 or a named function.
 
-### Safety
+## Safety
 
 All events are designed to be thread-safe; events are executed
 synchronously off the gateway task in the same context as the gateway
@@ -39,7 +42,7 @@ a deadlock that will be impossible to recover from.
 Exceptions in commands will be swallowed by the gateway and logged out
 through the client's log method.
 
-### Common Patterns
+## Common Patterns
 
 As you may know, events in Discord.Net are only given a signature of
 `Func<T1, ..., Task>`. There is no room for predefined argument names,
@@ -49,7 +52,7 @@ directly.
 That being said, there are a variety of common patterns that allow you
 to infer what the parameters in an event mean.
 
-#### Entity, Entity
+### Entity, Entity
 
 An event handler with a signature of `Func<Entity, Entity, Task>`
 typically means that the first object will be a clone of the entity
@@ -58,10 +61,10 @@ model of the entity _after_ the change was made.
 
 This pattern is typically only found on `EntityUpdated` events.
 
-#### Cacheable
+### Cacheable
 
 An event handler with a signature of `Func<Cacheable, Entity, Task>`
-means that the `before`	state of the entity was not provided by the
+means that the `before` state of the entity was not provided by the
 API, so it can either be pulled from the client's cache or
 downloaded from the API.
 
@@ -70,15 +73,12 @@ object.
 
 [Cacheable]: xref:Discord.Cacheable`2
 
-### Samples
-
-[!code-csharp[Event Sample](samples/events.cs)]
+> [!NOTE]
+> Many events relating to a Message entity (i.e., `MessageUpdated` and
+> `ReactionAdded`) rely on the client's message cache, which is
+> **not** enabled by default. Set the `MessageCacheSize` flag in
+> @Discord.WebSocket.DiscordSocketConfig to enable it.
 
-### Tips
+## Sample
 
-Many events relating to a Message entity (i.e. `MessageUpdated` and 
-`ReactionAdded`) rely on the client's message cache, which is
-**not** enabled by default. Set the `MessageCacheSize` flag in
-[DiscordSocketConfig] to enable it.
-
-[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
\ No newline at end of file
+[!code-csharp[Event Sample](samples/events.cs)]
diff --git a/docs/guides/concepts/logging.md b/docs/guides/concepts/logging.md
index 50d2e9546..b92d2bd53 100644
--- a/docs/guides/concepts/logging.md
+++ b/docs/guides/concepts/logging.md
@@ -1,19 +1,28 @@
 ---
-title: Logging
+uid: Guides.Concepts.Logging
+title: Logging Events/Data
 ---
 
-Discord.Net's clients provide a [Log] event that all messages will be
-disbatched over.
+# Logging in Discord.Net
+
+Discord.Net's clients provide a log event that all messages will be
+dispatched over.
 
 For more information about events in Discord.Net, see the [Events]
 section.
 
-[Log]: xref:Discord.Rest.BaseDiscordClient#Discord_Rest_BaseDiscordClient_Log
-[Events]: events.md
+[Events]: xref:Guides.Concepts.Events
+
+> [!WARNING]
+> Due to the nature of Discord.Net's event system, all log event
+> handlers will be executed synchronously on the gateway thread. If your
+> log output will be dumped to a Web API (e.g., Sentry), you are advised
+> to wrap your output in a `Task.Run` so the gateway thread does not
+> become blocked while waiting for logging data to be written.
 
-### Usage
+## Usage in Client(s)
 
-To receive log events, simply hook the discord client's log method
+To receive log events, simply hook the Discord client's @Discord.Rest.BaseDiscordClient.Log
 to a `Task` with a single parameter of type [LogMessage].
 
 It is recommended that you use an established function instead of a
@@ -22,10 +31,10 @@ to a logging function to write their own messages.
 
 [LogMessage]: xref:Discord.LogMessage
 
-### Usage in Commands
+## Usage in Commands
 
-Discord.Net's [CommandService] also provides a log event, identical
-in signature to other log events.
+Discord.Net's [CommandService] also provides a @Discord.Commands.CommandService.Log
+event, identical in signature to other log events.
 
 Data logged through this event is typically coupled with a
 [CommandException], where information about the command's context
@@ -34,14 +43,6 @@ and error can be found and handled.
 [CommandService]: xref:Discord.Commands.CommandService
 [CommandException]: xref:Discord.Commands.CommandException
 
-#### Samples
+## Sample
 
 [!code-csharp[Logging Sample](samples/logging.cs)]
-
-#### Tips
-
-Due to the nature of Discord.Net's event system, all log event
-handlers will be executed synchronously on the gateway thread. If your
-log output will be dumped to a Web API (e.g. Sentry), you are advised
-to wrap your output in a `Task.Run` so the gateway thread does not
-become blocked while waiting for logging data to be written.
\ No newline at end of file
diff --git a/docs/guides/concepts/samples/connections.cs b/docs/guides/concepts/samples/connections.cs
index f96251a39..b610da524 100644
--- a/docs/guides/concepts/samples/connections.cs
+++ b/docs/guides/concepts/samples/connections.cs
@@ -10,7 +10,7 @@ public class Program
 	{
 		_client = new DiscordSocketClient();
 
-		await _client.LoginAsync(TokenType.Bot, "bot token");
+		await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("DiscordToken"));
 		await _client.StartAsync();
 
 		Console.WriteLine("Press any key to exit...");
diff --git a/docs/guides/concepts/samples/entities.cs b/docs/guides/concepts/samples/entities.cs
index 7655c44e9..64383858d 100644
--- a/docs/guides/concepts/samples/entities.cs
+++ b/docs/guides/concepts/samples/entities.cs
@@ -1,13 +1,11 @@
 public string GetChannelTopic(ulong id)
 {
 	var channel = client.GetChannel(81384956881809408) as SocketTextChannel;
-	if (channel == null) return "";
-	return channel.Topic;
+	return channel?.Topic;
 }
 
-public string GuildOwner(SocketChannel channel)
+public SocketGuildUser GetGuildOwner(SocketChannel channel)
 {
 	var guild = (channel as SocketGuildChannel)?.Guild;
-	if (guild == null) return "";
-	return Context.Guild.Owner.Username;
+	return guild?.Owner;
 }
\ No newline at end of file
diff --git a/docs/guides/concepts/samples/events.cs b/docs/guides/concepts/samples/events.cs
index cf0492cb5..dce625b33 100644
--- a/docs/guides/concepts/samples/events.cs
+++ b/docs/guides/concepts/samples/events.cs
@@ -14,7 +14,7 @@ public class Program
 		var _config = new DiscordSocketConfig { MessageCacheSize = 100 };
 		_client = new DiscordSocketClient(_config);
 
-		await _client.LoginAsync(TokenType.Bot, "bot token");
+		await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("DiscordToken"));
 		await _client.StartAsync();
 
 		_client.MessageUpdated += MessageUpdated;
diff --git a/docs/guides/concepts/samples/logging.cs b/docs/guides/concepts/samples/logging.cs
index a2ddf7b90..2419452f0 100644
--- a/docs/guides/concepts/samples/logging.cs
+++ b/docs/guides/concepts/samples/logging.cs
@@ -15,7 +15,7 @@ public class Program
 
 		_client.Log += Log;
 
-		await _client.LoginAsync(TokenType.Bot, "bot token");
+		await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("DiscordToken"));
 		await _client.StartAsync();
 		
 		await Task.Delay(-1);
diff --git a/docs/guides/deployment/deployment.md b/docs/guides/deployment/deployment.md
new file mode 100644
index 000000000..b75628dc0
--- /dev/null
+++ b/docs/guides/deployment/deployment.md
@@ -0,0 +1,86 @@
+---
+uid: Guides.Deployment
+title: Deploying the Bot
+---
+
+# Deploying a Discord.Net Bot
+
+After finishing your application, you may want to deploy your bot to a
+remote location such as a Virtual Private Server (VPS) or another
+computer so you can keep the bot up and running 24/7.
+
+## Recommended VPS
+
+For small-medium scaled bots, a cheap VPS (~$5) might be sufficient
+enough. Here is a list of recommended VPS provider.
+
+* [DigitalOcean](https://www.digitalocean.com/)
+  * Description: American cloud infrastructure provider headquartered
+    in New York City with data centers worldwide.
+  * Location(s):
+    * Asia: Singapore, India
+    * America: Canada, United States
+    * Europe: Netherlands, Germany, United Kingdom
+  * Based in: United States
+* [Vultr](https://www.vultr.com/)
+  * Description: DigitalOcean-like
+  * Location(s):
+    * Asia: Japan, Australia, Singapore
+    * America: United States
+    * Europe: United Kingdom, France, Netherlands, Germany
+  * Based in: United States
+* [OVH](https://www.ovh.com/)
+  * Description: French cloud computing company that offers VPS,
+    dedicated servers and other web services.
+  * Location(s):
+    * Asia: Australia, Singapore
+    * America: United States, Canada
+    * Europe: United Kingdom, Poland, Germany
+  * Based in: Europe
+* [Scaleway](https://www.scaleway.com/)
+  * Description: Cheap but powerful VPS owned by [Online.net](https://online.net/).
+  * Location(s):
+    * Europe: France, Netherlands
+  * Based in: Europe
+* [Time4VPS](https://www.time4vps.eu/)
+  * Description: Affordable and powerful VPS Hosting in Europe.
+  * Location(s):
+    * Europe: Lithuania
+  * Based in: Europe
+
+## .NET Core Deployment
+
+> [!NOTE]
+> This section only covers the very basics of .NET Core deployment.
+> To learn more about deployment, visit [.NET Core application deployment]
+> by Microsoft.
+
+By default, .NET Core compiles all projects as a DLL file, so that any
+.NET Core runtime can execute the application.
+
+You may execute the application via `dotnet myprogram.dll` assuming you
+have the dotnet CLI installed.
+
+When redistributing the application, you may want to publish the
+application, or in other words, create a self-contained package
+for use on another machine without installing the dependencies first.
+
+This can be achieved by using the dotnet CLI too on the development
+machine:
+
+* `dotnet publish -c Release`
+
+Additionally, you may want to target a specific platform when
+publishing the application so you may use the application without
+having to install the Core runtime on the target machine. To do this,
+you may specify an [Runtime ID] upon build/publish with the `-r`
+option.
+
+For example, when targeting a Windows 10 machine, you may want to use
+the following to create the application in Windows executable
+format (.exe):
+
+* `dotnet publish -c Release -r win10-x64`
+
+[.NET Core application deployment]: https://docs.microsoft.com/en-us/dotnet/core/deploying/
+[Runtime ID]: https://docs.microsoft.com/en-us/dotnet/core/rid-catalog
\ No newline at end of file
diff --git a/docs/guides/emoji/emoji.md b/docs/guides/emoji/emoji.md
new file mode 100644
index 000000000..60a84409c
--- /dev/null
+++ b/docs/guides/emoji/emoji.md
@@ -0,0 +1,100 @@
+---
+uid: Guides.Emoji
+title: Emoji
+---
+
+# Emoji in Discord.Net
+
+Before we delve into the difference between an @Discord.Emoji and an
+@Discord.Emote in Discord.Net, it is **crucial** to understand what
+they both look like behind the scene. When the end-users are sending
+or receiving an emoji or emote, they are typically in the form of
+`:ok_hand:` or `:reeee:`; however, what goes under the hood is that,
+depending on the type of emoji, they are sent in an entirely
+different format.
+
+What does this all mean? It means that you should know that by
+reacting with a string like `“:ok_hand:”` will **NOT** automatically
+translate to `👌`; rather, it will be treated as-is,
+like `:ok_hand:`, thus the server will return a `400 Bad Request`.
+
+## Emoji
+
+An emoji is a standard emoji that can be found anywhere else outside
+of Discord, which means strings like `👌`, `♥`, `👀` are all
+considered an emoji in Discord. However, from the
+introduction paragraph we have learned that we cannot
+simply send `:ok_hand:` and have Discord take
+care of it, but what do we need to send exactly?
+
+To send an emoji correctly, one must send the emoji in its Unicode
+form; this can be obtained in several different ways.
+
+1. (Easiest) Escape the emoji by using the escape character, `\`, in
+ your Discord chat client; this will reveal the emoji’s pure Unicode
+ form, which will allow you to copy-paste into your code.
+2. Look it up on Emojipedia, from which you can copy the emoji
+ easily into your code.
+ ![Emojipedia](images/emojipedia.png)
+3. (Recommended) Look it up in the Emoji list from [FileFormat.Info];
+ this will give you the .NET-compatible code that
+ represents the emoji.
+    * This is the most recommended method because some systems or
+    IDE sometimes do not render the Unicode emoji correctly.
+    ![Fileformat Emoji Source Code](images/fileformat-emoji-src.png)
+
+### Emoji Declaration
+
+After obtaining the Unicode representation of the emoji, you may
+create the @Discord.Emoji object by passing the string into its
+constructor (e.g. `new Emoji("👌");` or `new Emoji("\uD83D\uDC4C");`).
+
+Your method of declaring an @Discord.Emoji should look similar to
+this:
+
+[!code-csharp[Emoji Sample](samples/emoji-sample.cs)]
+
+[FileFormat.Info]: https://www.fileformat.info/info/emoji/list.htm
+
+## Emote
+
+The meat of the debate is here; what is an emote and how does it
+differ from an emoji? An emote refers to a **custom emoji**
+created on Discord.
+
+The underlying structure of an emote also differs drastically; an
+emote looks sort-of like a mention on Discord. It consists of two
+main elements as illustrated below:
+
+![Emote illustration](images/emote-format.png)
+
+As you can see, emote uses a completely different format. To obtain
+the raw string as shown above for your emote, you would need to
+escape the emote using the escape character `\` in chat somewhere.
+
+### Emote Declaration
+
+After obtaining the raw emote string, you would need to use
+@Discord.Emote.Parse* or @Discord.Emote.TryParse* to create a valid
+emote object.
+
+Your method of declaring an @Discord.Emote should look similar to
+this:
+
+[!code[Emote Sample](samples/emote-sample.cs)]
+
+> [!TIP]
+> For WebSocket users, you may also consider fetching the Emote
+> via the @Discord.WebSocket.SocketGuild.Emotes collection.
+> [!code-csharp[Socket emote sample](samples/socket-emote-sample.cs)]
+
+> [!TIP]
+> On Discord, any user with Discord Nitro subscription may use
+> custom emotes from any guilds they are currently in. This is also
+> true for _any_ standard bot accounts; this does not require
+> the bot owner to have a Nitro subscription.
+
+## Additional Information
+
+To learn more about emote and emojis and how they could be used,
+see the documentation of @Discord.IEmote.
\ No newline at end of file
diff --git a/docs/guides/emoji/images/emojipedia.png b/docs/guides/emoji/images/emojipedia.png
new file mode 100644
index 0000000000000000000000000000000000000000..acad16f280413f89a7ec0bcb2fa002ef27f080b8
GIT binary patch
literal 15043
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
PLrt&}RIx(dB;@}A1~c<`

literal 0
HcmV?d00001

diff --git a/docs/guides/emoji/images/emote-format.png b/docs/guides/emoji/images/emote-format.png
new file mode 100644
index 0000000000000000000000000000000000000000..981e18227c086336c14524fafbbf13019bdfe334
GIT binary patch
literal 14696
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

literal 0
HcmV?d00001

diff --git a/docs/guides/emoji/images/fileformat-emoji-src.png b/docs/guides/emoji/images/fileformat-emoji-src.png
new file mode 100644
index 0000000000000000000000000000000000000000..a43eebb6285bfca069e1810423e5c52d67d8eccb
GIT binary patch
literal 23541
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

literal 0
HcmV?d00001

diff --git a/docs/guides/emoji/samples/emoji-sample.cs b/docs/guides/emoji/samples/emoji-sample.cs
new file mode 100644
index 000000000..a36e6f70a
--- /dev/null
+++ b/docs/guides/emoji/samples/emoji-sample.cs
@@ -0,0 +1,6 @@
+public async Task ReactAsync(SocketUserMessage userMsg)
+{
+    // equivalent to "👌"
+    var emoji = new Emoji("\uD83D\uDC4C");
+    await userMsg.AddReactionAsync(emoji);
+}
\ No newline at end of file
diff --git a/docs/guides/emoji/samples/emote-sample.cs b/docs/guides/emoji/samples/emote-sample.cs
new file mode 100644
index 000000000..b05ecc269
--- /dev/null
+++ b/docs/guides/emoji/samples/emote-sample.cs
@@ -0,0 +1,7 @@
+public async Task ReactWithEmoteAsync(SocketUserMessage userMsg, string escapedEmote)
+{
+    if (Emote.TryParse(escapedEmote, out var emote))
+    {
+        await userMsg.AddReactionAsync(emote);
+    }
+}
\ No newline at end of file
diff --git a/docs/guides/emoji/samples/socket-emote-sample.cs b/docs/guides/emoji/samples/socket-emote-sample.cs
new file mode 100644
index 000000000..397111512
--- /dev/null
+++ b/docs/guides/emoji/samples/socket-emote-sample.cs
@@ -0,0 +1,11 @@
+private readonly DiscordSocketClient _client;
+
+public async Task ReactAsync(SocketUserMessage userMsg, string emoteName)
+{
+    var emote = _client.Guilds
+            .SelectMany(x => x.Emotes)
+            .FirstOrDefault(x => x.Name.IndexOf(
+                emoteName, StringComparison.OrdinalIgnoreCase) != -1);
+    if (emote == null) return;
+    await userMsg.AddReactionAsync(emote);
+}
\ No newline at end of file
diff --git a/docs/guides/getting_started/first-bot.md b/docs/guides/getting_started/first-bot.md
new file mode 100644
index 000000000..a33e72aff
--- /dev/null
+++ b/docs/guides/getting_started/first-bot.md
@@ -0,0 +1,263 @@
+---
+uid: Guides.GettingStarted.FirstBot
+title: Start making a bot
+---
+
+# Making Your First Bot with Discord.Net
+
+One of the ways to get started with the Discord API is to write a
+basic ping-pong bot. This bot will respond to a simple command "ping."
+We will expand on this to create more diverse commands later, but for
+now, it is a good starting point.
+
+## Creating a Discord Bot
+
+Before writing your bot, it is necessary to create a bot account via
+the Discord Applications Portal first.
+
+1. Visit the [Discord Applications Portal].
+2. Create a new application.
+3. Give the application a name (this will be the bot's initial username).
+4. On the left-hand side, under `Settings`, click `Bot`.
+
+    ![Step 4](images/intro-bot-settings.png)
+
+5. Click on `Add Bot`.
+
+    ![Step 5](images/intro-add-bot.png)
+
+6. Confirm the popup.
+7. (Optional) If this bot will be public, tick `Public Bot`.
+
+    ![Step 7](images/intro-public-bot.png)
+
+[Discord Applications Portal]: https://discordapp.com/developers/applications/
+
+## Adding your bot to a server
+
+Bots **cannot** use invite links; they must be explicitly invited
+through the OAuth2 flow.
+
+1. Open your bot's application on the [Discord Applications Portal].
+2. On the left-hand side, under `Settings`, click `OAuth2`.
+
+    ![Step 2](images/intro-oauth-settings.png)
+
+3. Scroll down to `OAuth2 URL Generator` and under `Scopes` tick `bot`.
+
+    ![Step 3](images/intro-scopes-bot.png)
+
+4. Scroll down further to `Bot Permissions` and select the
+ permissions that you wish to assign your bot with.
+
+    > [!NOTE]
+    > This will assign the bot with a special "managed" role that no
+    > one else can use. The permissions can be changed later in the
+    > roles settings if you ever change your mind!
+
+5. Open the generated authorization URL in your browser.
+6. Select a server.
+7. Click on Authorize.
+
+    > [!NOTE]
+    > Only servers where you have the `MANAGE_SERVER` permission will be
+    > present in this list.
+
+    ![Step 6](images/intro-authorize.png)
+
+## Connecting to Discord
+
+If you have not already created a project and installed Discord.Net,
+do that now.
+
+For more information, see @Guides.GettingStarted.Installation.
+
+### Async
+
+Discord.Net uses .NET's [Task-based Asynchronous Pattern (TAP)]
+extensively - nearly every operation is asynchronous. It is highly
+recommended for these operations to be awaited in a
+properly established async context whenever possible.
+
+To establish an async context, we will be creating an async main method
+in your console application, and rewriting the static main method to
+invoke the new async main.
+
+[!code-csharp[Async Context](samples/first-bot/async-context.cs)]
+
+As a result of this, your program will now start and immediately
+jump into an async context. This allows us to create a connection
+to Discord later on without having to worry about setting up the
+correct async implementation.
+
+> [!WARNING]
+> If your application throws any exceptions within an async context,
+> they will be thrown all the way back up to the first non-async method;
+> since our first non-async method is the program's `Main` method, this
+> means that **all** unhandled exceptions will be thrown up there, which
+> will crash your application.
+>
+> Discord.Net will prevent exceptions in event handlers from crashing
+> your program, but any exceptions in your async main **will** cause
+> the application to crash.
+
+[Task-based Asynchronous Pattern (TAP)]: https://docs.microsoft.com/en-us/dotnet/articles/csharp/async
+
+### Creating a logging method
+
+Before we create and configure a Discord client, we will add a method
+to handle Discord.Net's log events.
+
+To allow agnostic support of as many log providers as possible, we
+log information through a `Log` event with a proprietary `LogMessage`
+parameter. See the [API Documentation] for this event.
+
+If you are using your own logging framework, this is where you would
+invoke it. For the sake of simplicity, we will only be logging to
+the console.
+
+You may learn more about this concept in @Guides.Concepts.Logging.
+
+[!code-csharp[Async Context](samples/first-bot/logging.cs)]
+
+[API Documentation]: xref:Discord.Rest.BaseDiscordClient.Log
+
+### Creating a Discord Client
+
+Finally, we can create a new connection to Discord.
+
+Since we are writing a bot, we will be using a [DiscordSocketClient]
+along with socket entities. See @Guides.GettingStarted.Terminology
+if you are unsure of the differences.
+
+To establish a new connection, we will create an instance of
+[DiscordSocketClient] in the new async main. You may pass in an
+optional @Discord.WebSocket.DiscordSocketConfig if necessary. For most
+users, the default will work fine.
+
+Before connecting, we should hook the client's `Log` event to the
+log handler that we had just created. Events in Discord.Net work
+similarly to any other events in C#.
+
+Next, you will need to "log in to Discord" with the [LoginAsync]
+method with the application's "token."
+
+> [!NOTE]
+> Pay attention to what you are copying from the developer portal!
+> A token is not the same as the application's "client secret."
+
+![Token](images/intro-token.png)
+
+> [!IMPORTANT]
+> Your bot's token can be used to gain total access to your bot, so
+> **do __NOT__ share this token with anyone else!** It may behoove you
+> to store this token in an external source if you plan on distributing
+> the source code for your bot.
+
+We may now invoke the client's [StartAsync] method, which will
+start connection/reconnection logic. It is important to note that
+**this method will return as soon as connection logic has been started!**
+
+Any methods that rely on the client's state should go in an event
+handler. This means that you should **not** directly be interacting with
+the client before it is fully ready.
+
+Finally, we will want to block the async main method from returning
+when running the application. To do this, we can await an infinite delay
+or any other blocking method, such as reading from the console.
+
+The following lines can now be added:
+
+[!code-csharp[Create client](samples/first-bot/client.cs)]
+
+At this point, feel free to start your program and see your bot come
+online in Discord.
+
+> [!TIP]
+> Getting a warning about `A supplied token was invalid.` and/or
+> having trouble logging in? Double-check whether you have put in
+> the correct credentials and make sure that it is _not_ a client
+> secret, which is different from a token.
+
+> [!TIP]
+> Encountering a `PlatformNotSupportedException` when starting your bot?
+> This means that you are targeting a platform where .NET's default
+> WebSocket client is not supported. Refer to the [installation guide]
+> for how to fix this.
+
+[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
+[LoginAsync]: xref:Discord.Rest.BaseDiscordClient.LoginAsync*
+[StartAsync]: xref:Discord.WebSocket.DiscordSocketClient.StartAsync*
+[installation guide]: xref:Guides.GettingStarted.Installation
+
+### Handling a 'ping'
+
+> [!WARNING]
+> Please note that this is *not* a proper way to create a command.
+> Use the `CommandService` provided by the library instead, as explained
+> in the [Command Guide](xref:Guides.Commands.Intro) section.
+
+Now that we have learned to open a connection to Discord, we can
+begin handling messages that the users are sending. To start out, our
+bot will listen for any message whose content is equal to `!ping` and
+will respond back with "Pong!".
+
+Since we want to listen for new messages, the event to hook into
+is [MessageReceived].
+
+In your program, add a method that matches the signature of the
+`MessageReceived` event - it must be a method (`Func`) that returns
+the type `Task` and takes a single parameter, a [SocketMessage]. Also,
+since we will be sending data to Discord in this method, we will flag
+it as `async`.
+
+In this method, we will add an `if` block to determine if the message
+content fits the rules of our scenario - recall that it must be equal
+to `!ping`.
+
+Inside the branch of this condition, we will want to send a message,
+`Pong!`, back to the channel from which the message comes from. To
+find the channel, look for the `Channel` property on the message
+parameter.
+
+Next, we will want to send a message to this channel. Since the
+channel object is of type [ISocketMessageChannel], we can invoke the
+[SendMessageAsync] instance method. For the message content, send back
+a string, "Pong!".
+
+You should have now added the following lines,
+
+[!code-csharp[Message](samples/first-bot/message.cs)]
+
+Now that your first bot is complete. You may continue to add on to this
+if you desire, but for any bots that will be carrying out multiple
+commands, it is strongly recommended to use the command framework as
+shown below.
+
+> [!NOTE]
+> For your reference, you may view the [completed program].
+
+[MessageReceived]: xref:Discord.WebSocket.BaseSocketClient.MessageReceived
+[SocketMessage]: xref:Discord.WebSocket.SocketMessage
+[ISocketMessageChannel]: xref:Discord.WebSocket.ISocketMessageChannel
+[SendMessageAsync]: xref:Discord.WebSocket.ISocketMessageChannel.SendMessageAsync*
+[completed program]: samples/first-bot/complete.cs
+
+# Building a bot with commands
+
+@Guides.Commands.Intro will guide you through how to setup a program
+that is ready for [CommandService], a service that is ready for
+advanced command usage.
+
+For reference, view an [annotated example] of this structure.
+
+[annotated example]: samples/first-bot/structure.cs
+
+It is important to know that the recommended design pattern of bots
+should be to separate...
+
+1. the program (initialization and command handler)
+2. the modules (handle commands)
+3. the services (persistent storage, pure functions, data manipulation)
+
+[CommandService]: xref:Discord.Commands.CommandService
\ No newline at end of file
diff --git a/docs/guides/getting_started/images/appveyor-artifacts.png b/docs/guides/getting_started/images/appveyor-artifacts.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f31b77a99cac632d79b97ea251fd9c1a594130b
GIT binary patch
literal 7002
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/appveyor-nupkg.png b/docs/guides/getting_started/images/appveyor-nupkg.png
new file mode 100644
index 0000000000000000000000000000000000000000..0cf3cf6c40cec4f9363062e5ac065aeed489e9a1
GIT binary patch
literal 9412
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/install-vs-nuget.png b/docs/guides/getting_started/images/install-vs-nuget.png
index 64da79a9ff2c16ded006fb55e2cd89151b9a2340..ecf627d11ee9a3eeffecb25d4bdb4988a687dbc4 100644
GIT binary patch
literal 49542
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
ND85sum-`g{zW`Vd71;m)

literal 119670
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%0ANpz@+(<vVEBN6KSGZ6}Wc<Lp%HPd4}z
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%0A5*Px7dzYHQy)<9SU*Ha`D)wT$jtj2pp`d
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

diff --git a/docs/guides/getting_started/images/intro-add-bot.png b/docs/guides/getting_started/images/intro-add-bot.png
index e40997ed3ad0cb5d9cc51912c98f9e316f141d84..3b5343ac66fcebc0bd1000f1d1f5c89a4948f394 100644
GIT binary patch
literal 6417
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
SqITv#vxW*(`9DSLH~$9|=vJu!

literal 26232
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
DuYgQm

diff --git a/docs/guides/getting_started/images/intro-authorize.png b/docs/guides/getting_started/images/intro-authorize.png
new file mode 100644
index 0000000000000000000000000000000000000000..66ca4cb04bc05eac6b06cd5057de700618b37289
GIT binary patch
literal 19052
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
Rc=A6%)Es7QTz%am_HRkfM}`0Z

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/intro-bot-settings.png b/docs/guides/getting_started/images/intro-bot-settings.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ac40bfe67af992f70199f4f118166553958b89b
GIT binary patch
literal 5704
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/intro-client-id.png b/docs/guides/getting_started/images/intro-client-id.png
deleted file mode 100644
index e370aa2ecbb1c2e9b98b7f7cd35fa664e1e3bc28..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5109
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
RUQVJ2(AP21F4ue#^It;zlF|SG

diff --git a/docs/guides/getting_started/images/intro-create-app.png b/docs/guides/getting_started/images/intro-create-app.png
deleted file mode 100644
index 7aceb84b41cf809f45b591c6a5a1e6f4ccbbe2b1..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 52035
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
G(EkD3K*%=$

diff --git a/docs/guides/getting_started/images/intro-create-bot.png b/docs/guides/getting_started/images/intro-create-bot.png
deleted file mode 100644
index 0522358cfcb35a17632b03394333891988fc0c0e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 45743
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
QJMf${G&R7Sxqkn@0M<TmcK`qY

diff --git a/docs/guides/getting_started/images/intro-oauth-settings.png b/docs/guides/getting_started/images/intro-oauth-settings.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d8c2a64a81b025cdf44f45eff28b337ff635057
GIT binary patch
literal 5655
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/intro-public-bot.png b/docs/guides/getting_started/images/intro-public-bot.png
new file mode 100644
index 0000000000000000000000000000000000000000..da91366a60f99135e60d5f7f3309292de003f0bd
GIT binary patch
literal 11135
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/intro-scopes-bot.png b/docs/guides/getting_started/images/intro-scopes-bot.png
new file mode 100644
index 0000000000000000000000000000000000000000..fa17deb1698e412f7d9e5b2365367948d628eb90
GIT binary patch
literal 17423
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

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/intro-token.png b/docs/guides/getting_started/images/intro-token.png
index 8617cb76f18a87f55b0219e27fdc7fd1bd7a576c..0fcdac0779d8a4075ddadc4bf980645462b719c7 100644
GIT binary patch
literal 18552
zcmbTcXH-*B7bXk>f`C*JkrEIQk={F@DIf|cAf13nQJQp+a_L1-P>~KnkS4u%LN5YR
zq>2!FmEMw&+&jGQtobpsX4bdX_vhrSC%Zg*pM7qUy%VFSqj8<`HYE`e(RD3N_2)!H
zS3n{n;&BR+OC(njZbn2zLZtV^;Gv|9l8}g`h?uN<%nUY<3xXgqNjV8=1s#hoAOX+K
z^FUfoxuL0b?(e*SkhqS%S$$&*?*pNR3_t3MBS{%8H!pv<jFN<mzHr1wLs>lB&>f*I
ze|CB<rR|_4ql7Ks5pqMmH<f=LT>;`T*dIa&Pe%!vQV|JvO>2KiRdWd$YXcEUar1=d
zYDy_CVkJ$jlu4zDDH(3o`XKJaIIc>{JLgA~F^`E-Lu0k1Ou+r5z1Xr=mXHsJ*_>}P
zS}?OE#xja_FSG<?6hZ8Pj;<kL?{|Iew=_?<_}fYMH|AD)>fXo}N!gG3Zvv{&_^iqn
z{7TbCDks<XBUt&?;ZPE8txsC{+28@8tn~9m^NYNx^SgPQGc)6*u~xD&is_9=hu7w~
zGMUbeV+pyGb38#yT#}<=>Y~#@OIhjj;8AE{v!IA-LteP0^Sg`PeZtXFZqQS2=}Wea
z+FDPdJ9iigC+YHf)0-+xEfAZy3y06u?*c+_wHl&|N|JViu5Ud8G-biFt+L7*M`s(j
zw%HpCU6`}VNG#XIPk%QN$+^#5!uknz5;F24k~ePhN>-!k(_6)#72&5dKDI1K7`Hdn
z{b&ijZ|d}=;*(Q)6AC{Td$hQnUr>B2I!8q8<NMO`_=K;LFCv7*bp4D}%UonYa8cVm
zSyVm9J!bo%!$${q|B~8PLr1sACN3_{jzS`4CYthH5!?~su?cPl9Z@pAW}-9a_~q@h
zzo+X<BaLGA$<E4hb6t6B?H|~E+@^|URTQM14Mb^wY-C2e6#6_!%gP<Ei0k~M;QsUc
zXy<QGMmhg8qxJEXp01wZJhum$N*?7~C3QJ5_SzK+O0#W$x<5=y`Jg7}kA(yN2o+90
z^3SujafpeTE%@xeSnuhZyeJUYY8v#tJSR@q#=E=fZ*f+Lit?j{YNeC_n{VQ>KgRZa
ziYD$lgcqjH@>;qETM4(#%zv$^XiCd|mNO}tIOLm{lu^E=XVwIGIQ=a(DDGdW92oaC
ziho+OT4VcVJnNy+=KCxnqKD#I>M91lfBvN?_WxGC)wiGOc|bRmP)N~aj2F7|zEYn&
z<`186LygWu@}0%c&%+Jq`7{M<YA~V(@82)qjn>ZdE?ktq5hz_0rYEh!N9Og69NAo>
zuF3PDBmVF4%3AB+d3Yl=s&0gxWVznzS*6Fw(p(%yJ^@5s<6b7B`;KZNQo$8d{r}s9
zKWjky`7;Q8O{nD=7&9?zHjwixs-aqJz!V^MJkO?xqypYG&@a<odJ0d#49V{AI=HXO
zCZD{e7;t{Qz9->E(;L9Tp(|Tu?#pZEt@h7aoh_KI7jLo)Iy&SmWhXx#{(J3^|LsRO
z|5u&I1T57zsAD9+!uj`Bv2?*aRl1Tz<V;tz3=vnH-?>!q1R}WCKUcU#M?YXX7qnTB
zzt%tedQbiOjbM5=B30ku&~ukuaK_v+8`!(EpSdy!!^D~uOqZCTY+xJn1j+!STlD0d
zah>zRE&ksIkX~{|H@ASg82`|<csvW68MhJ_D~%gS@$$dH=qnEc2KYsU*L$;t<Q9Jx
ze%J(Tkz1#i<54#;h4tUScg|^Zf+zx7Xad$-2%pky<#x?)El2#yK&jvup=)%VZG0Pz
zJGJ*TvIM43oI$tu<`-`%RO6_mTKVbx|HDI!GA}oqCN7#pIRV_hLb_Ehq>SIeCC|Y>
zacV+v3bXJ}ug2)Xi7*%~p7Rs%)sA!v&YOg@uY!*QJAC8FlXEV@wQ*=<v)n9gotlMz
zF71WSSWk<Ix$Sp>S;qdIRTZ`0&u1KG{}7o8CyBcCYOlEkjrMu63;%i9o~Wz5lecJ=
z{FY@xA;sZ!+6(gtf?r}x9}P{vk^8*`Dg!&4$0X{jIJ2ImvuC2imO940d)1}d-gCCS
zoPG+fMlBgr-p6O0YjsI4j2*WW9cTE2lSJlRdY=p!*c`jfyN`<rULkh_vrNu2lbAI*
zx$NoTa*vzlSR0bW#|8^tq<r$acPyGmeCG{;(T=PqJzc0}Z%}sj*uxI}`?rHlf%y}g
zCxzQ$i4p`0rm)v6#)jVJk+kx3qwoZZZDHoascARs+|8F!zhX6^&C`*YwCv70ltg6<
zy^_!b>dtBRi#Kg|Yy_W*{6@+BT+T~&$$V@!L+M9?BWF+{u%1~dbW2LAJYEoC)o10*
znF3sFd%Zba#e<#!0<#;&VTYuX1WT8@20)!AkZ+`6N;!Sxni9`<oo<X79ypf$v(Tae
z3_9dCJdJgu#`KI7{(ANL%gEJOr1G6YRJOnw8oYiinlGlTjym<aSMuhCX+dO675fhq
z>a@qWvjm1#Dkcoy7)<wlJz>#WYj7x4_lRAbul18xILLU9;_iWoS|ny{%wO92?wTn}
zt}wz%DPKZay%1&8u#<G}qZs4NQ&Vf)1vyeINwif>|6X6_aQXNVe!_1b=J+$_fsV-F
z91kgD6Bn%#q3~-@3{xswjRp3~!mUhvfXzN=@rQa@=Hte3N$XNaUNnWM_BQQv((9p|
zG@qY~y&8TlNA`I6fG+Ai&HK@B4v(I3>3vb=e5Ls<U5CeW;AUTFSm+*s_MI%uqgNd{
zVQPcCXvy#Td!B#JolHlexWA9rV?74$U0EgPTz3_sJC<gS#->ws<A=#!g6mgA0grD8
zR#wjSeeuosT9>(<o6*<{O598KKjTX_r_eS85t50p#5nqty02RcbK+~^bj_z)CyrcK
zcw|V2DQ5>|Ppsd-!k9VX$}r1SXCsiT$@b>UybQ@d(b>AK$FwMPII|*Cmd^nu1!cXs
zE9P3iCOl^A?Mn_U|H8w&zQ{}Z5+9NHn$A|a&X{%x_SA&cJyz}3F^%~7@aR^>Ps2}m
zn(z#F$<QgDt(Ql3;JckON3O^TaNf1l-nvLsp~zAmp-}w(H(ObOnrigsBn#tpdH=S;
z5e(H3TJxYPu~z<7@+cqPje44L__N__4sIDArRQ-PA+xKR>rTc}>8?q^t-6iLuM4<=
zRzt!${QcJwRmnTF!_)c{cEUGf4;$Y-P=LMGE#~ujB-)C6P$pP#!b01NA10+O_D(kR
z)Wb&6h9`U-kqNF{<h(zf!mfIcgZNF=yxv9VjrZQ``!0sqK>|%Ma<K6rgyg(-ROuu<
zV+yOw<Fh(bE*jXYCJLx^q|X!AKMi0B`+nP;PViZ6QtHp6hp|J5+SJ*LXH2a}v`yIQ
z2@^5L(<hBsjc@n<zRpCMZWajk<F^KmjR;ylRO%fwQ9~xru+!rM^)S^1tn2wtgs#sz
z?Yb_c0JLtp-;lprW}4|ot|grrg9^zxLhJlQEhMAb@SYpx1<gY6A>`F$6w@EY0h1NC
zSu5+EyV7mzn;iBwJaJNg2X((SrWW1Z`-woEK2;yhL}k$k6^tHEC1Zat9z_{yQHc8B
zn1aoRC%xkL$Wt4O@#2o&XEgx`a4+bjAE7%vUay3C1)jXZG9I5__q7Ix(5S@-tT+Ju
zr|v>hP>sq%X!HL^S^nSO2C99avZvv0Y<>G*z6sH;QoPc8yLHE*$oTVR#?>?<X)G*M
z3qtSG@USP^X*NhUK6^_cVdp@n!sQ~@+)$g_^Dx?T7qH6WjnWV~=l0$TM2<L8q;{pR
z40v?)Sza;`raP{`ydZOz7i9PHf}C9v^}l4&stiS-@<?eI=C`Pk)Ukb>N`xMjs=73{
z#y7+GH5E$dyg*V>z?#nWdfFE1l(idgtI{&SBk>zxm453@_KfW_(V@ch3Bo{}M7@7&
zU~Jod=quW@a<Pv-)Q@==^f7Wp+GVOSaArCF!n5bqR+v{C%pVOOyq9`Iy=`34_CW;F
z{ZPz2e7<4vD&s$51&Q09iA&avR&$OmsF>6b2whqnMFe)F)VeJ)*^Ndk*q4#%_DdFV
z4f{mO_39+~B4WGmW7IcyuMXzh!-jI?+wog<$}KIFetpKBPxx;m_LRmu&MQSv>DOTj
z1T#2N@o!PbE!6T-lncq-`}a;=Uu?!LU`tNj*>7cfL&GSd>>GH+nYl+(vUiC;-<ZdM
z%t$ada(sL6SQ<V0R}j-L7j;)T=kZ0lbV^MQ4xw;yo*zZjOHL@nM@)?1ZIvH?Ed;yL
zVSyA6*ojAN_C8^ybt$9zl`fS`vDpyi&8_TW=8je<Y)7cZy~A~HlHfmWm<gG|hv4-}
zU-jU}$;3r#^Znqk8Jdb{Eji!WqxRSZp@^2tT!Sw>O9zhk6<?U1@>dOWT}!Z>fr|nx
z3AZoo!DTC^@(lv5@@0AqNeT5T|9Ra6O)kxm@Hd?p!;hIs{?9`nLjPZC0+^9cpS~A*
zKN!xkz!jB6Qngx@&AD(Tl$VK~-gAJ<`r9JUFP_jCV&RT2_GHg!DLD)eXcGk9FPFk@
zX)EtM=No=VCm5Q2<9&1+wtd!Atxi>K)(_tADTgRP>!9aYZUeJ@6(Cr(kN(RPw<ffM
zFrNVjz-lmJ4UMC^N3w%3HU_59HviA%Xbb+>R*s>q6UUqsfGdbjp+r~{sI-*`+R?`U
z3(Zx<P+l6kw}twYogbd|N)4moLNL1W(rr)1u$)v_MO>R{+t-?Mc-BtYGi#wZxXarq
zwBx!Hyp=lb{ArAF9@?`x&zmG={x@9YD4mu*+F5;qt&NGrZa?<UCo?Gh)>Yz{rBtJx
z@!2tjs_b6+4no}y4jGYx0m+-5QY2x@FHf22b{M*P)RzZ%T7%anc&)s3f!#nYrn)<I
z^tBNffof1=VOuv89@~}t<pemnx;WaSr1Xx0<!ALb1uUtAi<RH~$>WnU<~A9fYSVF@
zH)HNYE<1=nRTuHU5#7IhM^2--zJ597{rJeY<jO}gLN9v@AsI9{D^j>+Z4ob6@4&Ew
zs`rNa4wa*y>AyTsiN5^Omm~8}58`h~(gpsE)jL6I=FOARV^6%Z-{gMt{#aHC>W{;p
zzWO*1+=%!dSWSp{Fc`ECUQF}J4HN;goyn={(m^K`3bE<H7EoWbUTRf(B`w#@E9(^b
z8C2iygc-WXLmv#LtqiICPbd`jXalAYV~y0Zrv=Z_XS<WB3zi>Aof=N?yHuHcIz?uI
z+_{Q@PO0yy?_p*)(FhBQHj2Eq5uA^m9Yc#05&=mXBe~Xxs<TN5QC4#fRx&ACJRCb!
zVA9r(Fhl*t&hz)wQl}OPgC(e^fwsBw&w%M!)toZb0BVXD;r6=OkZGI0-v=Z`*y3a`
zvyROuV~V7w2aNvg_=(baU{&BtiOnf0uMX#76eCUq7p1;&@&J9QG@)M*o}9LOS10h?
z;Gb(4^2zp`B@@{)aDsS7Zaj71hD$cHOPHU~RT_g^$Yo4IPH~RejjCUaA;pt*4X*`+
zm#`AwwKHr_0cDWph2GXXO%|m`P#3bg&vO5rg!bVu`_+cUs5D!z0XFc(26o2L6ql=V
z@A*DxX&EqQvOOoBd?S*9838<vTY3SBa2jaF6NmWjD$og0O|fnMzVSgTkTIsV4AfVl
z0yPsj_@{s-T!Df1*t9=VeiTW;s-axDpqAstk^!cfMx5|={`z~ZVkXz(ob%RD``NJ&
zoo%(1{WW7~Ya4O<+E?Ogkfy&Quh<BttYc|dHF-#tMSL|sU`2dvk~BscLykTd7WlG%
zAy2@z!FLcM7`S2u$kBzX{{LJM&gbc^$M%7@DONB&TG5=E&qY7egpS^^kc;M|AXd3e
z;ldJTqax<zwln(5)6>J7qVz_<wKghts^!50e?->8Y*zlW91JflzNWExBg=J9sZqg)
z{ar^SvhE_;8Dsrh+uQ4M1*Tgrp;{0aW_4<ZAW7E>VhFm#uHqrY@zsmw!}H@c>A?cw
zN3D^w!|yh2({60jio^{E0}w{T`c_+J5#o*8yB8vjfz(Ry*Yys4(E5BTren8?Y<Bkr
z*KV7&=A4>A@|ke&cJiNRk3<&H+~D1!re+08=SM$)SO#V&`$@?0bAkYPupf@%|1R%#
z%((Zn#_$hj?y33o;;2c)DeM69!W0jXCF1(fV!xqnG#sp<8jqZWXzQi$q5zU6cI;&K
z{>(4$CAl8u{mzOqDVtDEaRot>o`FYZOnGi<y+?u`g;vc!J5MeB)t^RR4QH3_c3#VE
z9v)weN4;jegSAfi^yIK?44G^C?czFBvDgHmV)mV)nk;2n<CzBC#G8=Dq}s4#muWqs
zLtU|Z-gnHx?-wJPytr;>2Q~W3dmq@-T~(L&cJNxNyM1HJ%p}eiA-dwB@UXwpF|psl
z<0M<fNROe{Qiy41#zYlhNhgLD4$pIkZ*?K=MT}$YIc?wh#HDqj1t|oo6Ma7}v*>A~
zI-yd!%yLR5!S|e96NbZ2dQyHYia>A1GKVy%UmZ@*FG5WTp2`_-65#oaqGnfC68Gd3
zAbiXsDyZ&+_ZsUe%S?8{r}r$6o>4Q%bDQC6FphsizmCy4X?wbV1o}Ctqq&}8j|`H7
zqF<>OZV4_+`g>KYzcr~UE$%?(4v(d)T9NH*{nW4&a<({#0mY<9K!R&vW41V)2dr<T
z{`BmFOq_?ujEBipbM9EwFm*|_OK*(5cn1<m5K!zwXx=UN9M{c4?iK|<0+iyP1QFe#
zjE2vVJU_E$WMxc#xoGuD9y7SUQpnZ+h8HWU(qA!QX2I}t8Lm|nZ<;sJWGekpN+UjP
zF@g@`B=k(<>9T9DT|4T0m3M?eXPOT*Cv2#8R$tNAayrd0#piJZF3z`Pi(4-_(OY-G
zO0iZMEAchNXH(0xTn>?E5jlo)_nzn(Ry^oG6S`DA)S&X_Y32r<94|Q(7tWR>juAz@
zz|+4XT#2om<f*qkoUR`-#IpfSxA7+YG4_QYXc;nwd3NyZmWn6RHsXtDY0%u({IbJ$
ze^$PH#k6)2)*6VvMg|W-h0Aonn4UerUf8X5!7QpMEt)Xm=gBKr-^_qee+~RsgtPQY
zZe%Rxm`}H~Y!4G#91GuBy&ij+Ws^P`Ls{Xgct8^5CI`fQ#B8Hd#r&U>12y%(0=^D5
zUkG4R1H`fP)jFHjgD<a!z#p#-DANjoZh`KFuMP`tabK`v9G}*^&C&zUx&gD#$eE`>
z-IE;%i7~#%tK-YSklOH!XFJrh<H&o4i;y;UJkoC-ptWj$?{b8zU61$g7qG2+_LV9Y
z{yV<w$}g>s>q6eaLq!hH=BrL0HvWXCt?~*FjF<-Zu8)-eBqiRy123`vC*$(#0C^{h
z<r?Tv9Pg@rL+!oO@sTL*xQ`<G@z`5>=uHI824ZJ<N_tvB`*SC&@Hq{*yuD28rkAlT
z8ntuyeEa#o;#AMH%B^73H}t{&^{J*)!OOG`R8O8B`Fd_J+RCb|ZY@;*Ed!q*rTIBn
z4}BT&QukmTk488G<S^uQ3TSs$op^&~RRlY4VOPlZ8>$cVs(tomXt5&iwaCJ?e!S7q
zcDr|YV|D*cuAkeqG}rmnNn91v02pMfBVQ^ciwRHnICy<nUq%Do;N_Myxv~D)%RS@C
z<^2@GAUsMKIb4<ep_-z-d#-PE+J;@4fZyt<n>*)b-|v6&f>0vm^G%BYxh?GiN`b#+
z$;3bWX8D32(870Ge1MW)VLn;k-0)e3O~NPMRT?~b2~r&k&GH=xfp-ay@ds@ifel`|
z?|&Vl_7#x|fy;!YvxvY8@~7O?D>7Ng>Mpk%-$|D|wFqG*aTLS@i8Rm6EkZ3^4h7hn
zWMj-?q#w_RUVS%16Ztq<?q;&nhAG>F@1Dbp3+I+6G8E=zYkAl9713)a3YkjV9_1Sy
z?tYwEaN*;R@edbhHJ31GibdpN*pq(D-J_W6*XYNDqv3Ctb7>V;N6r<F<pO!WL-w8>
z;-?c`v>WK3OI2AUy|upnrPY}*c;CLe68MnmkApeC^|;|*Zjm*Oqg^cJsDXEG8_`Rr
z9UA=svo`vKw@^3YbN7LL?uTo?(0e1LL*5~t{((t~fxCy&`L$PSzExMn?P=;72*342
zsxAwPc$eAe+Y^_z$YvO5x7S-!4mi6^;hlMA`6)CTfMsE=JCVrw7{Lt$8@7$%eI7gD
zO$r6W&WM^tiH?3P7LJ9Pjgh`&VoZ})$}AN5aqsUDYv#P`7F~kFe`tgcfsY>6dgJ-Y
zV9-ex<T4n6;OH~i*tdbl?|8(bq>XtF$R(Moi*H~$0^oC4#LoSn4DpZfJX%8sUlb*~
zj?4ESqI^A0-4_*Chyf<uQRau(5Djkd^W8}Jk<N%Tp7f}mmFl1P53(D=czj?Nt-qvb
z%(O0^XUjDbNd#7U@^56~bm|Z!7}l>-sfTZ5D^Te6HeKt#2$R&Zt;3Ciw$xp#DYmWN
zD0%iP45dhn_GeBoMN)gA)84O?{J@7<Y30=MmFrhuKbqijk8KVB>a_Rwpdh~XUmu7_
zn90Q?ZSkcV!{Pblwf}BHbE&doP(xfYxMr%uWLdp#cvHw7aP0bx!+4kMXuy-?AwHM&
z{xWP{nP9yir;<*QON2*JQ?5Vz!d<6cDN%1=b5bb5#XuMFIs0LiR&t@X^2_iv>c`@@
zRN1?|sh_Hhz7PqE?s3_=Z}Hc&#IxeL+vLF5In>=;s8#+jwz2vAy3hVzRm;&SVIP&K
zG=**^>caUmTNwlUSEzUPErP8HtyCf<C?Dc=<Q6RLJ|cIe;OF`8Hwn6H9ab0lK;2(v
z66bT`pXHf%d33HJGC6;OCUOgS$qW9kv8tmHEy8xZKTq_;?w^tFplPFpGR&wEblN8B
zB}QuEnxkGrnr+NuHy-ZYwR1S4Ya30BalBJ@l%+W)nz}g@<Vhd<9VhFRL-m2<&P&|K
z8LAQhF{%wY{5Y{ac(vAfHPR^3POtf<xJc_d8KKYZ5AgEqNr9u75=#urmOT4xABh1|
zBItShn%?VZ7Kl)AWe7eA+~w5Hxb@&J_faGRk)-fuxy`e)fFy9t!2ayp08Z{+xN(mB
z?`4H5P$xeblv^hieY^~ngqYQE`YJ;X#M*NOhR58Kx-M-!%N1V(Jt`Ysg-31WqT`ku
zdt76;Bq#B&y0feZ7onE8zDh2G)8cfT;{*}vEegEj$)nxbCu&|~{xM%9_)kSe)wEml
z=RBTDTM5e3=@98RuQiPx(Ecyw`nUtOh;IW7Uu!j9MNHVRjrHL4-w3MJ22{<9rX%-F
zwhxE@MN!^=9WA4?WBdd8bh7v_UM9&B7ey)K^?J$iyX}M#JWu2s>8%G1M!=sP*M+2*
zkFFM`BIAxfZ~!vT%avP?O{&@m#rbsGS4u=}7j;is;|C6ALhm1Px=;0POE|}sUX(Bd
z;Un0v5``zs+7Rm3E~`d$bY5=-M)TS<I#%XKed>33Y4A1i3%8+uNzv4AR)xyUU!DWC
zx^(|F;*GzvnJ?FTUR;Jw;C{+ZDT3FaT_C&lzm=C1n~J&~208Ucm(X4T?h!kQoSsi7
z6kfylCoQagBj^1XB2E{_O2oRyy=>2EnY%3M$!(VrVp&sgV?Iq_eUdNts!2-A?Q{}G
zk5Qw(E>K;>g~+KPDmp5p@LSGRi-Tc>sr7Hn!_D-5LsP{^o~>`TP%0gpr%_faIALb@
z(MO8^bV*mPwqJ!t-a`%Nz&UThzCw{IZU4q=x!zhWzuSE4f`l0OX}uL8HSp>`V-4zn
z$jo%4FO8JD@@8YIa?z*yD-o6%$>MC2(c7u7ISI^FGPU`SRDSZIdh{jwv_Bj_$L(B`
z+%K+4b%p=a_>ZfPw9ztG*QcgwfvP8YsG{2enRXNGx@#rM^#11w+Zgj>7p5HDJKy0h
z>}FX{GzoLVBgLJ`*p;HVB4~4(f_i>&d*q+E)nHQzwk^{#pto+Lh`{TnGQGMsk-?;y
zQzR}jPK3t3)|<1M#CO-y5Nyo+h)mg^5MD<SEh-SWeEUmDRXpw6J7lRU^2}AcPsL6`
zhcsfO%1?}bnTEW~U*ayeMVD{1-?nnzf`>9R%}=4v$5Ko)eKJ52m4ikm3L4K5zs2B@
zN{Wh&x7T7SY1c?bnYJB?3QLRXPF+7&+hsdMAbyU-Ed;)ZRyHC?CK$KE!^;$|jmSO$
zC~$wDoa11g6@=%2|2+<y^gqUV)F?*R;8zM`Qz*kBGh(h*AdRH)iPN~NiZsFIhNb{P
z#U+V79~J9}A`Q)<iVC24)b1h^&0YeFL>LQY5UcW)FdGGE&r%zQbowZ<5a%#)Za|}`
z2lZ_q@TC#X)#t8lCL!z7(eGxE4Zp%I-u8QGQOz*TXf1MhGWbiAe>SS=nEWDK(MD-?
z)p^<aG<B?py4@9baiVP8iV<*T7cT}*oQb{^XLHDH^c3Vit%x|SXLl-fe6i?aZXYUG
z0_kSUm!O)h3A-n*#v#panb+!kje*EhdjiW8+EA++EP;fq|K}dE+TXi;YIhNR{2i5E
zQ^4u@6C1OscRizUkxslQU1C%(L0^Pnl;?q5joeJ>EerJ+%DnuCqy=?jDK8kFh&WSx
z=A>a_3KQzNr`B^*y?E2Z$8zDj)*tD2ScgDRTd9RK9Nnt0Z^6}##CSZy^DU!(fWQB<
zw-bVrGSBN&ySTw_q&N-8%u{RM{yTU_^wzF#DC{^6N%BkR5Anw(jn5Y$lCa1J{}JO3
z0==yayMTY9)bpTF9<h#>ZE!q5Dz)&$B_hD}pPucd;p4s$D1!CJdi>hwbCnOt@Sr~7
z<q^iijeY@8ztGQK>WVJ>Tr*3ejeX!$^9+XO;al!yHqoLy-^SBMeqW7LfHF0>`*AGP
z%k%@J?F-YNB^Icfl~%f5;M*_$ePcQ0e!fWy=?k3}CalKPIEERK{&<gJ1d?9km-3GB
z86N!q<Xi0TCugXnE-ii#dOaSx5rNA&FD=$zfw=ta8HKP{0enj@l-KHm8K+l>y*CFF
z`U_vABqy(C-yk>tc4%~9EikW?GKr<N%iOT0L}O-{zD)u}FKD4c9)}MXxE7l9;90f>
zCB)y`HR{&0O(X=qhc~_&0NJd*#X&n4*WYf@HZ$~^hv9c!R?~<-w4A+Mkj+(shrNmV
zXm^B1bK0*0mDTJO;+Zb(>yyOLBcqq?5#@%bPCNc*AI;!ze#xrglN}5X;(JSSX}+m`
zeC8-X$<(~48$*_dXU>-RUDu|sE73%IQ+50s%dYb)=L7Nyh5SQ}PUBaH+o-%jaZoF;
z*Y2Hy)>ZRA()gFv&_SNw?fCJweWgQ04$}yvF0jXxG|U>G87%g6@TJy~MB=NP5H{=M
z4v|OJ!Ew3G8U{U%VQruNha8J%#Wjq6;aiP&WyLeb!P`eZ7XNuB9}RsjbpppsknNeS
zQk1c8^t;9Qob^7-;>#Py(^g$6ss*6NOTmNRChlu}%J2;Zgap2Up&ucy_8yBUSc=O1
zIt1_k=dn(uYF%Z_#e!Mha8<BGcAjF4?Jstn1`bvNB*N8VaprS<O86|%vI|~DoSTod
zu~b%N^JMA%Vy8{rY2Z}~MZW-<=`XM#G2GO2o=c$oyKha=!0%(Uvlj*MsjG=K4%hSk
zlmx*01b%AsrgYl*{28GnyuRO2{O!vgK0;TwVY*@Gg5qSwolDEzR9h(E4L-{C@pFw|
z4LkB%zYv&kN1>(zlOm>{=w(Jw4jHkvap-ylc(G=N@D-BK?MB65`yNFAZzQfd9f?|l
zMg2(lGD_};B4Cb%WRZDK&GV%e<1qSOD}bC(%9!`V3CFKyJym?a+nEWia6@76MMt93
zCwxM+CD?Zuh0#A<a@`Wwg0w2{08?a(?=KaX;<ZtYu|TmveW~l0wHE<7Q^GgbU5T@z
z;fCZOcVPZjJzwv5IWMd3dwfAOd{O{!PxiYikde6*>_?0U4>Iy~0n!KR_@cDqc&d9x
zBheAnC~t-vb{N{Xf>1Z|hbXjJn2K{=x&t2J9zMNQ9~1+hB*kmAgr?%zSK@#j<Uqlk
z@I~{7(qK_MBk<!8ZzI)V4pOc__D89D=;!y|WBFU~&<L_Fce@jQpW@yzvk7i>g_#Mm
zMcu)%0JUBL;50rN?(}#v48C113;E<6=>+O^`v5%<fH!e`pAL9zNk_tZ;lZ>`7s_J?
zUBkfSq^cwtkdKlwL(E!@=#bQ%@_+_v*gn!BPtdw;5{1O*e^`aTWEA<0wa3^&M27{p
z`{CP6BF9*0x%sHNjqEZFB4F;77bKu%UNjJ~0~UF8Bj2z=4SHXkr1oFYLzF&&B>zQB
zLJX_7G%ODI@xvn$mv(vqb*t22q##rzhS$$YgPmT6tb)HF{cR)NhD&ULt~EAXvp`iP
zVf3%BxH2`&#R(Ed@&*A@^L+jt(`d-`Y>z|z4JS3p+r;m;%+()~DT@50j$Wpf0q-~_
z-Xaqmy2($fPH~5xep&am9(U)}-78tQZq$tZd`VB$p}Hg^Po^zTC9gt9rER}#+545S
z%puEQ(PrfKrBz^B;dos;jw7E7)L-ea7dQ&NtF1T#*B%!*P(Y@tox;t^pt0xAz<$_o
zYG^^`EKvBmvrZv<fe3UrzdKuD?;gF4-7~1w$QB0^V8(rd=d*xwz3oU(o0oK*D-$+y
zZ0mVaJl!JHw@o?3ze4VWOFMLs2hg)`A|-k^h~El@Do+oK9=;>+R+cN0!c7dFh|hye
z-X56<X~0(FUq?buWP@(XB;FtLdjdyMRQxUD9^Y+xk;Y>waoNHf!mc3?B+`x{my`JV
zhO8Y8FvSj|OSleCPAp;+(cjasT#l65FbKc#$v@+G^sz$YqbH4aM`X&*{I@at@iN3i
zXCsgQC!;Mf!Y3QXn3+!=3dbbUagA24L|ln;m0unWNu)~G6D`LPj?n({{%;Dg_UN;B
z;xG3uT}5J0V@sIV<`VGZahIWi43EX>>_c|xLlaTSn342OlsOThe&4cHfoByJaJuJ=
znr@!odLsA;Ov%TbYnS;pe-^$jj`TB`&PR2S=Ohu)mbRZ)C#?H>Z;uEDTLKA|A5rsJ
z|CR3g0@q$PFJr}qI5Orn*AOOE!sWGYTvyV{?04FrQvS|+2f+i@mFaQ;Pt@=QOM4ri
zoio%;o_u}N05S!hzBIEG!+0idy)*l+ufDf+=l6e)vh*#snW2=i;gG22rG+Kb#Y^0r
zE`wE~^-Qf>;81s>sba#~++L!EB3!Ms2|_UC7fsqbh%w<a-}?0Zh9|;z){32qhoGq?
zh2mNsN25|XPt)Hz9Bny*ji>)cwXkPjf7jC>8TVu0;DA7<L^p~g3B@zOD8`$1e}3&0
z-ty!KeHRA&QzjoT8iIVa?e-&wH`aDGy#AC;QSPo(Ns{{v5G2Xt>xKHyKfZxp-Ly_y
zf>fgzW*=pR9#Jg4op|%itXtBHQ}{<c^ktWs2BuVBUHfuA|G0GiGnBNe;nF|daWwM*
z&nw6YZ8Nvsl#DFo-&ZDt@rJw<Kl9@JJ!uaK&P5!5INx7LNUu6YWzICK=;M2eh_SlH
zKaPM>wL`VFmJ)DKEpi)aDwjA-)df`sm%qN)gEiib%8E@}6<%`eJ6AHTTW35%mKdx-
zOeZOCiR;`6gM~QWw*<g~0%T}g2K;6}v3`cqijCs0fiRjHmpjk^WjhM@uS@l%K`9g(
zSV`@xCr2>YK>0xyvIhdq6{ggR@;yARqWFLF2Pf)OSlt&7j^LMUoR(_e5STTtdsDbQ
zVej7}TPhE9VxM)}?_SIOO!&F7EGOd%!FEUiXM)%&+=Li&`D^Q`CFVs5;8kO)@b`B}
zi^(mJAMVUt4IcmgjFMqCU&usb6x_9r5bi|(b%G2L!Bye;ry=u+rf)?wukvpLUwP`w
z93ZpH)Gq?8owuTo%FUte`;z1lqbDA$uy^efKVfaVubYBT{3cQFo3Lsm{gC5oe9;%U
z0`4M%$inhvi<503Z-_uN#Ci#Tg`^7cjP2N#ZB+m0FfxG{?a6x7H}MmN5W656>MIAt
za=^7>@(BQjwRy9KCdO3X`ge4=gRu3*)d%DDIe{mcc!b&-EYVALvn9ar26^c3k^i{+
z1l=$Ig&YF#IO%L$0sVn<!DV0j5h%PErAWNIG7S&efs;f+%>6KZRshqhtIl-^qKKza
zUBPDXOOP94u{s%vJ3506%9%q_B7~t!Pap6F-|RC72a(UO*cc(mcaWs*;v@eR=D^1X
zaH0PWTp7_ePrsF09_y?fpxCc!DuyS4v*kwNMZFHAV7|xgW5~!D;jOeG4{ZOW^+N$9
z5-)J~m>qQG{*Q6_V>Ut&BU9_}bIS^&NhDLn(-Go7Fg8&Bzb?);$52#>@N0m*WB%&M
zS%F%;L~Dw&56Bp3@aI1Qz+xFdod|~oy-1af*iZmKX(c=54`aK!!An3028|V~@!z$!
z&19WMO+Q*4I#=uml&~-i^lCrO<i_RbF^m6IrH=I?B{M@}wW%f-Z)fM#j%7;Wms~GY
zjJ5god5F^$8y$1{nW(1D*~=;_YAekC?pOS?Z#Z}F6-`x`4{IOpR4^XcygR#m4*DI7
z9p}5!Z=<y${&9=1aS#$=wG^j){A=+5->t&!^*=^`q+|9ar`VLxJR?P(hK89=!edxl
zy?FmzXYa#V1_-D+4~9xo*e`YnC!E$9aUV?oPH^2h6OPNo9}2(z!i<sv7PvqpYq0>H
z|C|l<%4<UYTZn|GO?B(Wpl&6>!8I~y>b;fsH{=hLEO+Pqpq}!{5g5c7nW6_!0>N`Z
z2^f^_Ah79pf|+hmZ>n<5`T-xQ8M`xq&RA1ADV0j2?1JZb&a}5*J&1y-!Gerc7nd#h
zw9V!v^f8wsCv;%+$JGV)w8vJ(Z#D}K<I98Xg~`i*vbof#ZiI#nn=b378DoIqto=uY
zKvW<4<wD5T6AnO?5L@5Ks}wc=juIL<`+#sRCx+5);+_za=b3F?q~kHr_&pKJxAnEH
z{zi@HrA9Y>zjtIC#=M92M#0q^B%7iRI1m5p!vor{_bs*Xe2i4kes_PeKJc<-+hj;y
z>~Noc8?pKIIB3^!>45eg$c0hCv4DTJ%R6D@)k`!Sw6tUT*%QY6T`Gz$z3sdQ_C|%C
z<sm^l6o;3e@Kj@hcfrJ%2&n$wpR91)`Oz}~*ScRHFbU_l;_v`R+yxu$&7JRfois0)
zQ<kI1`7^}d%V{c$vrKDgq>SiSb??Q)%z6G8i06{k5T7d*VYm_!pub4xR{FR+0hw=a
z*q2qpyWlnH_6J61LR5Q){`qH%OkdE*8gY!x`2Ds|22kw1n_wzqmi$DV-Qd9XPceAF
zsk?5$1p3GwdGI&uU*V#?lJS=gU3NBmG9Zd0ulLl-$4Thh^z5QNRa=+_10<bljIkH=
z;X9`c$9WXjC{!o(Ulb6!jBngOmDcbR_91?i+XAdCd2X6frKMnFu;iB5Z{=e9WgUK&
zUtxvY9aryQ8yZ{CFGw~Y(*|m%?EsZVL6QlTknLqi4wc-na{V2Xe9LXJkgPQN^ZpNU
z*G{9#u)^LYwa!dOp9Z=MVq<hky;)y3Cw;|qlat%Y<qAhhz5DsiWYXX?e_kOOQzGS(
z({11I6@!qdJb*M;6^kb0sJI(<T;KiD75gqK_wYI4^rQK<&>?fhXpA_|B+5$Zc3hDC
zQ1Hh?7g^g!a0Ryer%_o|qcPoxb}^${l?kVcrMVz0cQ(8Tq=yJ8z{b?jgOi(c4FZGa
zTKFD*cNwwQr+s9?;v*u|_MVPB=eQ4n9j0+?n~REdo=p=ZY)`J6tm-WbTgJ?#Y8Asd
zHh;e;ke2+`aoJaR{lPyoDUW$e&ed1M>(%9W0Od>ei&;(>EVwfwpidZiK_X`e=-!k`
z#>CdQ_LS;O?=G>0eF4s>#w7P%`?>p5T`Hurdda-~5{yiSj+aN|u7K_y+%XXOQeE9n
zUgKoJLl==J18_c2zdGSLq$ItjvMjuda&^K*wTc_N-Hu+VNK3S{REdxsGCvig9aW?7
z{cNtP<;oW_qwR6Xz^AIa&PGeMMRjs*f{gYZeFUYV=V{eq&zI+<WMuS*NUlGh2THD2
zH(eX*tD1i$MnZ)M%DgMiqM-?OSP6wU-UWG<T$^QGy?o3+fFreF8Wmzn?&cHwts&c|
zD}bx?F}}a-jF4L1P*R%_L?TohKA09eieNitiydT`eZAOBEg1vNBZp!_DR8=9Pwd-7
z{+Or$DulAkE6I|~IS_B<G56+&e;MQbwOWC={UPS_KbDXA>S2VueMrj?Do(m$bZ#am
z2FhxfLN7Lj|Kj5Q{Xi29UipFxOW}Hrn-*9dd^uf^vM%LhfCJT2<d2^`11b;$klk7F
zMfs^~7^u2WZeL<o2nU*Z^FP^Cca6j7<$sYBGWw2YC4g?6CxH_u`)2R|;gov;l^rxC
zAwm@L)C-j6LT7B;NWYhrN5f5;nF><SON|6jM*Wr$I(sn=oBbp*h0ub65GH_w>JC~q
z@swF3@T$;{e0X2XePQIouoTX0DFX5Ox{?$zn_o*y8Ys}y>7dI*pz;!Y`2JB1XrX2S
zrRQ$~wp;I?TdjT%8R)2%I9^T@&GaCjC}?0~+@&wP_Z?*gf2;ox5Gu=~aDB9c7M(an
zSyPS@(~qOr_GAx=OoB!8J#Vh1?)cFx`ne?Gi1YN?(^G6cdig20;N>P$gve0P+{}yM
zr)CPde9J-My?7;TC))r%(b;APLETUW>VJ>NW%(R0<B=6NKYq{1LlDl40)wYej`z2O
zk%zH?Q50LW6wIY!g&Mx|ttY|-U8FNN8uGK@J})ewD#22qKyMm3f@QdNlyVY&VlOL2
z%l)?dL}O?rdF05?a`<!~Sq=u40?9J81Z29`;;fa<gDqY2HyrO_`xC-zK1aCik*_Do
z^XI@Z*S~K@NY?rD@=3_{5MHA5f!!2J$}WTN6SQ@S>X2anwV|*MzBygsWgp+y(v9NF
z!NCMHcWVN5zJyu40Nn`%k)m2J9(mm3FNKtLC!jQgCC;N;T!jWRXTw)VGYmMwwEn{z
z^I!~MfGTbu6nuL}_%KJ6E2^ipgVL2hjWQ8-550fvWYB)cNs8;OpCm(b(L|uq$U_sT
ztq`hTip|#ztOYYy0!~miS!BJwH}m|GURJY63?B8<9?YKZUFM7R<SjIyTl|XQ>|a5W
zq#Vat|KXVSK83eml?p8b0UplUbt|HE%fG83{bXjYk99@L$>oFXk>b{;b6Y;Apr`qR
zZZm4JzqtaAo#Re(mw&44(AF3LOJn6kLL%wzntAC)H%^4PFP;#l&+K=WPMN2oTfsw7
zKQ}7MH*L3Zz%pV2b*rE<WP~menI-gPa_g?SGw(DS#VXwHlMtjZ|J4%VoQ$aNoj(XK
zfZQ8q%D#M<f;kj}72`c*hl@W^Q_z_x{<hyi7d&=XxI9Q|3}|B0;cDxP7>d`iw1kJm
z4<C*F6qy?EPR+Oxg%`4L|2@4TqRv_d$%P+{sqR3rtrz5Ox8IY<fJfqu4$76;v87+W
zgb};#<rj~3@JGvNlIJZ7>Act5OnCV3IWKSDi^65jyLu{1lr&lO6c$Y!WMr<-4yNt>
z8^r_D;QMQqf6&QY;?vDK$h)YP!P=BM{NOsh;jdrFL8f1zzt6%F3RSjy44ocs3~#=p
z18&j-uRa#;;N>{xM?Qj>7-2G3VT>?G&r|%_-fADoFW3m>O>ZQ|=FbuNw8Cfe{$6AZ
z=J+dea}2h$-?~r+Fdo@!V`0sHwim{Mv98O;VO{utr0w-*Sl5Vj>BCot?j5Kq?c}!O
zlQozJUKTgTD+CF9we3NlMnI%pHT1#AUzeW(vOHfI`HpuBh2HJ|BrQn0w!DzKDB#In
z?hpL?2P166|HAGE{Xi~GUuj79^f_cE>W2MJ0Y(%;-xXmrG=Sc4)aiAjpt8jcdrbQ|
zxht8pLM(Qq7uJ?leR{f<nVBj5VQ<>4)!L$cSQY>`13VPW{uKdAXG<Zql4kd-9xyJ)
zzaE0++wDD7kpkQTFiT5+be%x!6}4Eb4VyE_K7T^@)E*R(@Nl6R$IM;Bpu4_8n%?24
z!kvau*|s2Sc|7G|eCibbo9ntM>}YL7gQMjr@MPEbCMa`)mmH>pQnrTCuIaK<XCBKi
zL0QP58xi*XD9UnjsPql3=OWNHtDu38O*04SQW}|pZ{pK)e?Psf%Dcx=A*uQ#qhTnY
zoF#fFr!E5pg5;dZaP47ql??C*Pc`EX{<(k=9rA*5M~G#FFkvj6!!C31^1l+X9?Tt<
z2L;Iuf;yBKH9g6%FRm-g0g<5o@nuiAvC-rT=Gf`v%0`bC8L(OVG@{m@j_>07$dC^6
z5i-y~=UoFi-mmx8*qqtsCkAlw{Hg6}V8Re`aHJQVx=U;kk6|u>j;41(Bv<flP=Fi2
zbAk`~uL7leP=>0+HDLRr?J{t0b>!tke61$SrGqD1weL97frhiL@uPjy7d=&vGEh(P
zu?FU#DV~r^l^qOhA8sVB$o2#Dhr*T*uxgDwr=y6gDh!sZA|C*I1HVo7Wf%f}IDLm6
zAm|VY1<Qd$I+Y~8+-!co=%6bFDe%ASY0qyjkQw4>FYK>HBJGlCK`tO2!_41<uXOJl
zGB2POV?eb&><<DVnac6WNU!Y3WaUePTx<BsY*)J<Frxl-;WK1-g~ycKsFv_qJOiM}
za5TM6-5!sBfQ?$*)pXK23(44cF=G>T8NE5iCi!n#YEGK}weK71iW&}m)Gc4QAl|F7
z?1$4iEf||Hon;b;=q_)N*-oOo^6ToC!~Xjf7<xePXFPmeSN_^R-9SD4#MiHWRoZm>
z=B*2Ugu3}@jYFeRG;2R$&Fs{3>wqI|*j%=NhRA5OLFN(1N0$#mu5zpbLEVUW_w|uu
zl6nNA&PAZ~fy(QT2cb!M144dT8$_3*^y%CTjK=XGiO<aIT1P|1;;BESzed>;1ND&H
z?nBxR@Oc+Ce02?RWTHCWNPYvB#+VmFkX&&Ucj`)@J48Gm+bm}WDp*FYa(i?G55=bP
zWP@aRiI!1!Sa!y)cCGFb{TJn$`}nKqQBpMY{?#hXNkrs``c$JzT<{7##I)t(f6jPY
zgQ<@gKP*2);$z%A+?1vodTQn55T{v!<>t9LYrswVATjtZWvFI!f_e$vw;Rud-$h%!
zzA`m__4(sN+Ow(9sGGuvoV!Kp?+Wj%a)w5!(sJNi(QTRNp*FvjC*E=~U(TO4%?_o{
zmK^xG2JP?u+g|0UC#7%nBGNglmM1m_$zr~E5TPE^uqzAW#M7?)7jSI2uW~Cay>w}X
z&&NK$rk>&rmiexZB^SQas{?*lQAv7|%iuhP;95#z3<muWR(Vr$QrYwgg_8c@^X(L)
zz2ELU%?%5BZj%uIjb5t#%m>~Aef)ck#ChNtSliF>TURB;=%R`LK2NhBGO42A4HN+2
z<QIw~#mH^;qLJ!_PaOn||3+a8RVm5Btzw~f3AR^RqU6Io;z|cHb@un!Ltt+=ZfJjk
zc!ArOElhoOPV5!xs9cd4nkDm!@8EAE>m(o;*w_rNXIn%ux5SfSTzxak4TR@a!LW;w
za?g*J<}59SraR?`3rya1S3l`EkP^PVp|FVL>E6iyF(Zke%_0(j=%8YPe;1xP>mC^Y
zt6edA1gN{X<|lOjgW9y!h@ZZI1sH`lEZq+cTBc<c)v_d8%rkJ53eAgKOoCour-77%
z^(%PhGv7hUWpwow!KdIts1d?8inz@w{m*rL<6z-l$lFC-kkLT7!avQZba9{M^X#3%
zHP{b=E_##Z07(e!P3Hz%xeeyxX)PP)&{%A{%d#%!Yf!-eQchVw$>?s`%<KJ=r6lNP
zEDSToubsh>K+{7T26Ut3_J+yc!?3PhbMnKlo*DRpEhZ=ASowAY9fYBbPAC5t?r)DE
zHUX_ciom0}hpu(3k095nR@+5jqw8Y69ci%(YdO5YRoy0xm@8c$RHu^WNRnsHL|I9!
z@epXv3Hs#Gw|~{jIt7p=mTkJOsB#V>RsbvZBoW?nYtfpw1+>!=x+6BJ)!r;pPbHa^
zb}Fvc=+=Q}iu_W5Wlj@sHi{ZgIEun+2)0MBIwq~>z%MB88-ej&o}T9L!FqT*T*%P(
z;b6kb{?mGwkjY={bQ>KJ`eU#u#3M-cxO_N-@vTr}>V#sV`t+T(L5L-2Db_~#z&XBk
zlgrP_)94{8A7=U#Oig#8(Y7Z_$}WF(CT6^VmxaFzb@dm3YP@K3c=6_vs);}=$#;&y
zi0rn{U!dJ3XzHy-pGm{T(0~oQHo1$BXMd!T^~yLscuPW=3iY-ocZGm#e7}a22U_>I
z2ugu#2sp9w-xJ#a{K71XGC>;Je|30#x+C0xV7vGP+ckdY>43q_a=Wr$B+|0W`@eGV
zjX{R*jfqo#;0*%zr2h69gR)1`E4+k$%LpB!6f3eC0y3N)xY`eFU+`}5Ca)5qCJMve
z*1*6-WB^35q1$$bpDu@wAOkKmX`Pl4YV~@Rc#n<!+Xsw+k7wW!&cL!IS-;=OK1(mI
zKy5vI8Bz^{p3S-wM-t}jmz4VZG6kUB<$bY<;z`Bt=)c4>zqX0i8I>1$M$Gh%vpu7G
zVOQ`d1ul&sKL(2Kqmksx(_YC-2n>VR{}59%>4A7`@-z@~q%?$lkE|ymjP4*>0!arU
zD*=cN>(LSCrF%=^(LT`w`CinwD?gD?M4!$<xpmT<zdPR$te`D^z@%e$rvY;eBJkDL
zX86@%c-toJ?}8LLqB%bH_P6Zn3-}I@s^OsV#3LGoI=IG5QGyX>>+uuoIU0#Uu{KV`
zbFG;c+G-rdXI+_b45DP<Z6*TZG@ULZNmGp34JUoTIfycLyU%jihl|pW!wj=$WADp{
z1KrJBjcbVLSHECg=Hfw-{ki@`b=CL4%r0c*)TG5Aif$kS?nTrW^B^DvxhX5MBz-&r
zJ+xkmJTwD)G^g-<cijKEdOaCCNyj$-wZ-=GfCp@XP|jU{@P_p*+;w*4F4tAso5%l%
zFyUABm8$V8<NmH+t(z>RB=V@)=Uz;?tPUVK9WmGOl6X7tkgmFq_7JUWhm8_nT+&di
zu!~fh84(%TwY~9%a((RdRsNQ-2gg2}^U0Ug%C}vNA2viQr0v1z*=(dLW-IPfII59)
zfCEl?NOfr;tmN^<qx?HqxLh@xcEkB!a0mmRUWJc$0-OMNBPk9p=zVV;sX?Z$Tj<tQ
ziO<D+Q4Bmmui=YGZUt11zO;W1`gsy{($XI!3qZHP!ays^jLw3#Nuy72JPpV6x$l<)
z`P_Vl08G~w|8F(^EF)wxiuy+<9v_ZRp{SE0hLMW?j9kEY^|H2f*4Qi+JekI=JvvsB
z`NzG8un51N90KvooZk#XR;e5!E&hsAJp2=^z-5uiHk<+H@9`$e741ZRhDfrmL?74|
zC81(~)1nx)p$*h?MCn2)LLdK)=+B&yBKN1~zgJEt$9b&Y=R(-@;*y==ND$<&B{|or
z6d#$Q8Da}1pqie~5lzv(n;Bp(_F<hno8RXzop0$C(s7#lK~mwIef)5f(&pddu%UxY
z4^5C~o;SW?8TB@|*>RPw#=^$Q?Y->?`X93AKzc%vE-M(NMApv%R~H$C+if?SaD#ez
z!C28A*j3ZT$iws>;vVjg<;>JT^4C#4Yp)}}MTP3O2ViC@^+HI7MH(}E8TCfc7p%^)
zQOc7TE^prldicW3RsEe$fV4ljB_AB!F=B&(Z_;pvJ7Rf-f;g=~r+^;=$b6z8#vkNo
z$Q5>s@+R7{Of=Okuj$=-!QlT0#0ES0p3WbS9r0uuJ9gch*i)Zp03Bt^fgSme<33Yx
zH(dL}(2t$v>SXtW;m=|#pmg{lA_@O;*>STU`Yr!__(KkynV9V+{;+mAdH+3q^rvH0
z);_xPiEJL9Yw(9hRQ$(iX07qR_{KFjJ79bE{LLL8>S~3?b~j4D%jJzQ^5?`q>p3vs
zxBT1T4+c%e4>YObXG0Y~GO}!;;^&~8m}>m#SQSu?&2U(Q|HThZ;Xb$l0{gb`-+*pb
z9p5|$`#}z7&p*Bc1TT4uEBc#3c#-^}iEEz*niYP_KRy4eH&>4@UY2HWO&>oD%z{(j
zwM_<THsRFwsR=pty#)tu_LVNdsH~>G$M3De%(Z%EBFvv2w!S*OZyksC!^^d<btryd
zhFiKc(K%WjpY4Os8Xdza?}5cRwjrm>{mqr1cVH)Z+{WM^wXFG*koYNp&p!q~d_g!Q
znx2dLAz}Zn$OgaVzZL#fxvsb|#d={ia^a7@h=osTQVX9@zVz4U&!5`^tCar2=ir?_
zc&LRx?h=3f*v*>SyMF)NJZ_r&2TmEiuui&pxUujl7dgSc_uE~3g0M;cnQ3{dS(#H$
zIWzv6kk~met@NAg9t`2r`Qz-A2l!*H)V6-hzv!2|VTa0c>PteBbbz?J2hFQ52<g-L
z!yP=p34L^8yZ9~tqVq4o5@?qEISEPR-^U-V4edKFa@PD2f6=@`2zGPiw~E^ie#^h`
z{D)RxE}k8K9wVe=4ik`wx(C1U2D$)`7U<#$2aadzFiIO0kZ#_->RUkmp=75&T3tH*
z^4p=YA1H?s;!nw>0|+;se**s%hZi|cg%vJY;WyU@X8iIyV#&vmnic3)giZb}E#ddp
z%YW%d{`UDh6<*|299FnwgFn7Jj?xd&3x4ho{#-?8sPQ+Q0n!Zooc|~PB>v0A9seDt
zQf9?VJNgp}(ftd#uU7Ln@Hg%_E`CKq46OSH-HNdP<S&EKBs-RWvhn|+qNa#re>?oa
zn@)rojI{9AMt@cHaCt)~0s~56Y$5%LuY|)rlkngE|L1@W+bR6Hfrybw41XHOod$a~
z^@SgXn7MLDiZ{dXa;1#?A^*YOc7OsVGyTLL!bGh9DE$rl5XUcu9Fu<&R_>;|5J;3O
z72uy__!riH5z}tbPmalm$qDg~rmJdx9QoB5Am!*UH}j<L1rSiFEB@T_-<@d}zqVu^
z+XIaJ)tZn03rGEl`3oxi6L$co0`t_+=x?i^U6*$BlPlecNlPSuTJjHm@noZa<1P<`
zt^_qt0o?LKh+pxSf65O3yD#bSQ&=hbHPcxCQT#dL#~X-R^>^Sq34diDZ%rovE_D1D
zso(P7y=iB{3zUN$0Nf=y1DJ~+y4V5l&|ft0r=eeq)&cb8d8qtT@VEGjm@Vt4&!Z*(
zkVI#IDE!=C^ubvG>W||e9{SawuU9}6x?)J-r@`O&ha%_rJL{9zZSvvILl*p*uhs$h
ze|G@m%$GZA=tupD_;W4sQvkON@G)5UOa5iJh23L=&xcaTmq2%665|&{A-LQlO#UH>
z`Aezz&EW=zex)s*KMnn;R~0?+Qvj@ceE$F+^~dtZN5O8QV)+*)>4$#NGTRmDPXN)c
zSNRJ+j<1%-^XKO19RU53{tD@@5PySxh}@0*7xD71-I%Rj)=bvrrl5aQ2M}?izZ01C
z@&x+nis<GoK1+_rM0WsSE2)RZe%uT-5b-zQ$FAbPqh8qBzaU9d_vp(#3SY}cM96jj
zX8ytJ90K^`_)~C^h-SZ$b6}8<aj5V|{Zh8#&!h0;F6zYr_=!itf2&)-cYf^3q+ae}
zt;;=94sK@JMpFf(=?}fuMf#)phu+%j_(OlFN3<@20(IiAUhcxEyYl!5{n9?PayKw%
zkn$@9eBa-$Oq!RugyI}t?*}AQ0VV4It(?JqgK}`_H}FTxv;%jDd+-F%+8rcy<gX&{
zOZ`57&ZFucXoUUTQb|;rXAKAbJ1chdFGiAI(=Q@tyHxCirvS27klz;ntwm2`u|MFS
z+-mqizZ9vKMmgT96M#1K<KwAwgG2mj&f5&~kJJzQ0epv*SaWaJ@-I%(%y`YqJqWQ;
z82SDIP}Ce4`ICR8m8$+&{8BNR1iqN2eSPRxx73Xt#lPGPVpgmF_y7@w58UETyyW{A
zQ2JZ`1xd<l+kmcO!kAV8ak-y1FVIf_qV-xIRrRBPIL1!|epHK)F>26<TP=-E{>LA>
rE*_=hC;nX14>xKz*Z0pX|H9;7D*x-vPzH_$00000NkvXXu0mjf)arxg

literal 26594
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

diff --git a/docs/guides/getting_started/images/nightlies-vs-note.png b/docs/guides/getting_started/images/nightlies-vs-note.png
new file mode 100644
index 0000000000000000000000000000000000000000..0dcf2dea30fcb966758ea0b782eeae80a8772cf5
GIT binary patch
literal 10162
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
Is$JCo0Sye=Q2+n{

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/nightlies-vs-step1.png b/docs/guides/getting_started/images/nightlies-vs-step1.png
new file mode 100644
index 0000000000000000000000000000000000000000..a399ca66c2c67d23b05d1e81d06b87cbaf294ad2
GIT binary patch
literal 13372
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
Pf&di-P5CNWi}3#kWxrTY

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/nightlies-vs-step2.png b/docs/guides/getting_started/images/nightlies-vs-step2.png
new file mode 100644
index 0000000000000000000000000000000000000000..75cecbb8d3c8328ccd4106e7b78c1d9cfe45b03e
GIT binary patch
literal 13713
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
av`a*|v&ZkMX`X)J0jMkMDAg-iM*I&i2s)Jj

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/images/nightlies-vs-step4.png b/docs/guides/getting_started/images/nightlies-vs-step4.png
new file mode 100644
index 0000000000000000000000000000000000000000..6462ab994cdd3324a950897c9d7e652527194470
GIT binary patch
literal 8214
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
JRKKta{y&U#9j^cY

literal 0
HcmV?d00001

diff --git a/docs/guides/getting_started/installing.md b/docs/guides/getting_started/installing.md
index 5d4c85d81..bb2592c02 100644
--- a/docs/guides/getting_started/installing.md
+++ b/docs/guides/getting_started/installing.md
@@ -1,146 +1,136 @@
 ---
+uid: Guides.GettingStarted.Installation
 title: Installing Discord.Net
 ---
 
-Discord.Net is distributed through the NuGet package manager, and it
-is recommended to use NuGet to get started.
+# Discord.Net Installation
 
-Optionally, you may compile from source and install yourself.
+Discord.Net is distributed through the NuGet package manager; the most
+recommended way for you to install this library. Alternatively, you
+may also compile this library yourself should you so desire.
 
-# Supported Platforms
+## Supported Platforms
 
-Currently, Discord.Net targets [.NET Standard] 1.3 and offers support
-for .NET Standard 1.1. If your application will be targeting .NET
-Standard 1.1, please see the [additional steps].
+Discord.Net targets [.NET Standard] both 1.3 and 2.0; this also means
+that creating applications using the latest version of [.NET Core] is
+the most recommended. If you are bound by Windows-specific APIs or
+other limitations, you may also consider targeting [.NET Framework]
+4.6.1 or higher.
 
-Since Discord.Net is built on the .NET Standard, it is also
-recommended to create applications using [.NET Core], though not 
-required. When using .NET Framework, it is suggested to target
-`.NET Framework 4.6.1` or higher.
+> [!WARNING]
+> Using this library with [Mono] is not supported until further
+> notice. It is known to have issues with the library's WebSockets
+> implementation and may crash the application upon startup.
 
+[Mono]: https://www.mono-project.com/
 [.NET Standard]: https://docs.microsoft.com/en-us/dotnet/articles/standard/library
 [.NET Core]: https://docs.microsoft.com/en-us/dotnet/articles/core/
+[.NET Framework]: https://docs.microsoft.com/en-us/dotnet/framework/get-started/
 [additional steps]: #installing-on-net-standard-11
 
-# Installing with NuGet
+## Installing with NuGet
 
-Release builds of Discord.Net 1.0 will be published to the
+Release builds of Discord.Net will be published to the
 [official NuGet feed].
 
-Development builds of Discord.Net 1.0, as well as addons *(TODO)* are
-published to our development [MyGet feed].
-
-Direct feed link: `https://www.myget.org/F/discord-net/api/v3/index.json`
-
-Not sure how to add a direct feed? See how [with Visual Studio] or 
-[without Visual Studio].
+Development builds of Discord.Net, as well as add-ons, will be
+published to our [MyGet feed]. See
+@Guides.GettingStarted.Installation.Nightlies to learn more.
 
 [official NuGet feed]: https://nuget.org
 [MyGet feed]: https://www.myget.org/feed/Packages/discord-net
-[with Visual Studio]: https://docs.microsoft.com/en-us/nuget/tools/package-manager-ui#package-sources
-[without Visual Studio]: #configuring-nuget-without-visual-studio
-
-## Using Visual Studio
 
-> [!TIP]
->Don't forget to change your package source if you're installing from
-the developer feed.
->Also make sure to check "Enable Prereleases" if installing a dev
-build!
+### [Using Visual Studio](#tab/vs-install)
 
-1. Create a solution for your bot.
-2. In Solution Explorer, find the "Dependencies" element under your
-bot's project.
+1. Create a new solution for your bot.
+2. In the Solution Explorer, find the "Dependencies" element under your
+ bot's project.
 3. Right click on "Dependencies", and select "Manage NuGet packages."
-![Step 3](images/install-vs-deps.png)
+ ![Step 3](images/install-vs-deps.png)
 4. In the "Browse" tab, search for `Discord.Net`.
 5. Install the `Discord.Net` package.
-![Step 5](images/install-vs-nuget.png)
-
-## Using JetBrains Rider
+ ![Step 5](images/install-vs-nuget.png)
 
-> [!TIP]
-Make sure to check the "Prerelease" box if installing a dev build!
+### [Using JetBrains Rider](#tab/rider-install)
 
 1. Create a new solution for your bot.
 2. Open the NuGet window (Tools > NuGet > Manage NuGet packages for
-Solution).
+ Solution).
 ![Step 2](images/install-rider-nuget-manager.png)
 3. In the "Packages" tab, search for `Discord.Net`.
 ![Step 3](images/install-rider-search.png)
 4. Install by adding the package to your project.
 ![Step 4](images/install-rider-add.png)
 
-## Using Visual Studio Code
-
-> [!TIP]
-Don't forget to add the package source to a [NuGet.Config file] if
-you're installing from the developer feed.
+### [Using Visual Studio Code](#tab/vs-code)
 
 1. Create a new project for your bot.
 2. Add `Discord.Net` to your .csproj.
 
-[!code-xml[Sample .csproj](samples/project.csproj)]
+[!code[Sample .csproj](samples/project.xml)]
 
-[NuGet.Config file]: #configuring-nuget-without-visual-studio
+### [Using dotnet CLI](#tab/dotnet-cli)
 
-# Compiling from Source
+1. Open command-line and navigate to where your .csproj is located.
+2. Enter `dotnet add package Discord.Net`.
 
-In order to compile Discord.Net, you require the following:
+***
+
+## Compiling from Source
+
+In order to compile Discord.Net, you will need the following:
 
 ### Using Visual Studio
 
-- [Visual Studio 2017](https://www.visualstudio.com/)
-- [.NET Core SDK 1.0](https://www.microsoft.com/net/download/core#/sdk)
+* [Visual Studio 2017](https://www.visualstudio.com/)
+* [.NET Core SDK]
 
-The .NET Core and Docker (Preview) workload is required during Visual
-Studio installation.
+The .NET Core and Docker workload is required during Visual Studio
+installation.
 
 ### Using Command Line
 
-- [.NET Core SDK 1.0](https://www.microsoft.com/net/download/core#/sdk)
+* [.NET Core SDK]
 
-# Additional Information
+## Additional Information
 
-## Installing on .NET Standard 1.1
+### Installing on Unsupported WebSocket Platform
 
-For applications targeting a runtime corresponding with .NET Standard
-1.1 or 1.2, the builtin WebSocket and UDP provider will not work. For
-applications which utilize a WebSocket connection to Discord
-(WebSocket or RPC), third-party provider packages will need to be
-installed and configured.
+When running any Discord.Net-powered bot on an older operating system
+(e.g. Windows 7) that does not natively support WebSocket,
+you may encounter a @System.PlatformNotSupportedException upon
+connecting.
 
-First, install the following packages through NuGet, or compile
-yourself, if you prefer:
+You may resolve this by either targeting .NET Core 2.1 or later, or
+by installing one or more custom packages as listed below.
 
-- Discord.Net.Providers.WS4Net
-- Discord.Net.Providers.UDPClient
+#### [Targeting .NET Core 2.1](#tab/core2-1)
 
-Note that `Discord.Net.Providers.UDPClient` is _only_ required if your
-bot will be utilizing voice chat.
+1. Download the latest [.NET Core SDK].
+2. Create or move your existing project to use .NET Core.
+3. Modify your `<TargetFramework>` tag to at least `netcoreapp2.1`, or
+ by adding the `--framework netcoreapp2.1` switch when building.
 
-Next, you will need to configure your [DiscordSocketClient] to use
-these custom providers over the default ones.
+#### [Custom Packages](#tab/custom-pkg)
 
-To do this, set the `WebSocketProvider` and the optional
-`UdpSocketProvider` properties on the [DiscordSocketConfig] that you
-are passing into your client.
+1. Install or compile the following packages:
 
-[!code-csharp[NET Standard 1.1 Example](samples/netstd11.cs)]
+ * `Discord.Net.Providers.WS4Net`
+ * `Discord.Net.Providers.UDPClient` (Optional)
+    * This is _only_ required if your bot will be utilizing voice chat.
 
-[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
+2. Configure your [DiscordSocketClient] to use these custom providers
+over the default ones.
 
-## Configuring NuGet without Visual Studio
+ * To do this, set the `WebSocketProvider` and the optional 
+ `UdpSocketProvider` properties on the [DiscordSocketConfig] that you
+ are passing into your client.
 
-If you plan on deploying your bot or developing outside of Visual
-Studio, you will need to create a local NuGet configuration file for
-your project.
+[!code-csharp[Example](samples/netstd11.cs)]
 
-To do this, create a file named `nuget.config` alongside the root of
-your application, where the project solution is located.
+[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
+[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
 
-Paste the following snippets into this configuration file, adding any
-additional feeds as necessary.
+***
 
-[!code-xml[NuGet Configuration](samples/nuget.config)]
+[.NET Core SDK]: https://www.microsoft.com/net/download/
\ No newline at end of file
diff --git a/docs/guides/getting_started/intro.md b/docs/guides/getting_started/intro.md
deleted file mode 100644
index db086df21..000000000
--- a/docs/guides/getting_started/intro.md
+++ /dev/null
@@ -1,237 +0,0 @@
----
-title: Getting Started
----
-
-# Making a Ping-Pong bot
-
-One of the first steps to getting started with the Discord API is to
-write a basic ping-pong bot. We will expand on this to create more
-diverse commands later, but for now, it is a good starting point.
-
-## Creating a Discord Bot
-
-Before you can begin writing your bot, it is necessary to create a bot
-account on Discord.
-
-1. Visit the [Discord Applications Portal].
-2. Create a New Application.
-3. Give the application a name (this will be the bot's initial
-username).
-4. Create the Application.
-	
-	![Step 4](images/intro-create-app.png)
-	
-5. In the application review page, click **Create a Bot User**.
-	
-	![Step 5](images/intro-create-bot.png)
-	
-6. Confirm the popup.
-7. If this bot will be public, check "Public Bot." **Do not tick any 
-other options!**
-
-[Discord Applications Portal]: https://discordapp.com/developers/applications/me
-
-## Adding your bot to a server
-
-Bots **cannot** use invite links, they must be explicitly invited
-through the OAuth2 flow.
-
-1. Open your bot's application on the [Discord Applications Portal].
-2. Retrieve the app's **Client ID**.
-	
-	![Step 2](images/intro-client-id.png)
-	
-3. Create an OAuth2 authorization URL
-`https://discordapp.com/oauth2/authorize?client_id=<CLIENT ID>&scope=bot`
-4. Open the authorization URL in your browser.
-5. Select a server.
-6. Click on authorize.
-	
-	>[!NOTE]
-	Only servers where you have the `MANAGE_SERVER` permission will be
-	present in this list.
-	
-	![Step 6](images/intro-add-bot.png)
-
-
-## Connecting to Discord
-
-If you have not already created a project and installed Discord.Net,
-do that now. (see the [Installing](installing.md) section)
-
-### Async
-
-Discord.Net uses .NET's [Task-based Asynchronous Pattern (TAP)]
-extensively - nearly every operation is asynchronous.
-
-It is highly recommended that these operations are awaited in a
-properly established async context whenever possible. Establishing an
-async context can be problematic, but not hard.
-
-To do so, we will be creating an async main in your console
-application, and rewriting the static main method to invoke the new
-async main.
-
-[!code-csharp[Async Context](samples/intro/async-context.cs)]
-
-As a result of this, your program will now start and immediately
-jump into an async context. This will allow us to create a connection 
-to Discord later on without needing to worry about setting up the
-correct async implementation.
-
->[!TIP]
-If your application throws any exceptions within an async context,
-they will be thrown all the way back up to the first non-async method;
-since our first non-async method is the program's `Main` method, this
-means that **all** unhandled exceptions will be thrown up there, which
-will crash your application. Discord.Net will prevent exceptions in
-event handlers from crashing your program, but any exceptions in your
-async main **will** cause the application to crash.
-
-[Task-based Asynchronous Pattern (TAP)]: https://docs.microsoft.com/en-us/dotnet/articles/csharp/async
-
-### Creating a logging method
-
-Before we create and configure a Discord client, we will add a method
-to handle Discord.Net's log events.
-
-To allow agnostic support of as many log providers as possible, we
-log information through a `Log` event with a proprietary `LogMessage`
-parameter. See the [API Documentation] for this event.
-
-If you are using your own logging framework, this is where you would
-invoke it. For the sake of simplicity, we will only be logging to
-the Console.
-
-[!code-csharp[Async Context](samples/intro/logging.cs)]
-
-[API Documentation]: xref:Discord.Rest.BaseDiscordClient#Discord_Rest_BaseDiscordClient_Log
-
-### Creating a Discord Client
-
-Finally, we can create a connection to Discord. Since we are writing
-a bot, we will be using a [DiscordSocketClient] along with socket
-entities. See the [terminology](terminology.md) if you're unsure of
-the differences.
-
-To do so, create an instance of [DiscordSocketClient] in your async
-main, passing in a configuration object only if necessary. For most
-users, the default will work fine.
-
-Before connecting, we should hook the client's `Log` event to the
-log handler that was just created. Events in Discord.Net work
-similarly to other events in C#, so hook this event the way that
-you typically would.
-
-Next, you will need to "login to Discord" with the `LoginAsync` 
-method.
-
-You may create a variable to hold your bot's token (this can be found
-on your bot's application page on the [Discord Applications Portal]).
-
-![Token](images/intro-token.png)
-
->[!IMPORTANT]
-Your bot's token can be used to gain total access to your bot, so
-**do __NOT__ share this token with anyone else!** It may behoove you 
-to store this token in an external file if you plan on distributing 
-the source code for your bot.
-
-We may now invoke the client's `StartAsync` method, which will
-start connection/reconnection logic. It is important to note that
-**this method returns as soon as connection logic has been started!**
-
-Any methods that rely on the client's state should go in an event
-handler.
-
-Finally, we will want to block the async main method from returning
-until after the application is exited. To do this, we can await an
-infinite delay or any other blocking method, such as reading from
-the console.
-
-The following lines can now be added:
-
-[!code-csharp[Create client](samples/intro/client.cs)]
-
-At this point, feel free to start your program and see your bot come
-online in Discord.
-
->[!TIP]
-Encountering a `PlatformNotSupportedException` when starting your bot?
-This means that you are targeting a platform where .NET's default
-WebSocket client is not supported. Refer to the [installation guide]
-for how to fix this.
-
-[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[installation guide]: installing.md#installing-on-net-standard-11
-
-### Handling a 'ping'
-
->[!WARNING]
-Please note that this is *not* a proper way to create a command.
-Use the `CommandService` provided by the library instead, as explained
-in the [Command Guide] section.
-
-Now that we have learned how to open a connection to Discord, we can
-begin handling messages that users are sending.
-
-To start out, our bot will listen for any message where the content
-is equal to `!ping` and respond back with "Pong!".
-
-Since we want to listen for new messages, the event to hook into
-is [MessageReceived].
-
-In your program, add a method that matches the signature of the
-`MessageReceived` event - it must be a method (`Func`) that returns 
-the type `Task` and takes a single parameter, a [SocketMessage]. Also,
-since we will be sending data to Discord in this method, we will flag
-it as `async`.
-
-In this method, we will add an `if` block to determine if the message
-content fits the rules of our scenario - recall that it must be equal
-to `!ping`.
-
-Inside the branch of this condition, we will want to send a message
-back to the channel from which the message comes from - "Pong!". To 
-find the channel, look for the `Channel` property on the message 
-parameter.
-
-Next, we will want to send a message to this channel. Since the
-channel object is of type [SocketMessageChannel], we can invoke the
-`SendMessageAsync` instance method. For the message content, send back
-a string containing "Pong!".
-
-You should have now added the following lines:
-
-[!code-csharp[Message](samples/intro/message.cs)]
-
-Now your first bot is complete. You may continue to add on to this
-if you desire, but for any bots that will be carrying out multiple
-commands, it is strongly recommended to use the command framework as
-shown below.
-
-For your reference, you may view the [completed program].
-
-[MessageReceived]: xref:Discord.WebSocket.DiscordSocketClient#Discord_WebSocket_DiscordSocketClient_MessageReceived
-[SocketMessage]: xref:Discord.WebSocket.SocketMessage
-[SocketMessageChannel]: xref:Discord.WebSocket.ISocketMessageChannel
-[completed program]: samples/intro/complete.cs
-[Command Guide]: ../commands/commands.md
-
-# Building a bot with commands
-
-This section will show you how to write a program that is ready for
-[Commands](../commands/commands.md). Note that we will not be 
-explaining _how_ to write Commands or Services, it will only be 
-covering the general structure.
-
-For reference, view an [annotated example] of this structure.
-
-[annotated example]: samples/intro/structure.cs
-
-It is important to know that the recommended design pattern of bots
-should be to separate the program (initialization and command handler),
-the modules (handle commands), and the services (persistent storage,
-pure functions, data manipulation).
-
-**todo:** diagram of bot structure
\ No newline at end of file
diff --git a/docs/guides/getting_started/nightlies.md b/docs/guides/getting_started/nightlies.md
new file mode 100644
index 000000000..39bcc1c9f
--- /dev/null
+++ b/docs/guides/getting_started/nightlies.md
@@ -0,0 +1,86 @@
+---
+uid: Guides.GettingStarted.Installation.Nightlies
+title: Installing Nightly Build
+---
+
+# Installing Discord.Net Nightly Build
+
+Before Discord.Net pushes a new set of features into the stable
+version, we use nightly builds to test the features with the
+community for an extensive period of time. Each nightly build is
+compiled by AppVeyor whenever a new commit is made and will be pushed
+to our MyGet feed.
+
+> [!IMPORTANT]
+> Although nightlies are generally stable and have more features
+> and bug fixes than the current stable build on NuGet, there
+> will be breaking changes during the development or
+> breaking bugs; these bugs are usually fixed as soon as they
+> are discovered, but you should still be aware of that.
+
+## Installing with MyGet (Recommended)
+
+MyGet is typically used by many development teams to publish their
+latest pre-release packages before the features are finalized and
+pushed to NuGet.
+
+The following is the feed link of Discord.Net,
+
+* `https://www.myget.org/F/discord-net/api/v3/index.json`
+
+Depending on which IDE you use, there are many different ways of
+adding the feed to your package source.
+
+### [Visual Studio](#tab/vs)
+
+1. Go to `Tools` > `NuGet Package Manager` > `Package Manager Settings`
+    ![VS](images/nightlies-vs-step1.png)
+2. Go to `Package Sources`
+    ![Package Sources](images/nightlies-vs-step2.png)
+3. Click on the add icon
+4. Fill in the desired name and source as shown below and hit `Update`
+    ![Add Source](images/nightlies-vs-step4.png)
+
+> [!NOTE]
+> Remember to tick the `Include prerelease` checkbox to see the
+> nightly builds!
+> ![Checkbox](images/nightlies-vs-note.png)
+
+### [Local NuGet.Config](#tab/local-nuget-config)
+
+If you plan on deploying your bot or developing outside of Visual
+Studio, you will need to create a local NuGet configuration file for
+your project.
+
+To do this, create a file named `NuGet.Config` alongside the root of
+your application, where the project is located.
+
+Paste the following snippets into this configuration file, adding any
+additional feeds if necessary.
+
+[!code[NuGet Configuration](samples/nuget.config)]
+
+After which, you may install the packages by directly modifying the
+project file and specifying a version, or by using
+the [Package Manager Console](https://docs.microsoft.com/en-us/nuget/tools/powershell-reference)
+(`Install-Package Discord.Net -IncludePrerelease`).
+
+***
+
+## Installing from AppVeyor Artifacts
+
+As mentioned in the first paragraph, we utilize AppVeyor to perform
+automated tests and publish the new build. During the publishing
+process, we also upload the NuGet packages onto
+AppVeyor's Artifact collection.
+
+The latest build status can be found within our [AppVeyor project].
+
+[AppVeyor project]: https://ci.appveyor.com/project/rogueexception/discord-net
+
+1. In the project, you may find our latest build including the
+ aforementioned artifacts.
+    ![Artifacts](images/appveyor-artifacts.png)
+2. In the artifacts collection, you should see the latest packages
+ packed in `*.nupkg` form which you could download from and use.
+    ![NuPkgs](images/appveyor-nupkg.png)
diff --git a/docs/guides/getting_started/samples/first-bot/async-context.cs b/docs/guides/getting_started/samples/first-bot/async-context.cs
new file mode 100644
index 000000000..3c98c9e46
--- /dev/null
+++ b/docs/guides/getting_started/samples/first-bot/async-context.cs
@@ -0,0 +1,9 @@
+public class Program
+{
+	public static void Main(string[] args)
+		=> new Program().MainAsync().GetAwaiter().GetResult();
+
+	public async Task MainAsync()
+	{
+	}
+}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/first-bot/client.cs b/docs/guides/getting_started/samples/first-bot/client.cs
new file mode 100644
index 000000000..bced2224d
--- /dev/null
+++ b/docs/guides/getting_started/samples/first-bot/client.cs
@@ -0,0 +1,21 @@
+private DiscordSocketClient _client;
+
+public async Task MainAsync()
+{
+	_client = new DiscordSocketClient();
+
+	_client.Log += Log;
+
+	// Remember to keep token private or to read it from an 
+	// external source! In this case, we are reading the token 
+	// from an environment variable. If you do not know how to set-up
+	// environment variables, you may find more information on the 
+	// Internet or by using other methods such as reading from 
+	// a configuration.
+	await _client.LoginAsync(TokenType.Bot, 
+		Environment.GetEnvironmentVariable("DiscordToken"));
+	await _client.StartAsync();
+
+	// Block this task until the program is closed.
+	await Task.Delay(-1);
+}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/first-bot/complete.cs b/docs/guides/getting_started/samples/first-bot/complete.cs
new file mode 100644
index 000000000..3a7cb061d
--- /dev/null
+++ b/docs/guides/getting_started/samples/first-bot/complete.cs
@@ -0,0 +1,34 @@
+public class Program
+{
+	private DiscordSocketClient _client;
+	
+	public static void Main(string[] args)
+		=> new Program().MainAsync().GetAwaiter().GetResult();
+
+	public async Task MainAsync()
+	{
+		_client = new DiscordSocketClient();
+		_client.Log += Log;
+		_client.MessageReceived += MessageReceivedAsync;
+		await _client.LoginAsync(TokenType.Bot, 
+			Environment.GetEnvironmentVariable("DiscordToken"));
+		await _client.StartAsync();
+		
+		// Block this task until the program is closed.
+		await Task.Delay(-1);
+	}
+
+	private async Task MessageReceivedAsync(SocketMessage message)
+	{
+		if (message.Content == "!ping")
+		{
+			await message.Channel.SendMessageAsync("Pong!");
+		}
+	}
+
+	private Task Log(LogMessage msg)
+	{
+		Console.WriteLine(msg.ToString());
+		return Task.CompletedTask;
+	}
+}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/first-bot/logging.cs b/docs/guides/getting_started/samples/first-bot/logging.cs
new file mode 100644
index 000000000..c6ffc406e
--- /dev/null
+++ b/docs/guides/getting_started/samples/first-bot/logging.cs
@@ -0,0 +1,5 @@
+private Task Log(LogMessage msg)
+{
+	Console.WriteLine(msg.ToString());
+	return Task.CompletedTask;
+}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/intro/message.cs b/docs/guides/getting_started/samples/first-bot/message.cs
similarity index 92%
rename from docs/guides/getting_started/samples/intro/message.cs
rename to docs/guides/getting_started/samples/first-bot/message.cs
index d6fd90778..f636d6f35 100644
--- a/docs/guides/getting_started/samples/intro/message.cs
+++ b/docs/guides/getting_started/samples/first-bot/message.cs
@@ -1,6 +1,6 @@
 public async Task MainAsync()
 {
-	// client.Log ...
+	// ...
 	_client.MessageReceived += MessageReceived;
 	// ...
 }
diff --git a/docs/guides/getting_started/samples/intro/structure.cs b/docs/guides/getting_started/samples/first-bot/structure.cs
similarity index 100%
rename from docs/guides/getting_started/samples/intro/structure.cs
rename to docs/guides/getting_started/samples/first-bot/structure.cs
diff --git a/docs/guides/getting_started/samples/intro/async-context.cs b/docs/guides/getting_started/samples/intro/async-context.cs
deleted file mode 100644
index c01ddec55..000000000
--- a/docs/guides/getting_started/samples/intro/async-context.cs
+++ /dev/null
@@ -1,15 +0,0 @@
-using System;
-using System.Threading.Tasks;
-
-namespace MyBot
-{
-	public class Program
-	{
-		public static void Main(string[] args)
-			=> new Program().MainAsync().GetAwaiter().GetResult();
-
-		public async Task MainAsync()
-		{
-		}
-	}
-}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/intro/client.cs b/docs/guides/getting_started/samples/intro/client.cs
deleted file mode 100644
index a73082052..000000000
--- a/docs/guides/getting_started/samples/intro/client.cs
+++ /dev/null
@@ -1,17 +0,0 @@
-// Program.cs
-using Discord.WebSocket;
-// ...
-private DiscordSocketClient _client;
-public async Task MainAsync()
-{
-	_client = new DiscordSocketClient();
-
-	_client.Log += Log;
-
-	string token = "abcdefg..."; // Remember to keep this private!
-	await _client.LoginAsync(TokenType.Bot, token);
-	await _client.StartAsync();
-
-	// Block this task until the program is closed.
-	await Task.Delay(-1);
-}
diff --git a/docs/guides/getting_started/samples/intro/complete.cs b/docs/guides/getting_started/samples/intro/complete.cs
deleted file mode 100644
index 23b59ce6f..000000000
--- a/docs/guides/getting_started/samples/intro/complete.cs
+++ /dev/null
@@ -1,44 +0,0 @@
-using Discord;
-using Discord.WebSocket;
-using System;
-using System.Threading.Tasks;
-
-namespace MyBot
-{
-	public class Program
-	{
-		private DiscordSocketClient _client;
-		
-		public static void Main(string[] args)
-			=> new Program().MainAsync().GetAwaiter().GetResult();
-
-		public async Task MainAsync()
-		{
-			_client = new DiscordSocketClient();
-
-			_client.Log += Log;
-			_client.MessageReceived += MessageReceived;
-
-			string token = "abcdefg..."; // Remember to keep this private!
-			await _client.LoginAsync(TokenType.Bot, token);
-			await _client.StartAsync();
-
-			// Block this task until the program is closed.
-			await Task.Delay(-1);
-		}
-
-		private async Task MessageReceived(SocketMessage message)
-		{
-			if (message.Content == "!ping")
-			{
-				await message.Channel.SendMessageAsync("Pong!");
-			}
-		}
-
-		private Task Log(LogMessage msg)
-		{
-			Console.WriteLine(msg.ToString());
-			return Task.CompletedTask;
-		}
-	}
-}
diff --git a/docs/guides/getting_started/samples/intro/logging.cs b/docs/guides/getting_started/samples/intro/logging.cs
deleted file mode 100644
index 4fb85a063..000000000
--- a/docs/guides/getting_started/samples/intro/logging.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Discord;
-using System;
-using System.Threading.Tasks;
-
-namespace MyBot
-{
-	public class Program
-	{
-		public static void Main(string[] args)
-			=> new Program().MainAsync().GetAwaiter().GetResult();
-
-		public async Task MainAsync()
-		{
-		}
-
-		private Task Log(LogMessage msg)
-		{
-			Console.WriteLine(msg.ToString());
-			return Task.CompletedTask;
-		}
-	}
-}
\ No newline at end of file
diff --git a/docs/guides/getting_started/samples/project.csproj b/docs/guides/getting_started/samples/project.csproj
deleted file mode 100644
index feb0b0c40..000000000
--- a/docs/guides/getting_started/samples/project.csproj
+++ /dev/null
@@ -1,13 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp1.1</TargetFramework>
-    <NoWin32Manifest>true</NoWin32Manifest>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Discord.Net" Version="1.*" />
-  </ItemGroup>
-
-</Project>
diff --git a/docs/guides/getting_started/samples/project.xml b/docs/guides/getting_started/samples/project.xml
new file mode 100644
index 000000000..179d3f97b
--- /dev/null
+++ b/docs/guides/getting_started/samples/project.xml
@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <!--
+  The following may differ depending on the latest version of 
+  .NET Core or Discord.Net.
+  -->
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Discord.Net" Version="2.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/docs/guides/getting_started/terminology.md b/docs/guides/getting_started/terminology.md
index 74f7a6259..0f24edd6f 100644
--- a/docs/guides/getting_started/terminology.md
+++ b/docs/guides/getting_started/terminology.md
@@ -1,5 +1,5 @@
 ---
-uid: Terminology
+uid: Guides.GettingStarted.Terminology
 title: Terminology
 ---
 
@@ -7,34 +7,30 @@ title: Terminology
 
 ## Preface
 
-Most terms for objects remain the same between 0.9 and 1.0. The major 
-difference is that the ``Server`` is now called ``Guild`` to stay in 
-line with Discord internally.
+Most terms for objects remain the same between 0.9 and 1.0 and above.
+The major difference is that the ``Server`` is now called ``Guild``
+to stay in line with Discord internally.
 
 ## Implementation Specific Entities
 
-Discord.Net 1.0 is split into a core library and three different 
-implementations - `Discord.Net.Core`, `Discord.Net.Rest`, 
-`Discord.Net.Rpc`, and `Discord.Net.WebSockets`.
+Discord.Net is split into a core library and two different
+implementations - `Discord.Net.Core`, `Discord.Net.Rest`, and
+`Discord.Net.WebSockets`.
 
-As a bot developer, you will only need to use `Discord.Net.WebSockets`, 
+As a bot developer, you will only need to use `Discord.Net.WebSockets`,
 but you should be aware of the differences between them.
 
-`Discord.Net.Core` provides a set of interfaces that models Discord's 
-API. These interfaces are consistent throughout all implementations of 
-Discord.Net, and if you are writing an implementation-agnostic library 
-or addon, you can rely on the core interfaces to ensure that your 
+`Discord.Net.Core` provides a set of interfaces that models Discord's
+API. These interfaces are consistent throughout all implementations of
+Discord.Net, and if you are writing an implementation-agnostic library
+or addon, you can rely on the core interfaces to ensure that your
 addon will run on all platforms.
 
-`Discord.Net.Rest` provides a set of concrete classes to be used 
-**strictly** with the REST portion of Discord's API. Entities in this 
-implementation are prefixed with `Rest` (e.g. `RestChannel`).
+`Discord.Net.Rest` provides a set of concrete classes to be used
+**strictly** with the REST portion of Discord's API. Entities in this
+implementation are prefixed with `Rest` (e.g., `RestChannel`).
 
-`Discord.Net.Rpc` provides a set of concrete classes that are used 
-with Discord's RPC API. Entities in this implementation are prefixed 
-with `Rpc` (e.g. `RpcChannel`).
-
-`Discord.Net.WebSocket` provides a set of concrete classes that are 
+`Discord.Net.WebSocket` provides a set of concrete classes that are
 used primarily with Discord's WebSocket API or entities that are kept
-in cache. When developing bots, you will be using this implementation. 
-All entities are prefixed with `Socket` (e.g. `SocketChannel`).
\ No newline at end of file
+in cache. When developing bots, you will be using this implementation.
+All entities are prefixed with `Socket` (e.g., `SocketChannel`).
\ No newline at end of file
diff --git a/docs/guides/introduction/intro.md b/docs/guides/introduction/intro.md
new file mode 100644
index 000000000..14d4aa49e
--- /dev/null
+++ b/docs/guides/introduction/intro.md
@@ -0,0 +1,54 @@
+---
+uid: Guides.Introduction
+title: Introduction to Discord.Net
+---
+
+# Introduction
+
+## Looking to get started?
+
+Welcome! Before you dive into this library, however, you should have
+some decent understanding of the language
+you are about to use. This library touches on
+[Task-based Asynchronous Pattern] \(TAP), [polymorphism], [interface]
+and many more advanced topics extensively. Please make sure that you
+understand these topics to some extent before proceeding. With all
+that being said, feel free to visit us on Discord at the link below
+if you have any questions!
+
+Here are some examples:
+
+1. [Official samples]
+2. [Official template]
+
+> [!NOTE]
+> Please note that you should *not* try to blindly copy paste
+> the code. The examples are meant to be a template or a guide.
+
+[Official template]: https://github.com/foxbot/DiscordBotBase/tree/csharp/src/DiscordBot
+[Official samples]: https://github.com/RogueException/Discord.Net/tree/dev/samples
+[Task-based Asynchronous Pattern]: https://docs.microsoft.com/en-us/dotnet/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap
+[polymorphism]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/polymorphism
+[interface]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/interfaces/
+
+## New to .NET/C#?
+
+All examples or snippets featured in this guide and all API
+documentation will be written in C#.
+
+If you are new to the language, using this wrapper may prove to be
+difficult, but don't worry! There are many resources online that can
+help you get started in the wonderful world of .NET. Here are some
+resources to get you started.
+
+- [C# Programming Guide (MSDN/Microsoft, Free)](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/)
+- [C# Fundamentals For Absolute Beginners (Channel9/Microsoft, Free)](https://channel9.msdn.com/Series/C-Fundamentals-for-Absolute-Beginners)
+- [C# Path (Pluralsight, Paid)](https://www.pluralsight.com/paths/csharp)
+
+## Still have questions?
+
+Please visit us at `#dotnet_discord-net` on the [Discord API] server.
+Describe the problem in details to us, what you've done, and,
+if any, the problematic code uploaded onto [Hastebin](https://hastebin.com).
+
+[Discord API]: https://discord.gg/jkrBmQR
\ No newline at end of file
diff --git a/docs/guides/migrating/migrating.md b/docs/guides/migrating/migrating.md
deleted file mode 100644
index bc628a5f8..000000000
--- a/docs/guides/migrating/migrating.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# Migrating from 0.9
-
-**1.0.0 is the biggest breaking change the library has gone through, due to massive
-changes in the design of the library.**
-
->A medium to advanced understanding is recommended when working with this library.
-
-It is recommended to familiarize yourself with the entities in 1.0 before continuing. 
-Feel free to look through the library's source directly, look through IntelliSense, or 
-look through our hosted [API Documentation](xref:Discord).
-
-## Entities 
-
-Most API models function _similarly_ to 0.9, however their names have been changed. 
-You should also keep in mind that we now separate different types of Channels and Users.
-
-Before proceeding, please read over @Terminology to understand the naming behind some objects.
-
-Below is a table that compares most common 0.9 entities to their 1.0 counterparts.
-
->This should be used mostly for migration purposes. Please take some time to consider whether
->or not you are using the right "tool for the job" when working with 1.0
-
-| 0.9 | 1.0 | Notice |
-| --- | --- | ------ |
-| Server | @Discord.WebSocket.SocketGuild |
-| Channel | @Discord.WebSocket.SocketGuildChannel | Applies only to channels that are members of a Guild |
-| Channel.IsPrivate | @Discord.WebSocket.SocketDMChannel
-| ChannelType.Text | @Discord.WebSocket.SocketTextChannel | This applies only to Text Channels in Guilds
-| ChannelType.Voice | @Discord.WebSocket.SocketVoiceChannel | This applies only to Voice Channels in Guilds
-| User | @Discord.WebSocket.SocketGuildUser | This applies only to users belonging to a Guild*
-| Profile | @Discord.WebSocket.SocketGuildUser
-| Message | @Discord.WebSocket.SocketUserMessage
-
-\* To retrieve an @Discord.WebSocket.SocketGuildUser, you must retrieve the user from an @Discord.WebSocket.SocketGuild.
-
-## Event Registration
-
-Prior to 1.0, events were registered using the standard c# `Handler(EventArgs)` pattern. In 1.0,
-events are delegates, but are still registered the same.
-
-For example, let's look at [DiscordSocketClient.MessageReceived](xref:Discord.WebSocket.DiscordSocketClient#Discord_WebSocket_DiscordSocketClient_MessageReceived)
-
-To hook an event into MessageReceived, we now use the following code:  
-[!code-csharp[Event Registration](samples/event.cs)]
-
-> **All Event Handlers in 1.0 MUST return Task!**
-
-If your event handler is marked as `async`, it will automatically return `Task`. However,
-if you do not need to execute asynchronus code, do _not_ mark your handler as `async`, and instead,
-stick a `return Task.CompletedTask` at the bottom.
-
-[!code-csharp[Sync Event Registration](samples/sync_event.cs)]
-
-**Event handlers no longer require a sender.** The only arguments your event handler needs to accept
-are the parameters used by the event. It is recommended to look at the event in IntelliSense or on the
-API docs before implementing it.
-
-## Async
-
-Nearly everything in 1.0 is an async Task. You should always await any tasks you invoke.
diff --git a/docs/guides/migrating/samples/event.cs b/docs/guides/migrating/samples/event.cs
deleted file mode 100644
index 8719942f2..000000000
--- a/docs/guides/migrating/samples/event.cs
+++ /dev/null
@@ -1,4 +0,0 @@
-_client.MessageReceived += async (msg) =>
-{
-    await msg.Channel.SendMessageAsync(msg.Content);
-}
\ No newline at end of file
diff --git a/docs/guides/migrating/samples/sync_event.cs b/docs/guides/migrating/samples/sync_event.cs
deleted file mode 100644
index f4a55cdd3..000000000
--- a/docs/guides/migrating/samples/sync_event.cs
+++ /dev/null
@@ -1,5 +0,0 @@
-_client.Log += (msg) =>
-{
-    Console.WriteLine(msg.ToString());
-    return Task.CompletedTask;
-}
\ No newline at end of file
diff --git a/docs/guides/toc.yml b/docs/guides/toc.yml
index 2e3a61e19..01c245301 100644
--- a/docs/guides/toc.yml
+++ b/docs/guides/toc.yml
@@ -1,27 +1,41 @@
+- name: Introduction
+  topicUid: Guides.Introduction
 - name: Getting Started
   items:
     - name: Installation
-      href: getting_started/installing.md
+      topicUid: Guides.GettingStarted.Installation
+      items:
+        - name: Nightly Builds
+          topicUid: Guides.GettingStarted.Installation.Nightlies
     - name: Your First Bot
-      href: getting_started/intro.md
+      topicUid: Guides.GettingStarted.FirstBot
     - name: Terminology
-      href: getting_started/terminology.md
+      topicUid: Guides.GettingStarted.Terminology
 - name: Basic Concepts
   items:
     - name: Logging Data
-      href: concepts/logging.md
+      topicUid: Guides.Concepts.Logging
     - name: Working with Events
-      href: concepts/events.md
+      topicUid: Guides.Concepts.Events
     - name: Managing Connections
-      href: concepts/connections.md
+      topicUid: Guides.Concepts.ManageConnections
     - name: Entities
-      href: concepts/entities.md
-- name: The Command Service
+      topicUid: Guides.Concepts.Entities
+- name: Working with Commands
   items:
-    - name: Command Guide
-      href: commands/commands.md
+    - name: Introduction
+      topicUid: Guides.Commands.Intro
+    - name: TypeReaders
+      topicUid: Guides.Commands.TypeReaders
+    - name: Preconditions
+      topicUid: Guides.Commands.Preconditions
+    - name: Dependency Injection
+      topicUid: Guides.Commands.DI
+    - name: Post-execution Handling
+      topicUid: Guides.Commands.PostExecution
+- name: Emoji
+  topicUid: Guides.Emoji
 - name: Voice
-  items:
-    - name: Voice Guide
-      href: voice/sending-voice.md
-- name: Migrating from 0.9
\ No newline at end of file
+  topicUid: Guides.Voice.SendingVoice
+- name: Deployment
+  topicUid: Guides.Deployment
\ No newline at end of file
diff --git a/docs/guides/voice/sending-voice.md b/docs/guides/voice/sending-voice.md
index 024a98b95..c30805836 100644
--- a/docs/guides/voice/sending-voice.md
+++ b/docs/guides/voice/sending-voice.md
@@ -1,4 +1,5 @@
 ---
+uid: Guides.Voice.SendingVoice
 title: Sending Voice
 ---
 
@@ -44,7 +45,7 @@ guild. To switch channels within a guild, invoke [ConnectAsync] on
 another voice channel in the guild.
 
 [IAudioClient]: xref:Discord.Audio.IAudioClient
-[ConnectAsync]: xref:Discord.IAudioChannel#Discord_IAudioChannel_ConnectAsync_Action_IAudioClient__
+[ConnectAsync]: xref:Discord.IAudioChannel.ConnectAsync*
 
 ## Transmitting Audio
 
@@ -98,4 +99,4 @@ you will want to wait for audio to stop playing before continuing on
 to the next song. You can await `AudioOutStream.FlushAsync` to wait for 
 the audio client's internal buffer to clear out.
 
-[!code-csharp[Sending Audio](samples/audio_ffmpeg.cs)]
\ No newline at end of file
+[!code-csharp[Sending Audio](samples/audio_ffmpeg.cs)]
diff --git a/docs/index.md b/docs/index.md
index ef9ecdfdd..8622bc002 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,13 +1,28 @@
+---
+uid: Root.Landing
+title: Home
+---
 
 # Discord.Net Documentation
 
-Discord.Net is an asynchronous, multiplatform .NET Library used to interface with the [Discord API](https://discordapp.com/).
+## What is Discord.Net?
 
-If this is your first time using Discord.Net, you should refer to the [Intro](guides/getting_started/intro.md) for tutorials. 
-More experienced users might refer to the [API Documentation](api/index.md) for a breakdown of the individuals objects in the library.
+Discord.Net is an asynchronous, multi-platform .NET Library used to
+interface with the [Discord API](https://discordapp.com/).
 
-For additional resources:
- - [Discord API Guild](https://discord.gg/discord-api) - Look for `#dotnet_discord-net`
- - [GitHub](https://github.com/RogueException/Discord.Net/tree/dev)
- - [NuGet](https://www.nuget.org/packages/Discord.Net/)
- - [MyGet Feed](https://www.myget.org/feed/Packages/discord-net) - Addons and nightly builds
\ No newline at end of file
+## Where to begin?
+
+If this is your first time using Discord.Net, you should refer to the
+[Intro](xref:Guides.Introduction) for tutorials.
+
+More experienced users might want to refer to the
+[API Documentation](xref:API.Docs) for a breakdown of the individual
+objects in the library.
+
+## Additional Resources
+
+- [Discord API Guild](https://discord.gg/discord-api) - Look for `#dotnet_discord-net`
+- [GitHub](https://github.com/RogueException/Discord.Net/)
+- [NuGet](https://www.nuget.org/packages/Discord.Net/)
+- [MyGet Feed](https://www.myget.org/feed/Packages/discord-net) - Add-ons and nightly builds
+- [AppVeyor CI](https://ci.appveyor.com/project/RogueException/discord-net) - Nightly builds via Continuous Integration
\ No newline at end of file
diff --git a/docs/langwordMapping.yml b/docs/langwordMapping.yml
new file mode 100644
index 000000000..9ddd00cab
--- /dev/null
+++ b/docs/langwordMapping.yml
@@ -0,0 +1,61 @@
+references:
+- uid: langword_csharp_null
+  name.csharp: "null"
+  name.vb: "Nothing"
+- uid: langword_vb_Nothing
+  name.csharp: "null"
+  name.vb: "Nothing"
+- uid: langword_csharp_static
+  name.csharp: static
+  name.vb: Shared
+- uid: langword_vb_Shared
+  name.csharp: static
+  name.vb: Shared
+- uid: langword_csharp_virtual
+  name.csharp: virtual
+  name.vb: Overridable
+- uid: langword_vb_Overridable
+  name.csharp: virtual
+  name.vb: Overridable
+- uid: langword_csharp_true
+  name.csharp: "true"
+  name.vb: "True"
+- uid: langword_vb_True
+  name.csharp: "true"
+  name.vb: "True"
+- uid: langword_csharp_false
+  name.csharp: "false"
+  name.vb: "False"
+- uid: langword_vb_False
+  name.csharp: "false"
+  name.vb: "False"
+- uid: langword_csharp_abstract
+  name.csharp: abstract
+  name.vb: MustInherit
+- uid: langword_vb_MustInherit
+  name.csharp: abstract
+  name.vb: MustInherit
+- uid: langword_csharp_sealed
+  name.csharp: sealed
+  name.vb: NotInheritable
+- uid: langword_vb_NotInheritable
+  name.csharp: sealed
+  name.vb: NotInheritable
+- uid: langword_csharp_async
+  name.csharp: async
+  name.vb: Async
+- uid: langword_vb_Async
+  name.csharp: async
+  name.vb: Async
+- uid: langword_csharp_await
+  name.csharp: await
+  name.vb: Await
+- uid: langword_vb_Await
+  name.csharp: await
+  name.vb: Await
+- uid: langword_csharp_async/await
+  name.csharp: async/await
+  name.vb: Async/Await
+- uid: langword_vb_Async/Await
+  name.csharp: async/await
+  name.vb: Async/Await
\ No newline at end of file
diff --git a/docs/toc.yml b/docs/toc.yml
index c08e708bf..337294b1a 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -1,6 +1,9 @@
-
 - name: Guides
   href: guides/
+  topicUid: Guides.Introduction
+- name: FAQ
+  href: faq/
+  topicUid: FAQ.Basics.GetStarted
 - name: API Documentation
   href: api/
-  homepage: api/index.md
+  topicUid: API.Docs
\ No newline at end of file
diff --git a/experiment/Discord.Net.Rpc/DiscordRpcApiClient.cs b/experiment/Discord.Net.Rpc/DiscordRpcApiClient.cs
index 50d467054..300784f4e 100644
--- a/experiment/Discord.Net.Rpc/DiscordRpcApiClient.cs
+++ b/experiment/Discord.Net.Rpc/DiscordRpcApiClient.cs
@@ -192,7 +192,7 @@ namespace Discord.API
         internal override async Task DisconnectInternalAsync()
         {
             if (_webSocketClient == null)
-                throw new NotSupportedException("This client is not configured with websocket support.");
+                throw new NotSupportedException("This client is not configured with WebSocket support.");
 
             if (ConnectionState == ConnectionState.Disconnected) return;
             ConnectionState = ConnectionState.Disconnecting;
diff --git a/experiment/Discord.Net.Rpc/DiscordRpcConfig.cs b/experiment/Discord.Net.Rpc/DiscordRpcConfig.cs
index fd6b74ff1..90df8d1a7 100644
--- a/experiment/Discord.Net.Rpc/DiscordRpcConfig.cs
+++ b/experiment/Discord.Net.Rpc/DiscordRpcConfig.cs
@@ -14,7 +14,7 @@ namespace Discord.Rpc
         /// <summary> Gets or sets the time, in milliseconds, to wait for a connection to complete before aborting. </summary>
         public int ConnectionTimeout { get; set; } = 30000;
 
-        /// <summary> Gets or sets the provider used to generate new websocket connections. </summary>
+        /// <summary> Gets or sets the provider used to generate new WebSocket connections. </summary>
         public WebSocketProvider WebSocketProvider { get; set; }
 
         public DiscordRpcConfig()
@@ -24,7 +24,7 @@ namespace Discord.Rpc
 #else
             WebSocketProvider = () =>
             {
-                throw new InvalidOperationException("The default websocket provider is not supported on this platform.\n" +
+                throw new InvalidOperationException("The default WebSocket provider is not supported on this platform.\n" +
                     "You must specify a WebSocketProvider or target a runtime supporting .NET Standard 1.3, such as .NET Framework 4.6+.");
             };
 #endif
diff --git a/experiment/Discord.Net.Rpc/Entities/Channels/RpcDMChannel.cs b/experiment/Discord.Net.Rpc/Entities/Channels/RpcDMChannel.cs
index 42e590aca..195411678 100644
--- a/experiment/Discord.Net.Rpc/Entities/Channels/RpcDMChannel.cs
+++ b/experiment/Discord.Net.Rpc/Entities/Channels/RpcDMChannel.cs
@@ -9,6 +9,7 @@ using Model = Discord.API.Rpc.Channel;
 
 namespace Discord.Rpc
 {
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RpcDMChannel : RpcChannel, IRpcMessageChannel, IRpcPrivateChannel, IDMChannel
     {
         public IReadOnlyCollection<RpcMessage> CachedMessages { get; private set; }
diff --git a/experiment/Discord.Net.Rpc/Entities/Channels/RpcGroupChannel.cs b/experiment/Discord.Net.Rpc/Entities/Channels/RpcGroupChannel.cs
index 1c9355047..9d484c25d 100644
--- a/experiment/Discord.Net.Rpc/Entities/Channels/RpcGroupChannel.cs
+++ b/experiment/Discord.Net.Rpc/Entities/Channels/RpcGroupChannel.cs
@@ -10,6 +10,7 @@ using Model = Discord.API.Rpc.Channel;
 
 namespace Discord.Rpc
 {
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RpcGroupChannel : RpcChannel, IRpcMessageChannel, IRpcAudioChannel, IRpcPrivateChannel, IGroupChannel
     {
         public IReadOnlyCollection<RpcMessage> CachedMessages { get; private set; }
diff --git a/samples/01_basic_ping_bot/Program.cs b/samples/01_basic_ping_bot/Program.cs
index 0fcc52b85..973a6ce95 100644
--- a/samples/01_basic_ping_bot/Program.cs
+++ b/samples/01_basic_ping_bot/Program.cs
@@ -5,14 +5,14 @@ using Discord.WebSocket;
 
 namespace _01_basic_ping_bot
 {
-    // This is a minimal, barebones example of using Discord.Net
+    // This is a minimal, bare-bones example of using Discord.Net
     //
     // If writing a bot with commands, we recommend using the Discord.Net.Commands
     // framework, rather than handling commands yourself, like we do in this sample.
     //
     // You can find samples of using the command framework:
     // - Here, under the 02_commands_framework sample
-    // - https://github.com/foxbot/DiscordBotBase - a barebones bot template
+    // - https://github.com/foxbot/DiscordBotBase - a bare-bones bot template
     // - https://github.com/foxbot/patek - a more feature-filled bot, utilizing more aspects of the library
     class Program
     {
@@ -54,7 +54,7 @@ namespace _01_basic_ping_bot
             return Task.CompletedTask;
         }
 
-        // This is not the recommmended way to write a bot - consider
+        // This is not the recommended way to write a bot - consider
         // reading over the Commands Framework sample.
         private async Task MessageReceivedAsync(SocketMessage message)
         {
diff --git a/samples/02_commands_framework/Program.cs b/samples/02_commands_framework/Program.cs
index 3fed652d3..136494bdf 100644
--- a/samples/02_commands_framework/Program.cs
+++ b/samples/02_commands_framework/Program.cs
@@ -15,7 +15,7 @@ namespace _02_commands_framework
     //
     // You can find samples of using the command framework:
     // - Here, under the 02_commands_framework sample
-    // - https://github.com/foxbot/DiscordBotBase - a barebones bot template
+    // - https://github.com/foxbot/DiscordBotBase - a bare-bones bot template
     // - https://github.com/foxbot/patek - a more feature-filled bot, utilizing more aspects of the library
     class Program
     {
diff --git a/src/Discord.Net.Commands/Attributes/AliasAttribute.cs b/src/Discord.Net.Commands/Attributes/AliasAttribute.cs
index 6cd0abbb7..16eb3ba73 100644
--- a/src/Discord.Net.Commands/Attributes/AliasAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/AliasAttribute.cs
@@ -2,14 +2,37 @@ using System;
 
 namespace Discord.Commands
 {
-    /// <summary> Provides aliases for a command. </summary>
+    /// <summary>
+    ///     Marks the aliases for a command.
+    /// </summary>
+    /// <remarks>
+    ///     This attribute allows a command to have one or multiple aliases. In other words, the base command can have
+    ///     multiple aliases when triggering the command itself, giving the end-user more freedom of choices when giving
+    ///     hot-words to trigger the desired command. See the example for a better illustration.
+    /// </remarks>
+    /// <example>
+    ///     In the following example, the command can be triggered with the base name, "stats", or either "stat" or
+    ///     "info".
+    ///     <code language="cs">
+    ///     [Command("stats")]
+    ///     [Alias("stat", "info")]
+    ///     public async Task GetStatsAsync(IUser user)
+    ///     {
+    ///         // ...pull stats
+    ///     }
+    ///     </code>
+    /// </example>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
     public class AliasAttribute : Attribute
     {
-        /// <summary> The aliases which have been defined for the command. </summary>
+        /// <summary>
+        ///     Gets the aliases which have been defined for the command.
+        /// </summary>
         public string[] Aliases { get; }
 
-        /// <summary> Creates a new <see cref="AliasAttribute"/> with the given aliases. </summary>
+        /// <summary>
+        ///     Creates a new <see cref="AliasAttribute" /> with the given aliases.
+        /// </summary>
         public AliasAttribute(params string[] aliases)
         {
             Aliases = aliases;
diff --git a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
index bfc04641a..d4d9ee3bb 100644
--- a/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/CommandAttribute.cs
@@ -2,17 +2,32 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Marks the execution information for a command.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
     public class CommandAttribute : Attribute
     {
+        /// <summary>
+        ///     Gets the text that has been set to be recognized as a command.
+        /// </summary>
         public string Text { get; }
+        /// <summary>
+        ///     Specifies the <see cref="RunMode" /> of the command. This affects how the command is executed.
+        /// </summary>
         public RunMode RunMode { get; set; } = RunMode.Default;
         public bool? IgnoreExtraArgs { get; }
 
+        /// <inheritdoc />
         public CommandAttribute()
         {
             Text = null;
         }
+
+        /// <summary>
+        ///     Initializes a new <see cref="CommandAttribute" /> attribute with the specified name.
+        /// </summary>
+        /// <param name="text">The name of the command.</param>
         public CommandAttribute(string text)
         {
             Text = text;
diff --git a/src/Discord.Net.Commands/Attributes/DontAutoLoadAttribute.cs b/src/Discord.Net.Commands/Attributes/DontAutoLoadAttribute.cs
index cc23a6d15..7dbe1a495 100644
--- a/src/Discord.Net.Commands/Attributes/DontAutoLoadAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/DontAutoLoadAttribute.cs
@@ -2,6 +2,14 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Prevents the marked module from being loaded automatically.
+    /// </summary>
+    /// <remarks>
+    ///     This attribute tells <see cref="CommandService" /> to ignore the marked module from being loaded
+    ///     automatically (e.g. the <see cref="CommandService.AddModulesAsync" /> method). If a non-public module marked
+    ///     with this attribute is attempted to be loaded manually, the loading process will also fail.
+    /// </remarks>
     [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
     public class DontAutoLoadAttribute : Attribute
     {
diff --git a/src/Discord.Net.Commands/Attributes/DontInjectAttribute.cs b/src/Discord.Net.Commands/Attributes/DontInjectAttribute.cs
index c982d93a1..72ca92fdf 100644
--- a/src/Discord.Net.Commands/Attributes/DontInjectAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/DontInjectAttribute.cs
@@ -1,9 +1,31 @@
 using System;
 
-namespace Discord.Commands {
-
-  [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
-  public class DontInjectAttribute : Attribute {
-  }
-
+namespace Discord.Commands
+{
+    /// <summary>
+    ///     Prevents the marked property from being injected into a module.
+    /// </summary>
+    /// <remarks>
+    ///     This attribute prevents the marked member from being injected into its parent module. Useful when you have a
+    ///     public property that you do not wish to invoke the library's dependency injection service.
+    /// </remarks>
+    /// <example>
+    ///     In the following example, <c>DatabaseService</c> will not be automatically injected into the module and will
+    ///     not throw an error message if the dependency fails to be resolved.
+    ///     <code language="cs">
+    ///     public class MyModule : ModuleBase
+    ///     {
+    ///         [DontInject]
+    ///         public DatabaseService DatabaseService;
+    ///         public MyModule()
+    ///         {
+    ///             DatabaseService = DatabaseFactory.Generate();
+    ///         }
+    ///     }
+    ///     </code>
+    /// </example>
+    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
+    public class DontInjectAttribute : Attribute
+    {
+    }
 }
diff --git a/src/Discord.Net.Commands/Attributes/GroupAttribute.cs b/src/Discord.Net.Commands/Attributes/GroupAttribute.cs
index b1760d149..e1e38cff7 100644
--- a/src/Discord.Net.Commands/Attributes/GroupAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/GroupAttribute.cs
@@ -2,15 +2,26 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Marks the module as a command group.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
     public class GroupAttribute : Attribute
     {
+        /// <summary>
+        ///     Gets the prefix set for the module.
+        /// </summary>
         public string Prefix { get; }
 
+        /// <inheritdoc />
         public GroupAttribute()
         {
             Prefix = null;
         }
+        /// <summary>
+        ///     Initializes a new <see cref="GroupAttribute" /> with the provided prefix.
+        /// </summary>
+        /// <param name="prefix">The prefix of the module group.</param>
         public GroupAttribute(string prefix)
         {
             Prefix = prefix;
diff --git a/src/Discord.Net.Commands/Attributes/NameAttribute.cs b/src/Discord.Net.Commands/Attributes/NameAttribute.cs
index 4a4b2bfed..a6e1f2e5a 100644
--- a/src/Discord.Net.Commands/Attributes/NameAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/NameAttribute.cs
@@ -3,11 +3,21 @@ using System;
 namespace Discord.Commands
 {
     // Override public name of command/module
+    /// <summary>
+    ///     Marks the public name of a command, module, or parameter.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class NameAttribute : Attribute
     {
+        /// <summary>
+        ///     Gets the name of the command.
+        /// </summary>
         public string Text { get; }
 
+        /// <summary>
+        ///     Marks the public name of a command, module, or parameter with the provided name.
+        /// </summary>
+        /// <param name="text">The public name of the object.</param>
         public NameAttribute(string text)
         {
             Text = text;
diff --git a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
index 17e2310d4..85f5df10e 100644
--- a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
@@ -4,17 +4,46 @@ using System.Reflection;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Marks the <see cref="Type"/> to be read by the specified <see cref="Discord.Commands.TypeReader"/>.
+    /// </summary>
+    /// <remarks>
+    ///     This attribute will override the <see cref="Discord.Commands.TypeReader"/> to be used when parsing for the
+    ///     desired type in the command. This is useful when one wishes to use a particular 
+    ///     <see cref="Discord.Commands.TypeReader"/> without affecting other commands that are using the same target
+    ///     type.
+    ///     <note type="warning">
+    ///         If the given type reader does not inherit from <see cref="Discord.Commands.TypeReader"/>, an 
+    ///         <see cref="ArgumentException"/> will be thrown.
+    ///     </note>
+    /// </remarks>
+    /// <example>
+    ///     In this example, the <see cref="TimeSpan"/> will be read by a custom 
+    ///     <see cref="Discord.Commands.TypeReader"/>, <c>FriendlyTimeSpanTypeReader</c>, instead of the 
+    ///     <see cref="TimeSpanTypeReader"/> shipped by Discord.Net.
+    ///     <code language="cs">
+    ///     [Command("time")]
+    ///     public Task GetTimeAsync([OverrideTypeReader(typeof(FriendlyTimeSpanTypeReader))]TimeSpan time)
+    ///         => ReplyAsync(time);
+    ///     </code>
+    /// </example>
     [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class OverrideTypeReaderAttribute : Attribute
     {
         private static readonly TypeInfo TypeReaderTypeInfo = typeof(TypeReader).GetTypeInfo();
 
+        /// <summary> 
+        ///     Gets the specified <see cref="TypeReader"/> of the parameter. 
+        /// </summary>
         public Type TypeReader { get; }
 
+        /// <inheritdoc/>
+        /// <param name="overridenTypeReader">The <see cref="TypeReader"/> to be used with the parameter. </param>
+        /// <exception cref="ArgumentException">The given <paramref name="overridenTypeReader"/> does not inherit from <see cref="TypeReader"/>.</exception>
         public OverrideTypeReaderAttribute(Type overridenTypeReader)
         {
             if (!TypeReaderTypeInfo.IsAssignableFrom(overridenTypeReader.GetTypeInfo()))
-                throw new ArgumentException($"{nameof(overridenTypeReader)} must inherit from {nameof(TypeReader)}");
+                throw new ArgumentException($"{nameof(overridenTypeReader)} must inherit from {nameof(TypeReader)}.");
             
             TypeReader = overridenTypeReader;
         }
diff --git a/src/Discord.Net.Commands/Attributes/ParameterPreconditionAttribute.cs b/src/Discord.Net.Commands/Attributes/ParameterPreconditionAttribute.cs
index 3c5e8cf92..8ee46f9f9 100644
--- a/src/Discord.Net.Commands/Attributes/ParameterPreconditionAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/ParameterPreconditionAttribute.cs
@@ -3,9 +3,20 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Requires the parameter to pass the specified precondition before execution can begin.
+    /// </summary>
+    /// <seealso cref="PreconditionAttribute"/>
     [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = true, Inherited = true)]
     public abstract class ParameterPreconditionAttribute : Attribute
     {
+        /// <summary>
+        ///     Checks whether the condition is met before execution of the command.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="parameter">The parameter of the command being checked against.</param>
+        /// <param name="value">The raw value of the parameter.</param>
+        /// <param name="services">The service collection used for dependency injection.</param>
         public abstract Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, ParameterInfo parameter, object value, IServiceProvider services);
     }
 }
diff --git a/src/Discord.Net.Commands/Attributes/PreconditionAttribute.cs b/src/Discord.Net.Commands/Attributes/PreconditionAttribute.cs
index 367adebf0..316b2729e 100644
--- a/src/Discord.Net.Commands/Attributes/PreconditionAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/PreconditionAttribute.cs
@@ -1,18 +1,31 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Requires the module or class to pass the specified precondition before execution can begin.
+    /// </summary>
+    /// <seealso cref="ParameterPreconditionAttribute"/>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
     public abstract class PreconditionAttribute : Attribute
     {
         /// <summary>
-        /// Specify a group that this precondition belongs to. Preconditions of the same group require only one
-        /// of the preconditions to pass in order to be successful (A || B). Specifying <see cref="Group"/> = <see langword="null"/>
-        /// or not at all will require *all* preconditions to pass, just like normal (A &amp;&amp; B).
+        ///     Specifies a group that this precondition belongs to.
         /// </summary>
+        /// <remarks>
+        ///     <see cref="Preconditions" /> of the same group require only one of the preconditions to pass in order to
+        ///     be successful (A || B). Specifying <see cref="Group" /> = <c>null</c> or not at all will
+        ///     require *all* preconditions to pass, just like normal (A &amp;&amp; B).
+        /// </remarks>
         public string Group { get; set; } = null;
 
+        /// <summary>
+        ///     Checks if the <paramref name="command"/> has the sufficient permission to be executed.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="command">The command being executed.</param>
+        /// <param name="services">The service collection used for dependency injection.</param>
         public abstract Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services);
     }
 }
diff --git a/src/Discord.Net.Commands/Attributes/Preconditions/RequireBotPermissionAttribute.cs b/src/Discord.Net.Commands/Attributes/Preconditions/RequireBotPermissionAttribute.cs
index 104252799..76d18449e 100644
--- a/src/Discord.Net.Commands/Attributes/Preconditions/RequireBotPermissionAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/Preconditions/RequireBotPermissionAttribute.cs
@@ -1,46 +1,52 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
     /// <summary>
-    /// This attribute requires that the bot has a specified permission in the channel a command is invoked in.
+    ///     Requires the bot to have a specific permission in the channel a command is invoked in.
     /// </summary>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
     public class RequireBotPermissionAttribute : PreconditionAttribute
     {
+        /// <summary>
+        ///     Gets the specified <see cref="Discord.GuildPermission" /> of the precondition.
+        /// </summary>
         public GuildPermission? GuildPermission { get; }
+        /// <summary>
+        ///     Gets the specified <see cref="Discord.ChannelPermission" /> of the precondition.
+        /// </summary>
         public ChannelPermission? ChannelPermission { get; }
 
         /// <summary>
-        /// Require that the bot account has a specified GuildPermission
+        ///     Requires the bot account to have a specific <see cref="Discord.GuildPermission"/>.
         /// </summary>
-        /// <remarks>This precondition will always fail if the command is being invoked in a private channel.</remarks>
-        /// <param name="permission">The GuildPermission that the bot must have. Multiple permissions can be specified by ORing the permissions together.</param>
+        /// <remarks>
+        ///     This precondition will always fail if the command is being invoked in a <see cref="IPrivateChannel"/>.
+        /// </remarks>
+        /// <param name="permission">
+        ///     The <see cref="Discord.GuildPermission"/> that the bot must have. Multiple permissions can be specified
+        ///     by ORing the permissions together.
+        /// </param>
         public RequireBotPermissionAttribute(GuildPermission permission)
         {
             GuildPermission = permission;
             ChannelPermission = null;
         }
         /// <summary>
-        /// Require that the bot account has a specified ChannelPermission.
+        ///     Requires that the bot account to have a specific <see cref="Discord.ChannelPermission"/>.
         /// </summary>
-        /// <param name="permission">The ChannelPermission that the bot must have. Multiple permissions can be specified by ORing the permissions together.</param>
-        /// <example>
-        /// <code language="c#">
-        ///     [Command("permission")]
-        ///     [RequireBotPermission(ChannelPermission.ManageMessages)]
-        ///     public async Task Purge()
-        ///     {
-        ///     }
-        /// </code>
-        /// </example>
+        /// <param name="permission">
+        ///     The <see cref="Discord.ChannelPermission"/> that the bot must have. Multiple permissions can be
+        ///     specified by ORing the permissions together.
+        /// </param>
         public RequireBotPermissionAttribute(ChannelPermission permission)
         {
             ChannelPermission = permission;
             GuildPermission = null;
         }
 
+        /// <inheritdoc />
         public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
         {
             IGuildUser guildUser = null;
@@ -50,9 +56,9 @@ namespace Discord.Commands
             if (GuildPermission.HasValue)
             {
                 if (guildUser == null)
-                    return PreconditionResult.FromError("Command must be used in a guild channel");
+                    return PreconditionResult.FromError("Command must be used in a guild channel.");
                 if (!guildUser.GuildPermissions.Has(GuildPermission.Value))
-                    return PreconditionResult.FromError($"Bot requires guild permission {GuildPermission.Value}");
+                    return PreconditionResult.FromError($"Bot requires guild permission {GuildPermission.Value}.");
             }
 
             if (ChannelPermission.HasValue)
@@ -64,7 +70,7 @@ namespace Discord.Commands
                     perms = ChannelPermissions.All(context.Channel);
 
                 if (!perms.Has(ChannelPermission.Value))
-                    return PreconditionResult.FromError($"Bot requires channel permission {ChannelPermission.Value}");
+                    return PreconditionResult.FromError($"Bot requires channel permission {ChannelPermission.Value}.");
             }
 
             return PreconditionResult.FromSuccess();
diff --git a/src/Discord.Net.Commands/Attributes/Preconditions/RequireContextAttribute.cs b/src/Discord.Net.Commands/Attributes/Preconditions/RequireContextAttribute.cs
index 90af035e4..810b62014 100644
--- a/src/Discord.Net.Commands/Attributes/Preconditions/RequireContextAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/Preconditions/RequireContextAttribute.cs
@@ -1,35 +1,48 @@
 using System;
 using System.Threading.Tasks;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Defines the type of command context (i.e. where the command is being executed).
+    /// </summary>
     [Flags]
     public enum ContextType
     {
+        /// <summary>
+        ///     Specifies the command to be executed within a guild.
+        /// </summary>
         Guild = 0x01,
+        /// <summary>
+        ///     Specifies the command to be executed within a DM.
+        /// </summary>
         DM = 0x02,
+        /// <summary>
+        ///     Specifies the command to be executed within a group.
+        /// </summary>
         Group = 0x04
     }
 
     /// <summary>
-    /// Require that the command be invoked in a specified context.
+    ///     Requires the command to be invoked in a specified context (e.g. in guild, DM).
     /// </summary>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
     public class RequireContextAttribute : PreconditionAttribute
     {
-        public ContextType Contexts { get; }
-
         /// <summary>
-        /// Require that the command be invoked in a specified context.
+        ///     Gets the context required to execute the command.
         /// </summary>
+        public ContextType Contexts { get; }
+
+        /// <summary> Requires the command to be invoked in the specified context. </summary>
         /// <param name="contexts">The type of context the command can be invoked in. Multiple contexts can be specified by ORing the contexts together.</param>
         /// <example>
-        /// <code language="c#">
-        ///     [Command("private_only")]
+        /// <code language="cs">
+        ///     [Command("secret")]
         ///     [RequireContext(ContextType.DM | ContextType.Group)]
-        ///     public async Task PrivateOnly()
+        ///     public Task PrivateOnlyAsync()
         ///     {
+        ///         return ReplyAsync("shh, this command is a secret");
         ///     }
         /// </code>
         /// </example>
@@ -38,12 +51,13 @@ namespace Discord.Commands
             Contexts = contexts;
         }
 
+        /// <inheritdoc />
         public override Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
         {
             bool isValid = false;
 
             if ((Contexts & ContextType.Guild) != 0)
-                isValid = isValid || context.Channel is IGuildChannel;
+                isValid = context.Channel is IGuildChannel;
             if ((Contexts & ContextType.DM) != 0)
                 isValid = isValid || context.Channel is IDMChannel;
             if ((Contexts & ContextType.Group) != 0)
@@ -52,7 +66,7 @@ namespace Discord.Commands
             if (isValid)
                 return Task.FromResult(PreconditionResult.FromSuccess());
             else
-                return Task.FromResult(PreconditionResult.FromError($"Invalid context for command; accepted contexts: {Contexts}"));
+                return Task.FromResult(PreconditionResult.FromError($"Invalid context for command; accepted contexts: {Contexts}."));
         }
     }
 }
diff --git a/src/Discord.Net.Commands/Attributes/Preconditions/RequireNsfwAttribute.cs b/src/Discord.Net.Commands/Attributes/Preconditions/RequireNsfwAttribute.cs
index 273c764bd..930511da1 100644
--- a/src/Discord.Net.Commands/Attributes/Preconditions/RequireNsfwAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/Preconditions/RequireNsfwAttribute.cs
@@ -4,11 +4,33 @@ using System.Threading.Tasks;
 namespace Discord.Commands
 {
     /// <summary>
-    /// Require that the command is invoked in a channel marked NSFW
+    ///     Requires the command to be invoked in a channel marked NSFW.
     /// </summary>
+    /// <remarks>
+    ///     The precondition will restrict the access of the command or module to be accessed within a guild channel
+    ///     that has been marked as mature or NSFW. If the channel is not of type <see cref="ITextChannel"/> or the
+    ///     channel is not marked as NSFW, the precondition will fail with an erroneous <see cref="PreconditionResult"/>.
+    /// </remarks>
+    /// <example>
+    ///     The following example restricts the command <c>too-cool</c> to an NSFW-enabled channel only.
+    ///     <code language="cs">
+    ///     public class DankModule : ModuleBase
+    ///     {
+    ///         [Command("cool")]
+    ///         public Task CoolAsync()
+    ///             => ReplyAsync("I'm cool for everyone.");
+    ///
+    ///         [RequireNsfw]
+    ///         [Command("too-cool")]
+    ///         public Task TooCoolAsync()
+    ///             => ReplyAsync("You can only see this if you're cool enough.");
+    ///     }
+    ///     </code>
+    /// </example>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
     public class RequireNsfwAttribute : PreconditionAttribute
     {
+        /// <inheritdoc />
         public override Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
         {
             if (context.Channel is ITextChannel text && text.IsNsfw)
diff --git a/src/Discord.Net.Commands/Attributes/Preconditions/RequireOwnerAttribute.cs b/src/Discord.Net.Commands/Attributes/Preconditions/RequireOwnerAttribute.cs
index 93e3cbe18..53021ad10 100644
--- a/src/Discord.Net.Commands/Attributes/Preconditions/RequireOwnerAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/Preconditions/RequireOwnerAttribute.cs
@@ -4,20 +4,45 @@ using System.Threading.Tasks;
 namespace Discord.Commands
 {
     /// <summary>
-    /// Require that the command is invoked by the owner of the bot.
+    ///     Requires the command to be invoked by the owner of the bot.
     /// </summary>
-    /// <remarks>This precondition will only work if the bot is a bot account.</remarks>
+    /// <remarks>
+    ///     This precondition will restrict the access of the command or module to the owner of the Discord application.
+    ///     If the precondition fails to be met, an erroneous <see cref="PreconditionResult"/> will be returned with the
+    ///     message "Command can only be run by the owner of the bot."
+    ///     <note>
+    ///     This precondition will only work if the account has a <see cref="TokenType"/> of <see cref="TokenType.Bot"/>
+    ///     ;otherwise, this precondition will always fail.
+    ///     </note>
+    /// </remarks>
+    /// <example>
+    ///     The following example restricts the command to a set of sensitive commands that only the owner of the bot
+    ///     application should be able to access.
+    ///     <code language="cs">
+    ///     [RequireOwner]
+    ///     [Group("admin")]
+    ///     public class AdminModule : ModuleBase
+    ///     {
+    ///         [Command("exit")]
+    ///         public async Task ExitAsync()
+    ///         {
+    ///             Environment.Exit(0);
+    ///         }
+    ///     }
+    ///     </code>
+    /// </example>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
     public class RequireOwnerAttribute : PreconditionAttribute
     {
+        /// <inheritdoc />
         public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
         {
             switch (context.Client.TokenType)
             {
                 case TokenType.Bot:
-                    var application = await context.Client.GetApplicationInfoAsync();
+                    var application = await context.Client.GetApplicationInfoAsync().ConfigureAwait(false);
                     if (context.User.Id != application.Owner.Id)
-                        return PreconditionResult.FromError("Command can only be run by the owner of the bot");
+                        return PreconditionResult.FromError("Command can only be run by the owner of the bot.");
                     return PreconditionResult.FromSuccess();
                 default:
                     return PreconditionResult.FromError($"{nameof(RequireOwnerAttribute)} is not supported by this {nameof(TokenType)}.");                    
diff --git a/src/Discord.Net.Commands/Attributes/Preconditions/RequireUserPermissionAttribute.cs b/src/Discord.Net.Commands/Attributes/Preconditions/RequireUserPermissionAttribute.cs
index 14121f35b..e9b1c0c5d 100644
--- a/src/Discord.Net.Commands/Attributes/Preconditions/RequireUserPermissionAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/Preconditions/RequireUserPermissionAttribute.cs
@@ -1,47 +1,52 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
     /// <summary>
-    /// This attribute requires that the user invoking the command has a specified permission.
+    ///     Requires the user invoking the command to have a specified permission.
     /// </summary>
     [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
     public class RequireUserPermissionAttribute : PreconditionAttribute
     {
+        /// <summary>
+        ///     Gets the specified <see cref="Discord.GuildPermission" /> of the precondition.
+        /// </summary>
         public GuildPermission? GuildPermission { get; }
+        /// <summary>
+        ///     Gets the specified <see cref="Discord.ChannelPermission" /> of the precondition.
+        /// </summary>
         public ChannelPermission? ChannelPermission { get; }
 
         /// <summary>
-        /// Require that the user invoking the command has a specified GuildPermission
+        ///     Requires that the user invoking the command to have a specific <see cref="Discord.GuildPermission"/>.
         /// </summary>
-        /// <remarks>This precondition will always fail if the command is being invoked in a private channel.</remarks>
-        /// <param name="permission">The GuildPermission that the user must have. Multiple permissions can be specified by ORing the permissions together.</param>
+        /// <remarks>
+        ///     This precondition will always fail if the command is being invoked in a <see cref="IPrivateChannel"/>.
+        /// </remarks>
+        /// <param name="permission">
+        ///     The <see cref="Discord.GuildPermission" /> that the user must have. Multiple permissions can be
+        ///     specified by ORing the permissions together.
+        /// </param>
         public RequireUserPermissionAttribute(GuildPermission permission)
         {
             GuildPermission = permission;
             ChannelPermission = null;
         }
         /// <summary>
-        /// Require that the user invoking the command has a specified ChannelPermission.
+        ///     Requires that the user invoking the command to have a specific <see cref="Discord.ChannelPermission"/>.
         /// </summary>
-        /// <param name="permission">The ChannelPermission that the user must have. Multiple permissions can be specified by ORing the permissions together.</param>
-        /// <example>
-        /// <code language="c#">
-        ///     [Command("permission")]
-        ///     [RequireUserPermission(ChannelPermission.ReadMessageHistory | ChannelPermission.ReadMessages)]
-        ///     public async Task HasPermission()
-        ///     {
-        ///         await ReplyAsync("You can read messages and the message history!");
-        ///     }
-        /// </code>
-        /// </example>
+        /// <param name="permission">
+        ///     The <see cref="Discord.ChannelPermission"/> that the user must have. Multiple permissions can be
+        ///     specified by ORing the permissions together.
+        /// </param>
         public RequireUserPermissionAttribute(ChannelPermission permission)
         {
             ChannelPermission = permission;
             GuildPermission = null;
         }
-        
+
+        /// <inheritdoc />
         public override Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
         {
             var guildUser = context.User as IGuildUser;
@@ -49,9 +54,9 @@ namespace Discord.Commands
             if (GuildPermission.HasValue)
             {
                 if (guildUser == null)
-                    return Task.FromResult(PreconditionResult.FromError("Command must be used in a guild channel"));                
+                    return Task.FromResult(PreconditionResult.FromError("Command must be used in a guild channel."));                
                 if (!guildUser.GuildPermissions.Has(GuildPermission.Value))
-                    return Task.FromResult(PreconditionResult.FromError($"User requires guild permission {GuildPermission.Value}"));
+                    return Task.FromResult(PreconditionResult.FromError($"User requires guild permission {GuildPermission.Value}."));
             }
 
             if (ChannelPermission.HasValue)
@@ -63,7 +68,7 @@ namespace Discord.Commands
                     perms = ChannelPermissions.All(context.Channel);
 
                 if (!perms.Has(ChannelPermission.Value))
-                    return Task.FromResult(PreconditionResult.FromError($"User requires channel permission {ChannelPermission.Value}"));
+                    return Task.FromResult(PreconditionResult.FromError($"User requires channel permission {ChannelPermission.Value}."));
             }
 
             return Task.FromResult(PreconditionResult.FromSuccess());
diff --git a/src/Discord.Net.Commands/Attributes/PriorityAttribute.cs b/src/Discord.Net.Commands/Attributes/PriorityAttribute.cs
index 353e96e41..75ffd2585 100644
--- a/src/Discord.Net.Commands/Attributes/PriorityAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/PriorityAttribute.cs
@@ -2,14 +2,20 @@ using System;
 
 namespace Discord.Commands
 {
-    /// <summary> Sets priority of commands </summary>
+    /// <summary>
+    ///     Sets priority of commands.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
     public class PriorityAttribute : Attribute
     {
-        /// <summary> The priority which has been set for the command </summary>
+        /// <summary>
+        ///     Gets the priority which has been set for the command.
+        /// </summary>
         public int Priority { get; }
 
-        /// <summary> Creates a new <see cref="PriorityAttribute"/> with the given priority. </summary>
+        /// <summary>
+        ///     Initializes a new <see cref="PriorityAttribute" /> attribute with the given priority.
+        /// </summary>
         public PriorityAttribute(int priority)
         {
             Priority = priority;
diff --git a/src/Discord.Net.Commands/Attributes/RemainderAttribute.cs b/src/Discord.Net.Commands/Attributes/RemainderAttribute.cs
index 56938f167..33e07f0d9 100644
--- a/src/Discord.Net.Commands/Attributes/RemainderAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/RemainderAttribute.cs
@@ -2,6 +2,9 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Marks the input to not be parsed by the parser.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class RemainderAttribute : Attribute
     {
diff --git a/src/Discord.Net.Commands/Attributes/RemarksAttribute.cs b/src/Discord.Net.Commands/Attributes/RemarksAttribute.cs
index c11f790a7..2fbe2bf4a 100644
--- a/src/Discord.Net.Commands/Attributes/RemarksAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/RemarksAttribute.cs
@@ -3,6 +3,9 @@ using System;
 namespace Discord.Commands
 {
     // Extension of the Cosmetic Summary, for Groups, Commands, and Parameters
+    /// <summary>
+    ///     Attaches remarks to your commands.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
     public class RemarksAttribute : Attribute
     {
diff --git a/src/Discord.Net.Commands/Attributes/SummaryAttribute.cs b/src/Discord.Net.Commands/Attributes/SummaryAttribute.cs
index 641163408..57e9b0277 100644
--- a/src/Discord.Net.Commands/Attributes/SummaryAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/SummaryAttribute.cs
@@ -3,6 +3,9 @@ using System;
 namespace Discord.Commands
 {
     // Cosmetic Summary, for Groups and Commands
+    /// <summary>
+    ///     Attaches a summary to your command.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class SummaryAttribute : Attribute
     {
diff --git a/src/Discord.Net.Commands/Builders/CommandBuilder.cs b/src/Discord.Net.Commands/Builders/CommandBuilder.cs
index 17a170775..3f1ca883a 100644
--- a/src/Discord.Net.Commands/Builders/CommandBuilder.cs
+++ b/src/Discord.Net.Commands/Builders/CommandBuilder.cs
@@ -118,6 +118,7 @@ namespace Discord.Commands.Builders
             return this;
         }
 
+        /// <exception cref="InvalidOperationException">Only the last parameter in a command may have the Remainder or Multiple flag.</exception>
         internal CommandInfo Build(ModuleInfo info, CommandService service)
         {
             //Default name to primary alias
diff --git a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
index 307874ca6..3b71c87b0 100644
--- a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
+++ b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
@@ -34,7 +34,7 @@ namespace Discord.Commands
                 }
                 else if (IsLoadableModule(typeInfo))
                 {
-                    await service._cmdLogger.WarningAsync($"Class {typeInfo.FullName} is not public and cannot be loaded. To suppress this message, mark the class with {nameof(DontAutoLoadAttribute)}.");
+                    await service._cmdLogger.WarningAsync($"Class {typeInfo.FullName} is not public and cannot be loaded. To suppress this message, mark the class with {nameof(DontAutoLoadAttribute)}.").ConfigureAwait(false);
                 }
             }
 
diff --git a/src/Discord.Net.Commands/CommandContext.cs b/src/Discord.Net.Commands/CommandContext.cs
index 05bde56b1..393cdf97a 100644
--- a/src/Discord.Net.Commands/CommandContext.cs
+++ b/src/Discord.Net.Commands/CommandContext.cs
@@ -1,15 +1,27 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary> The context of a command which may contain the client, user, guild, channel, and message. </summary>
     public class CommandContext : ICommandContext
     {
+        /// <inheritdoc/>
         public IDiscordClient Client { get; }
+        /// <inheritdoc/>
         public IGuild Guild { get; }
+        /// <inheritdoc/>
         public IMessageChannel Channel { get; }
+        /// <inheritdoc/>
         public IUser User { get; }
+        /// <inheritdoc/>
         public IUserMessage Message { get; }
 
+        /// <summary> Indicates whether the channel that the command is executed in is a private channel. </summary>
         public bool IsPrivate => Channel is IPrivateChannel;
-        
+
+        /// <summary>
+        ///     Initializes a new <see cref="CommandContext" /> class with the provided client and message.
+        /// </summary>
+        /// <param name="client">The underlying client.</param>
+        /// <param name="msg">The underlying message.</param>
         public CommandContext(IDiscordClient client, IUserMessage msg)
         {
             Client = client;
diff --git a/src/Discord.Net.Commands/CommandError.cs b/src/Discord.Net.Commands/CommandError.cs
index abfc14e1d..b487d8a1e 100644
--- a/src/Discord.Net.Commands/CommandError.cs
+++ b/src/Discord.Net.Commands/CommandError.cs
@@ -1,26 +1,51 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary> Defines the type of error a command can throw. </summary>
     public enum CommandError
     {
         //Search
+        /// <summary>
+        /// Thrown when the command is unknown.
+        /// </summary>
         UnknownCommand = 1,
 
         //Parse
+        /// <summary>
+        /// Thrown when the command fails to be parsed.
+        /// </summary>
         ParseFailed,
+        /// <summary>
+        /// Thrown when the input text has too few or too many arguments.
+        /// </summary>
         BadArgCount,
 
         //Parse (Type Reader)
         //CastFailed,
+        /// <summary>
+        /// Thrown when the object cannot be found by the <see cref="TypeReader"/>.
+        /// </summary>
         ObjectNotFound,
+        /// <summary>
+        /// Thrown when more than one object is matched by <see cref="TypeReader"/>.
+        /// </summary>
         MultipleMatches,
 
         //Preconditions
+        /// <summary>
+        /// Thrown when the command fails to meet a <see cref="PreconditionAttribute"/>'s conditions.
+        /// </summary>
         UnmetPrecondition,
 
         //Execute
+        /// <summary>
+        /// Thrown when an exception occurs mid-command execution.
+        /// </summary>
         Exception,
 
         //Runtime
+        /// <summary>
+        /// Thrown when the command is not successfully executed on runtime.
+        /// </summary>
         Unsuccessful
     }
 }
diff --git a/src/Discord.Net.Commands/CommandException.cs b/src/Discord.Net.Commands/CommandException.cs
index d5300841a..6c5ab0ae5 100644
--- a/src/Discord.Net.Commands/CommandException.cs
+++ b/src/Discord.Net.Commands/CommandException.cs
@@ -2,11 +2,24 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     The exception that is thrown if another exception occurs during a command execution.
+    /// </summary>
     public class CommandException : Exception
     {
+        /// <summary> Gets the command that caused the exception. </summary>
         public CommandInfo Command { get; }
+        /// <summary> Gets the command context of the exception. </summary>
         public ICommandContext Context { get; }
 
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="CommandException" /> class using a
+        ///     <paramref name="command"/> information, a <paramref name="command"/> context, and the exception that
+        ///     interrupted the execution.
+        /// </summary>
+        /// <param name="command">The command information.</param>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="ex">The exception that interrupted the command execution.</param>
         public CommandException(CommandInfo command, ICommandContext context, Exception ex)
             : base($"Error occurred executing {command.GetLogText(context)}.", ex)
         {
diff --git a/src/Discord.Net.Commands/CommandMatch.cs b/src/Discord.Net.Commands/CommandMatch.cs
index d922a2229..c15a33228 100644
--- a/src/Discord.Net.Commands/CommandMatch.cs
+++ b/src/Discord.Net.Commands/CommandMatch.cs
@@ -1,13 +1,14 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace Discord.Commands
 {
     public struct CommandMatch
     {
+        /// <summary> The command that matches the search result. </summary>
         public CommandInfo Command { get; }
+        /// <summary> The alias of the command. </summary>
         public string Alias { get; }
 
         public CommandMatch(CommandInfo command, string alias)
diff --git a/src/Discord.Net.Commands/CommandParser.cs b/src/Discord.Net.Commands/CommandParser.cs
index 9ce4e1469..49df92a31 100644
--- a/src/Discord.Net.Commands/CommandParser.cs
+++ b/src/Discord.Net.Commands/CommandParser.cs
@@ -170,7 +170,7 @@ namespace Discord.Commands
             if (isEscaping)
                 return ParseResult.FromError(CommandError.ParseFailed, "Input text may not end on an incomplete escape.");
             if (curPart == ParserPart.QuotedParameter)
-                return ParseResult.FromError(CommandError.ParseFailed, "A quoted parameter is incomplete");
+                return ParseResult.FromError(CommandError.ParseFailed, "A quoted parameter is incomplete.");
             
             //Add missing optionals
             for (int i = argList.Count; i < command.Parameters.Count; i++)
diff --git a/src/Discord.Net.Commands/CommandService.cs b/src/Discord.Net.Commands/CommandService.cs
index 7b7cffda2..11f4ce276 100644
--- a/src/Discord.Net.Commands/CommandService.cs
+++ b/src/Discord.Net.Commands/CommandService.cs
@@ -11,11 +11,44 @@ using Discord.Logging;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides a framework for building Discord commands.
+    /// </summary>
+    /// <remarks>
+    ///     <para>
+    ///         The service provides a framework for building Discord commands both dynamically via runtime builders or
+    ///         statically via compile-time modules. To create a command module at compile-time, see
+    ///         <see cref="ModuleBase" /> (most common); otherwise, see <see cref="ModuleBuilder" />.
+    ///     </para>
+    ///     <para>
+    ///         This service also provides several events for monitoring command usages; such as
+    ///         <see cref="Discord.Commands.CommandService.Log" /> for any command-related log events, and
+    ///         <see cref="Discord.Commands.CommandService.CommandExecuted" /> for information about commands that have
+    ///         been successfully executed.
+    ///     </para>
+    /// </remarks>
     public class CommandService
     {
+        /// <summary>
+        ///     Occurs when a command-related information is received.
+        /// </summary>
         public event Func<LogMessage, Task> Log { add { _logEvent.Add(value); } remove { _logEvent.Remove(value); } }
         internal readonly AsyncEvent<Func<LogMessage, Task>> _logEvent = new AsyncEvent<Func<LogMessage, Task>>();
 
+        /// <summary>
+        ///     Occurs when a command is successfully executed without any error.
+        /// </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a command has been successfully executed without any of the following errors:
+        ///     </para>
+        ///         <para>* Parsing error</para>
+        ///         <para>* Precondition error</para>
+        ///         <para>* Runtime exception</para>
+        ///     <para>
+        ///         Should the command encounter any of the aforementioned error, this event will not be raised.
+        ///     </para>
+        /// </remarks>
         public event Func<CommandInfo, ICommandContext, IResult, Task> CommandExecuted { add { _commandExecutedEvent.Add(value); } remove { _commandExecutedEvent.Remove(value); } }
         internal readonly AsyncEvent<Func<CommandInfo, ICommandContext, IResult, Task>> _commandExecutedEvent = new AsyncEvent<Func<CommandInfo, ICommandContext, IResult, Task>>();
 
@@ -34,11 +67,33 @@ namespace Discord.Commands
         internal readonly LogManager _logManager;
         internal readonly IReadOnlyDictionary<char, char> _quotationMarkAliasMap;
 
+        /// <summary>
+        ///     Represents all modules loaded within <see cref="CommandService"/>.
+        /// </summary>
         public IEnumerable<ModuleInfo> Modules => _moduleDefs.Select(x => x);
+
+        /// <summary>
+        ///     Represents all commands loaded within <see cref="CommandService"/>.
+        /// </summary>
         public IEnumerable<CommandInfo> Commands => _moduleDefs.SelectMany(x => x.Commands);
+
+        /// <summary>
+        ///     Represents all <see cref="TypeReader" /> loaded within <see cref="CommandService"/>.
+        /// </summary>
         public ILookup<Type, TypeReader> TypeReaders => _typeReaders.SelectMany(x => x.Value.Select(y => new { y.Key, y.Value })).ToLookup(x => x.Key, x => x.Value);
 
+        /// <summary>
+        ///     Initializes a new <see cref="CommandService"/> class.
+        /// </summary>
         public CommandService() : this(new CommandServiceConfig()) { }
+
+        /// <summary>
+        ///     Initializes a new <see cref="CommandService"/> class with the provided configuration.
+        /// </summary>
+        /// <param name="config">The configuration class.</param>
+        /// <exception cref="InvalidOperationException">
+        /// The <see cref="RunMode"/> cannot be set to <see cref="RunMode.Default"/>.
+        /// </exception>
         public CommandService(CommandServiceConfig config)
         {
             _caseSensitive = config.CaseSensitiveCommands;
@@ -102,12 +157,39 @@ namespace Discord.Commands
         }
 
         /// <summary>
-        /// Add a command module from a type
+        ///     Add a command module from a <see cref="Type" />.
         /// </summary>
-        /// <typeparam name="T">The type of module</typeparam>
-        /// <param name="services">An IServiceProvider for your dependency injection solution, if using one - otherwise, pass null</param>
-        /// <returns>A built module</returns>
+        /// <example>
+        ///     <para>The following example registers the module <c>MyModule</c> to <c>commandService</c>.</para>
+        ///     <code language="cs">
+        ///     await commandService.AddModuleAsync&lt;MyModule&gt;(serviceProvider);
+        ///     </code>
+        /// </example>
+        /// <typeparam name="T">The type of module.</typeparam>
+        /// <param name="services">The <see cref="IServiceProvider"/> for your dependency injection solution if using one; otherwise, pass <c>null</c>.</param>
+        /// <exception cref="ArgumentException">This module has already been added.</exception>
+        /// <exception cref="InvalidOperationException">
+        /// The <see cref="ModuleInfo"/> fails to be built; an invalid type may have been provided.
+        /// </exception>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for adding the module. The task result contains the
+        ///     built module.
+        /// </returns>
         public Task<ModuleInfo> AddModuleAsync<T>(IServiceProvider services) => AddModuleAsync(typeof(T), services);
+
+        /// <summary>
+        ///     Adds a command module from a <see cref="Type" />.
+        /// </summary>
+        /// <param name="type">The type of module.</param>
+        /// <param name="services">The <see cref="IServiceProvider" /> for your dependency injection solution if using one; otherwise, pass <c>null</c> .</param>
+        /// <exception cref="ArgumentException">This module has already been added.</exception>
+        /// <exception cref="InvalidOperationException">
+        /// The <see cref="ModuleInfo"/> fails to be built; an invalid type may have been provided.
+        /// </exception>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for adding the module. The task result contains the
+        ///     built module.
+        /// </returns>
         public async Task<ModuleInfo> AddModuleAsync(Type type, IServiceProvider services)
         {
             services = services ?? EmptyServiceProvider.Instance;
@@ -135,11 +217,14 @@ namespace Discord.Commands
             }
         }
         /// <summary>
-        /// Add command modules from an assembly
+        ///     Add command modules from an <see cref="Assembly"/>.
         /// </summary>
-        /// <param name="assembly">The assembly containing command modules</param>
-        /// <param name="services">An IServiceProvider for your dependency injection solution, if using one - otherwise, pass null</param>
-        /// <returns>A collection of built modules</returns>
+        /// <param name="assembly">The <see cref="Assembly"/> containing command modules.</param>
+        /// <param name="services">The <see cref="IServiceProvider"/> for your dependency injection solution if using one; otherwise, pass <c>null</c>.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for adding the command modules. The task result
+        ///     contains an enumerable collection of modules added.
+        /// </returns>
         public async Task<IEnumerable<ModuleInfo>> AddModulesAsync(Assembly assembly, IServiceProvider services)
         {
             services = services ?? EmptyServiceProvider.Instance;
@@ -175,7 +260,14 @@ namespace Discord.Commands
 
             return module;
         }
-
+        /// <summary>
+        ///     Removes the command module.
+        /// </summary>
+        /// <param name="module">The <see cref="ModuleInfo" /> to be removed from the service.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation. The task result contains a value that
+        ///     indicates whether the <paramref name="module"/> is successfully removed.
+        /// </returns>
         public async Task<bool> RemoveModuleAsync(ModuleInfo module)
         {
             await _moduleLock.WaitAsync().ConfigureAwait(false);
@@ -188,7 +280,23 @@ namespace Discord.Commands
                 _moduleLock.Release();
             }
         }
+        /// <summary>
+        ///     Removes the command module.
+        /// </summary>
+        /// <typeparam name="T">The <see cref="Type"/> of the module.</typeparam>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation. The task result contains a value that
+        ///     indicates whether the module is successfully removed.
+        /// </returns>
         public Task<bool> RemoveModuleAsync<T>() => RemoveModuleAsync(typeof(T));
+        /// <summary>
+        ///     Removes the command module.
+        /// </summary>
+        /// <param name="type">The <see cref="Type"/> of the module.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation. The task result contains a value that
+        ///     indicates whether the module is successfully removed.
+        /// </returns>
         public async Task<bool> RemoveModuleAsync(Type type)
         {
             await _moduleLock.WaitAsync().ConfigureAwait(false);
@@ -222,21 +330,27 @@ namespace Discord.Commands
 
         //Type Readers
         /// <summary>
-        /// Adds a custom <see cref="TypeReader"/> to this <see cref="CommandService"/> for the supplied object type. 
-        /// If <typeparamref name="T"/> is a <see cref="ValueType"/>, a <see cref="NullableTypeReader{T}"/> will also be added.
-        /// If a default <see cref="TypeReader"/> exists for <typeparamref name="T"/>, a warning will be logged and the default <see cref="TypeReader"/> will be replaced. 
+        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object 
+        ///     type.
+        ///     If <typeparamref name="T" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> will 
+        ///     also be added.
+        ///     If a default <see cref="TypeReader" /> exists for <typeparamref name="T" />, a warning will be logged
+        ///     and the default <see cref="TypeReader" /> will be replaced.
         /// </summary>
         /// <typeparam name="T">The object type to be read by the <see cref="TypeReader"/>.</typeparam>
-        /// <param name="reader">An instance of the <see cref="TypeReader"/> to be added.</param>
+        /// <param name="reader">An instance of the <see cref="TypeReader" /> to be added.</param>
         public void AddTypeReader<T>(TypeReader reader)
             => AddTypeReader(typeof(T), reader);
         /// <summary>
-        /// Adds a custom <see cref="TypeReader"/> to this <see cref="CommandService"/> for the supplied object type. 
-        /// If <paramref name="type"/> is a <see cref="ValueType"/>, a <see cref="NullableTypeReader{T}"/> for the value type will also be added.
-        /// If a default <see cref="TypeReader"/> exists for <paramref name="type"/>, a warning will be logged and the default <see cref="TypeReader"/> will be replaced.
+        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object
+        ///     type.
+        ///     If <paramref name="type" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> for the
+        ///     value type will also be added.
+        ///     If a default <see cref="TypeReader" /> exists for <paramref name="type" />, a warning will be logged and
+        ///     the default <see cref="TypeReader" /> will be replaced.
         /// </summary>
-        /// <param name="type">A <see cref="Type"/> instance for the type to be read.</param>
-        /// <param name="reader">An instance of the <see cref="TypeReader"/> to be added.</param>
+        /// <param name="type">A <see cref="Type" /> instance for the type to be read.</param>
+        /// <param name="reader">An instance of the <see cref="TypeReader" /> to be added.</param>
         public void AddTypeReader(Type type, TypeReader reader)
         {
             if (_defaultTypeReaders.ContainsKey(type))
@@ -245,21 +359,31 @@ namespace Discord.Commands
             AddTypeReader(type, reader, true);
         }
         /// <summary>
-        /// Adds a custom <see cref="TypeReader"/> to this <see cref="CommandService"/> for the supplied object type. 
-        /// If <typeparamref name="T"/> is a <see cref="ValueType"/>, a <see cref="NullableTypeReader{T}"/> will also be added.
+        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object
+        ///     type.
+        ///     If <typeparamref name="T" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> will
+        ///     also be added.
         /// </summary>
         /// <typeparam name="T">The object type to be read by the <see cref="TypeReader"/>.</typeparam>
-        /// <param name="reader">An instance of the <see cref="TypeReader"/> to be added.</param>
-        /// <param name="replaceDefault">If <paramref name="reader"/> should replace the default <see cref="TypeReader"/> for <typeparamref name="T"/> if one exists.</param>
+        /// <param name="reader">An instance of the <see cref="TypeReader" /> to be added.</param>
+        /// <param name="replaceDefault">
+        ///     Defines whether the <see cref="TypeReader"/> should replace the default one for
+        ///     <see cref="Type" /> if it exists.
+        /// </param>
         public void AddTypeReader<T>(TypeReader reader, bool replaceDefault)
             => AddTypeReader(typeof(T), reader, replaceDefault);
         /// <summary>
-        /// Adds a custom <see cref="TypeReader"/> to this <see cref="CommandService"/> for the supplied object type. 
-        /// If <paramref name="type"/> is a <see cref="ValueType"/>, a <see cref="NullableTypeReader{T}"/> for the value type will also be added. 
+        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object
+        ///     type.
+        ///     If <paramref name="type" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> for the
+        ///     value type will also be added.
         /// </summary>
-        /// <param name="type">A <see cref="Type"/> instance for the type to be read.</param>
-        /// <param name="reader">An instance of the <see cref="TypeReader"/> to be added.</param>
-        /// <param name="replaceDefault">If <paramref name="reader"/> should replace the default <see cref="TypeReader"/> for <paramref name="type"/> if one exists.</param>
+        /// <param name="type">A <see cref="Type" /> instance for the type to be read.</param>
+        /// <param name="reader">An instance of the <see cref="TypeReader" /> to be added.</param>
+        /// <param name="replaceDefault">
+        ///     Defines whether the <see cref="TypeReader"/> should replace the default one for <see cref="Type" /> if
+        ///     it exists.
+        /// </param>
         public void AddTypeReader(Type type, TypeReader reader, bool replaceDefault)
         {
             if (replaceDefault && HasDefaultTypeReader(type))
@@ -331,8 +455,20 @@ namespace Discord.Commands
         }
 
         //Execution
+        /// <summary>
+        ///     Searches for the command.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="argPos">The position of which the command starts at.</param>
+        /// <returns>The result containing the matching commands.</returns>
         public SearchResult Search(ICommandContext context, int argPos)
             => Search(context.Message.Content.Substring(argPos));
+        /// <summary>
+        ///     Searches for the command.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="input">The command string.</param>
+        /// <returns>The result containing the matching commands.</returns>
         public SearchResult Search(ICommandContext context, string input)
             => Search(input);
         public SearchResult Search(string input)
@@ -346,8 +482,30 @@ namespace Discord.Commands
                 return SearchResult.FromError(CommandError.UnknownCommand, "Unknown command.");
         }
 
+        /// <summary>
+        ///     Executes the command.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="argPos">The position of which the command starts at.</param>
+        /// <param name="services">The service to be used in the command's dependency injection.</param>
+        /// <param name="multiMatchHandling">The handling mode when multiple command matches are found.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous execution operation. The task result contains the result of the
+        ///     command execution.
+        /// </returns>
         public Task<IResult> ExecuteAsync(ICommandContext context, int argPos, IServiceProvider services, MultiMatchHandling multiMatchHandling = MultiMatchHandling.Exception)
             => ExecuteAsync(context, context.Message.Content.Substring(argPos), services, multiMatchHandling);
+        /// <summary>
+        ///     Executes the command.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="input">The command string.</param>
+        /// <param name="services">The service to be used in the command's dependency injection.</param>
+        /// <param name="multiMatchHandling">The handling mode when multiple command matches are found.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous execution operation. The task result contains the result of the
+        ///     command execution.
+        /// </returns>
         public async Task<IResult> ExecuteAsync(ICommandContext context, string input, IServiceProvider services, MultiMatchHandling multiMatchHandling = MultiMatchHandling.Exception)
         {
             services = services ?? EmptyServiceProvider.Instance;
diff --git a/src/Discord.Net.Commands/CommandServiceConfig.cs b/src/Discord.Net.Commands/CommandServiceConfig.cs
index 00091634d..2dedceaa5 100644
--- a/src/Discord.Net.Commands/CommandServiceConfig.cs
+++ b/src/Discord.Net.Commands/CommandServiceConfig.cs
@@ -1,29 +1,62 @@
-using System;
 using System.Collections.Generic;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Represents a configuration class for <see cref="CommandService"/>.
+    /// </summary>
     public class CommandServiceConfig
     {
-        /// <summary> Gets or sets the default RunMode commands should have, if one is not specified on the Command attribute or builder. </summary>
+        /// <summary>
+        ///     Gets or sets the default <see cref="RunMode" /> commands should have, if one is not specified on the
+        ///     Command attribute or builder.
+        /// </summary>
         public RunMode DefaultRunMode { get; set; } = RunMode.Sync;
 
+        /// <summary>
+        ///     Gets or sets the <see cref="char"/> that separates an argument with another.
+        /// </summary>
         public char SeparatorChar { get; set; } = ' ';
         
-        /// <summary> Determines whether commands should be case-sensitive. </summary>
+        /// <summary>
+        ///     Gets or sets whether commands should be case-sensitive.
+        /// </summary>
         public bool CaseSensitiveCommands { get; set; } = false;
 
-        /// <summary> Gets or sets the minimum log level severity that will be sent to the Log event. </summary>
+        /// <summary>
+        ///     Gets or sets the minimum log level severity that will be sent to the <see cref="CommandService.Log"/> event.
+        /// </summary>
         public LogSeverity LogLevel { get; set; } = LogSeverity.Info;
 
-        /// <summary> Determines whether RunMode.Sync commands should push exceptions up to the caller. </summary>
+        /// <summary>
+        ///     Gets or sets whether <see cref="RunMode.Sync"/> commands should push exceptions up to the caller.
+        /// </summary>
         public bool ThrowOnError { get; set; } = true;
 
-        /// <summary> Collection of aliases that can wrap strings for command parsing. 
-        /// represents the opening quotation mark and the value is the corresponding closing mark.</summary>
+        /// <summary>
+        /// Collection of aliases for matching pairs of string delimiters.
+        /// The dictionary stores the opening delimiter as a key, and the matching closing delimiter as the value.
+        /// If no value is supplied <see cref="QuotationAliasUtils.GetDefaultAliasMap"/> will be used, which contains
+        /// many regional equivalents.
+        /// Only values that are specified in this map will be used as string delimiters, so if " is removed then
+        /// it won't be used.
+        /// If this map is set to null or empty, the default delimiter of " will be used.
+        /// </summary>
+        /// <example>
+        /// <code language="cs">
+        /// QuotationMarkAliasMap = new Dictionary&lt;char, char%gt;()
+        /// {
+        ///     {'\"', '\"' },
+        ///     {'“', '”' },
+        ///     {'「', '」' },
+        /// }
+        /// </code>
+        /// </example>
         public Dictionary<char, char> QuotationMarkAliasMap { get; set; } = QuotationAliasUtils.GetDefaultAliasMap;
 
-        /// <summary> Determines whether extra parameters should be ignored. </summary>
+        /// <summary>
+        ///     Gets or sets a value that indicates whether extra parameters should be ignored.
+        /// </summary>
         public bool IgnoreExtraArgs { get; set; } = false;
     }
 }
diff --git a/src/Discord.Net.Commands/Extensions/MessageExtensions.cs b/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
index a27c5f322..f76df1f2a 100644
--- a/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
+++ b/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
@@ -2,8 +2,20 @@ using System;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides extension methods for <see cref="IUserMessage" /> that relates to commands.
+    /// </summary>
     public static class MessageExtensions
     {
+        /// <summary>
+        ///     Gets whether the message starts with the provided character.
+        /// </summary>
+        /// <param name="msg">The message to check against.</param>
+        /// <param name="c">The char prefix.</param>
+        /// <param name="argPos">References where the command starts.</param>
+        /// <returns>
+        ///     <c>true</c> if the message begins with the char <paramref name="c"/>; otherwise <c>false</c>.
+        /// </returns>
         public static bool HasCharPrefix(this IUserMessage msg, char c, ref int argPos)
         {
             var text = msg.Content;
@@ -14,6 +26,9 @@ namespace Discord.Commands
             }
             return false;
         }
+        /// <summary>
+        ///     Gets whether the message starts with the provided string.
+        /// </summary>
         public static bool HasStringPrefix(this IUserMessage msg, string str, ref int argPos, StringComparison comparisonType = StringComparison.Ordinal)
         {
             var text = msg.Content;
@@ -24,6 +39,9 @@ namespace Discord.Commands
             }
             return false;
         }
+        /// <summary>
+        ///     Gets whether the message starts with the user's mention string.
+        /// </summary>
         public static bool HasMentionPrefix(this IUserMessage msg, IUser user, ref int argPos)
         {
             var text = msg.Content;
diff --git a/src/Discord.Net.Commands/Info/CommandInfo.cs b/src/Discord.Net.Commands/Info/CommandInfo.cs
index 604bfbc93..d27a1ed7b 100644
--- a/src/Discord.Net.Commands/Info/CommandInfo.cs
+++ b/src/Discord.Net.Commands/Info/CommandInfo.cs
@@ -8,10 +8,16 @@ using System.Linq;
 using System.Reflection;
 using System.Runtime.ExceptionServices;
 using System.Threading.Tasks;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides the information of a command.
+    /// </summary>
+    /// <remarks>
+    ///     This object contains the information of a command. This can include the module of the command, various
+    ///     descriptions regarding the command, and its <see cref="RunMode"/>.
+    /// </remarks>
     [DebuggerDisplay("{Name,nq}")]
     public class CommandInfo
     {
@@ -21,18 +27,63 @@ namespace Discord.Commands
         private readonly CommandService _commandService;
         private readonly Func<ICommandContext, object[], IServiceProvider, CommandInfo, Task> _action;
 
+        /// <summary>
+        ///     Gets the module that the command belongs in.
+        /// </summary>
         public ModuleInfo Module { get; }
+        /// <summary>
+        ///     Gets the name of the command. If none is set, the first alias is used.
+        /// </summary>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the summary of the command.
+        /// </summary>
+        /// <remarks>
+        ///     This field returns the summary of the command. <see cref="Summary"/> and <see cref="Remarks"/> can be
+        ///     useful in help commands and various implementation that fetches details of the command for the user.
+        /// </remarks>
         public string Summary { get; }
+        /// <summary>
+        ///     Gets the remarks of the command.
+        /// </summary>
+        /// <remarks>
+        ///     This field returns the summary of the command. <see cref="Summary"/> and <see cref="Remarks"/> can be
+        ///     useful in help commands and various implementation that fetches details of the command for the user.
+        /// </remarks>
         public string Remarks { get; }
+        /// <summary>
+        ///     Gets the priority of the command. This is used when there are multiple overloads of the command.
+        /// </summary>
         public int Priority { get; }
+        /// <summary>
+        ///     Indicates whether the command accepts a <see langword="params"/> <see cref="Type"/>[] for its
+        ///     parameter.
+        /// </summary>
         public bool HasVarArgs { get; }
+        /// <summary>
+        ///     Indicates whether extra arguments should be ignored for this command.
+        /// </summary>
         public bool IgnoreExtraArgs { get; }
+        /// <summary>
+        ///     Gets the <see cref="RunMode" /> that is being used for the command.
+        /// </summary>
         public RunMode RunMode { get; }
 
+        /// <summary>
+        ///     Gets a list of aliases defined by the <see cref="AliasAttribute" /> of the command.
+        /// </summary>
         public IReadOnlyList<string> Aliases { get; }
+        /// <summary>
+        ///     Gets a list of information about the parameters of the command.
+        /// </summary>
         public IReadOnlyList<ParameterInfo> Parameters { get; }
+        /// <summary>
+        ///     Gets a list of preconditions defined by the <see cref="PreconditionAttribute" /> of the command.
+        /// </summary>
         public IReadOnlyList<PreconditionAttribute> Preconditions { get; }
+        /// <summary>
+        ///     Gets a list of attributes of the command.
+        /// </summary>
         public IReadOnlyList<Attribute> Attributes { get; }
 
         internal CommandInfo(CommandBuilder builder, ModuleInfo module, CommandService service)
@@ -100,11 +151,11 @@ namespace Discord.Commands
                 return PreconditionGroupResult.FromSuccess();
             }
 
-            var moduleResult = await CheckGroups(Module.Preconditions, "Module");
+            var moduleResult = await CheckGroups(Module.Preconditions, "Module").ConfigureAwait(false);
             if (!moduleResult.IsSuccess)
                 return moduleResult;
 
-            var commandResult = await CheckGroups(Preconditions, "Command");
+            var commandResult = await CheckGroups(Preconditions, "Command").ConfigureAwait(false);
             if (!commandResult.IsSuccess)
                 return commandResult;
 
@@ -124,7 +175,7 @@ namespace Discord.Commands
 
             return await CommandParser.ParseArgsAsync(this, context, _commandService._ignoreExtraArgs, services, input, 0, _commandService._quotationMarkAliasMap).ConfigureAwait(false);
         }
-
+        
         public Task<IResult> ExecuteAsync(ICommandContext context, ParseResult parseResult, IServiceProvider services)
         {
             if (!parseResult.IsSuccess)
@@ -248,11 +299,11 @@ namespace Discord.Commands
             foreach (object arg in argList)
             {
                 if (i == argCount)
-                    throw new InvalidOperationException("Command was invoked with too many parameters");
+                    throw new InvalidOperationException("Command was invoked with too many parameters.");
                 array[i++] = arg;
             }
             if (i < argCount)
-                throw new InvalidOperationException("Command was invoked with too few parameters");
+                throw new InvalidOperationException("Command was invoked with too few parameters.");
 
             if (HasVarArgs)
             {
diff --git a/src/Discord.Net.Commands/Info/ModuleInfo.cs b/src/Discord.Net.Commands/Info/ModuleInfo.cs
index 7c144599b..7b9959efe 100644
--- a/src/Discord.Net.Commands/Info/ModuleInfo.cs
+++ b/src/Discord.Net.Commands/Info/ModuleInfo.cs
@@ -6,20 +6,59 @@ using Discord.Commands.Builders;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides the information of a module.
+    /// </summary>
     public class ModuleInfo
     {
+        /// <summary>
+        ///     Gets the command service associated with this module.
+        /// </summary>
         public CommandService Service { get; }
+        /// <summary>
+        ///     Gets the name of this module.
+        /// </summary>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the summary of this module.
+        /// </summary>
         public string Summary { get; }
+        /// <summary>
+        ///     Gets the remarks of this module.
+        /// </summary>
         public string Remarks { get; }
+        /// <summary>
+        ///     Gets the group name (main prefix) of this module.
+        /// </summary>
         public string Group { get; }
 
+        /// <summary>
+        ///     Gets a read-only list of aliases associated with this module.
+        /// </summary>
         public IReadOnlyList<string> Aliases { get; }
+        /// <summary>
+        ///     Gets a read-only list of commands associated with this module.
+        /// </summary>
         public IReadOnlyList<CommandInfo> Commands { get; }
+        /// <summary>
+        ///     Gets a read-only list of preconditions that apply to this module.
+        /// </summary>
         public IReadOnlyList<PreconditionAttribute> Preconditions { get; }
+        /// <summary>
+        ///     Gets a read-only list of attributes that apply to this module.
+        /// </summary>
         public IReadOnlyList<Attribute> Attributes { get; }
+        /// <summary>
+        ///     Gets a read-only list of submodules associated with this module.
+        /// </summary>
         public IReadOnlyList<ModuleInfo> Submodules { get; }
+        /// <summary>
+        ///     Gets the parent module of this submodule if applicable.
+        /// </summary>
         public ModuleInfo Parent { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this module is a submodule or not.
+        /// </summary>
         public bool IsSubmodule => Parent != null;
 
         internal ModuleInfo(ModuleBuilder builder, CommandService service, IServiceProvider services, ModuleInfo parent = null)
diff --git a/src/Discord.Net.Commands/Info/ParameterInfo.cs b/src/Discord.Net.Commands/Info/ParameterInfo.cs
index 4a56415e5..b435b301a 100644
--- a/src/Discord.Net.Commands/Info/ParameterInfo.cs
+++ b/src/Discord.Net.Commands/Info/ParameterInfo.cs
@@ -2,25 +2,56 @@ using Discord.Commands.Builders;
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
+using System.Diagnostics;
 using System.Threading.Tasks;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides the information of a parameter.
+    /// </summary>
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class ParameterInfo
     {
         private readonly TypeReader _reader;
 
+        /// <summary>
+        ///     Gets the command that associates with this parameter.
+        /// </summary>
         public CommandInfo Command { get; }
+        /// <summary>
+        ///     Gets the name of this parameter.
+        /// </summary>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the summary of this parameter.
+        /// </summary>
         public string Summary { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this parameter is optional or not.
+        /// </summary>
         public bool IsOptional { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this parameter is a remainder parameter or not.
+        /// </summary>
         public bool IsRemainder { get; }
         public bool IsMultiple { get; }
+        /// <summary>
+        ///     Gets the type of the parameter.
+        /// </summary>
         public Type Type { get; }
+        /// <summary>
+        ///     Gets the default value for this optional parameter if applicable.
+        /// </summary>
         public object DefaultValue { get; }
 
+        /// <summary>
+        ///     Gets a read-only list of precondition that apply to this parameter.
+        /// </summary>
         public IReadOnlyList<ParameterPreconditionAttribute> Preconditions { get; }
+        /// <summary>
+        ///     Gets a read-only list of attributes that apply to this parameter.
+        /// </summary>
         public IReadOnlyList<Attribute> Attributes { get; }
 
         internal ParameterInfo(ParameterBuilder builder, CommandInfo command, CommandService service)
@@ -65,4 +96,4 @@ namespace Discord.Commands
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name}{(IsOptional ? " (Optional)" : "")}{(IsRemainder ? " (Remainder)" : "")}";
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Commands/Map/CommandMapNode.cs b/src/Discord.Net.Commands/Map/CommandMapNode.cs
index bd3067718..16f469cde 100644
--- a/src/Discord.Net.Commands/Map/CommandMapNode.cs
+++ b/src/Discord.Net.Commands/Map/CommandMapNode.cs
@@ -23,6 +23,7 @@ namespace Discord.Commands
             _commands = ImmutableArray.Create<CommandInfo>();
         }
 
+        /// <exception cref="InvalidOperationException">Cannot add commands to the root node.</exception>
         public void AddCommand(CommandService service, string text, int index, CommandInfo command)
         {
             int nextSegment = NextSegment(text, index, service._separatorChar);
diff --git a/src/Discord.Net.Commands/ModuleBase.cs b/src/Discord.Net.Commands/ModuleBase.cs
index 3e6fbbd9b..9cd4ea15d 100644
--- a/src/Discord.Net.Commands/ModuleBase.cs
+++ b/src/Discord.Net.Commands/ModuleBase.cs
@@ -4,32 +4,57 @@ using Discord.Commands.Builders;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides a base class for a command module to inherit from.
+    /// </summary>
     public abstract class ModuleBase : ModuleBase<ICommandContext> { }
 
+    /// <summary>
+    ///     Provides a base class for a command module to inherit from.
+    /// </summary>
+    /// <typeparam name="T">A class that implements <see cref="ICommandContext"/>.</typeparam>
     public abstract class ModuleBase<T> : IModuleBase
         where T : class, ICommandContext
     {
+        /// <summary>
+        ///     The underlying context of the command.
+        /// </summary>
+        /// <seealso cref="T:Discord.Commands.ICommandContext" />
+        /// <seealso cref="T:Discord.Commands.CommandContext" />
         public T Context { get; private set; }
 
         /// <summary>
-        /// Sends a message to the source channel
+        ///     Sends a message to the source channel.
         /// </summary>
-        /// <param name="message">Contents of the message; optional only if <paramref name="embed"/> is specified</param>
-        /// <param name="isTTS">Specifies if Discord should read this message aloud using TTS</param>
-        /// <param name="embed">An embed to be displayed alongside the message</param>
+        /// <param name="message">
+        /// Contents of the message; optional only if <paramref name="embed" /> is specified.
+        /// </param>
+        /// <param name="isTTS">Specifies if Discord should read this <paramref name="message"/> aloud using text-to-speech.</param>
+        /// <param name="embed">An embed to be displayed alongside the <paramref name="message"/>.</param>
         protected virtual async Task<IUserMessage> ReplyAsync(string message = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
         {
             return await Context.Channel.SendMessageAsync(message, isTTS, embed, options).ConfigureAwait(false);
         }
-
+        /// <summary>
+        ///     The method to execute before executing the command.
+        /// </summary>
+        /// <param name="command">The <see cref="CommandInfo"/> of the command to be executed.</param>
         protected virtual void BeforeExecute(CommandInfo command)
         {
         }
-
+        /// <summary>
+        ///     The method to execute after executing the command.
+        /// </summary>
+        /// <param name="command">The <see cref="CommandInfo"/> of the command to be executed.</param>
         protected virtual void AfterExecute(CommandInfo command)
         {
         }
 
+        /// <summary>
+        ///     The method to execute when building the module.
+        /// </summary>
+        /// <param name="commandService">The <see cref="CommandService"/> used to create the module.</param>
+        /// <param name="builder">The builder used to build the module.</param>
         protected virtual void OnModuleBuilding(CommandService commandService, ModuleBuilder builder)
         {
         }
@@ -38,7 +63,7 @@ namespace Discord.Commands
         void IModuleBase.SetContext(ICommandContext context)
         {
             var newValue = context as T;
-            Context = newValue ?? throw new InvalidOperationException($"Invalid context type. Expected {typeof(T).Name}, got {context.GetType().Name}");
+            Context = newValue ?? throw new InvalidOperationException($"Invalid context type. Expected {typeof(T).Name}, got {context.GetType().Name}.");
         }
         void IModuleBase.BeforeExecute(CommandInfo command) => BeforeExecute(command);
         void IModuleBase.AfterExecute(CommandInfo command) => AfterExecute(command);
diff --git a/src/Discord.Net.Commands/MultiMatchHandling.cs b/src/Discord.Net.Commands/MultiMatchHandling.cs
index 89dcf1c06..319e58edd 100644
--- a/src/Discord.Net.Commands/MultiMatchHandling.cs
+++ b/src/Discord.Net.Commands/MultiMatchHandling.cs
@@ -1,8 +1,13 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary>
+    /// Specifies the behavior when multiple matches are found during the command parsing stage.
+    /// </summary>
     public enum MultiMatchHandling
     {
+        /// <summary> Indicates that when multiple results are found, an exception should be thrown. </summary>
         Exception,
+        /// <summary> Indicates that when multiple results are found, the best result should be chosen. </summary>
         Best
     }
 }
diff --git a/src/Discord.Net.Commands/Readers/ChannelTypeReader.cs b/src/Discord.Net.Commands/Readers/ChannelTypeReader.cs
index cd7a9d744..cdbc59cef 100644
--- a/src/Discord.Net.Commands/Readers/ChannelTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/ChannelTypeReader.cs
@@ -6,19 +6,29 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     A <see cref="TypeReader"/> for parsing objects implementing <see cref="IChannel"/>.
+    /// </summary>
+    /// <remarks>
+    ///     This <see cref="TypeReader"/> is shipped with Discord.Net and is used by default to parse any 
+    ///     <see cref="IChannel"/> implemented object within a command. The TypeReader will attempt to first parse the
+    ///     input by mention, then the snowflake identifier, then by name; the highest candidate will be chosen as the
+    ///     final output; otherwise, an erroneous <see cref="TypeReaderResult"/> is returned.
+    /// </remarks>
+    /// <typeparam name="T">The type to be checked; must implement <see cref="IChannel"/>.</typeparam>
     public class ChannelTypeReader<T> : TypeReader
         where T : class, IChannel
     {
+        /// <inheritdoc />
         public override async Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
             if (context.Guild != null)
             {
                 var results = new Dictionary<ulong, TypeReaderValue>();
                 var channels = await context.Guild.GetChannelsAsync(CacheMode.CacheOnly).ConfigureAwait(false);
-                ulong id;
 
                 //By Mention (1.0)
-                if (MentionUtils.TryParseChannel(input, out id))
+                if (MentionUtils.TryParseChannel(input, out ulong id))
                     AddResult(results, await context.Guild.GetChannelAsync(id, CacheMode.CacheOnly).ConfigureAwait(false) as T, 1.00f);
 
                 //By Id (0.9)
diff --git a/src/Discord.Net.Commands/Readers/EnumTypeReader.cs b/src/Discord.Net.Commands/Readers/EnumTypeReader.cs
index c097e6189..356d704c9 100644
--- a/src/Discord.Net.Commands/Readers/EnumTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/EnumTypeReader.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
@@ -44,6 +44,7 @@ namespace Discord.Commands
             _enumsByValue = byValueBuilder.ToImmutable();
         }
 
+        /// <inheritdoc />
         public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
             object enumValue;
@@ -53,14 +54,14 @@ namespace Discord.Commands
                 if (_enumsByValue.TryGetValue(baseValue, out enumValue))
                     return Task.FromResult(TypeReaderResult.FromSuccess(enumValue));
                 else
-                    return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Value is not a {_enumType.Name}"));
+                    return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Value is not a {_enumType.Name}."));
             }
             else
             {
                 if (_enumsByName.TryGetValue(input.ToLower(), out enumValue))
                     return Task.FromResult(TypeReaderResult.FromSuccess(enumValue));
                 else
-                    return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Value is not a {_enumType.Name}"));
+                    return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Value is not a {_enumType.Name}."));
             }
         }
     }
diff --git a/src/Discord.Net.Commands/Readers/MessageTypeReader.cs b/src/Discord.Net.Commands/Readers/MessageTypeReader.cs
index a87cfbe43..acec2f12d 100644
--- a/src/Discord.Net.Commands/Readers/MessageTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/MessageTypeReader.cs
@@ -4,15 +4,18 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     A <see cref="TypeReader"/> for parsing objects implementing <see cref="IMessage"/>.
+    /// </summary>
+    /// <typeparam name="T">The type to be checked; must implement <see cref="IMessage"/>.</typeparam>
     public class MessageTypeReader<T> : TypeReader
         where T : class, IMessage
     {
+        /// <inheritdoc />
         public override async Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
-            ulong id;
-
             //By Id (1.0)
-            if (ulong.TryParse(input, NumberStyles.None, CultureInfo.InvariantCulture, out id))
+            if (ulong.TryParse(input, NumberStyles.None, CultureInfo.InvariantCulture, out ulong id))
             {
                 if (await context.Channel.GetMessageAsync(id, CacheMode.CacheOnly).ConfigureAwait(false) is T msg)
                     return TypeReaderResult.FromSuccess(msg);
diff --git a/src/Discord.Net.Commands/Readers/NullableTypeReader.cs b/src/Discord.Net.Commands/Readers/NullableTypeReader.cs
index 109689e15..f68bf6e2c 100644
--- a/src/Discord.Net.Commands/Readers/NullableTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/NullableTypeReader.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Linq;
 using System.Reflection;
 using System.Threading.Tasks;
@@ -24,11 +24,12 @@ namespace Discord.Commands
             _baseTypeReader = baseTypeReader;
         }
 
+        /// <inheritdoc />
         public override async Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
             if (string.Equals(input, "null", StringComparison.OrdinalIgnoreCase) || string.Equals(input, "nothing", StringComparison.OrdinalIgnoreCase))
                 return TypeReaderResult.FromSuccess(new T?());
-            return await _baseTypeReader.ReadAsync(context, input, services);
+            return await _baseTypeReader.ReadAsync(context, input, services).ConfigureAwait(false);
         }
     }
 }
diff --git a/src/Discord.Net.Commands/Readers/PrimitiveTypeReader.cs b/src/Discord.Net.Commands/Readers/PrimitiveTypeReader.cs
index b19a6bd69..cb74139df 100644
--- a/src/Discord.Net.Commands/Readers/PrimitiveTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/PrimitiveTypeReader.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord.Commands
@@ -17,14 +17,16 @@ namespace Discord.Commands
         private readonly TryParseDelegate<T> _tryParse;
         private readonly float _score;
 
+        /// <exception cref="ArgumentOutOfRangeException"><typeparamref name="T"/> must be within the range [0, 1].</exception>
         public PrimitiveTypeReader()
             : this(PrimitiveParsers.Get<T>(), 1)
         { }
 
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="score"/> must be within the range [0, 1].</exception>
         public PrimitiveTypeReader(TryParseDelegate<T> tryParse, float score)
         {
             if (score < 0 || score > 1)
-                throw new ArgumentOutOfRangeException(nameof(score), score, "Scores must be within the range [0, 1]");
+                throw new ArgumentOutOfRangeException(nameof(score), score, "Scores must be within the range [0, 1].");
 
             _tryParse = tryParse;
             _score = score;
@@ -34,7 +36,7 @@ namespace Discord.Commands
         {
             if (_tryParse(input, out T value))
                 return Task.FromResult(TypeReaderResult.FromSuccess(new TypeReaderValue(value, _score)));
-            return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Failed to parse {typeof(T).Name}"));
+            return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, $"Failed to parse {typeof(T).Name}."));
         }
     }
 }
diff --git a/src/Discord.Net.Commands/Readers/RoleTypeReader.cs b/src/Discord.Net.Commands/Readers/RoleTypeReader.cs
index 508624103..4c9aaf4d8 100644
--- a/src/Discord.Net.Commands/Readers/RoleTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/RoleTypeReader.cs
@@ -6,20 +6,23 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     A <see cref="TypeReader"/> for parsing objects implementing <see cref="IRole"/>.
+    /// </summary>
+    /// <typeparam name="T">The type to be checked; must implement <see cref="IRole"/>.</typeparam>
     public class RoleTypeReader<T> : TypeReader
         where T : class, IRole
     {
+        /// <inheritdoc />
         public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
-            ulong id;
-
             if (context.Guild != null)
             {
                 var results = new Dictionary<ulong, TypeReaderValue>();
                 var roles = context.Guild.Roles;
 
                 //By Mention (1.0)
-                if (MentionUtils.TryParseRole(input, out id))
+                if (MentionUtils.TryParseRole(input, out var id))
                     AddResult(results, context.Guild.GetRole(id) as T, 1.00f);
 
                 //By Id (0.9)
diff --git a/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs b/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
index 314fbb322..b4a27cb5b 100644
--- a/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/TimeSpanTypeReader.cs
@@ -24,6 +24,7 @@ namespace Discord.Commands
             "%s's'",                //      1s
         };
 
+        /// <inheritdoc />
         public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
             return (TimeSpan.TryParseExact(input.ToLowerInvariant(), Formats, CultureInfo.InvariantCulture, out var timeSpan))
diff --git a/src/Discord.Net.Commands/Readers/TypeReader.cs b/src/Discord.Net.Commands/Readers/TypeReader.cs
index af45a0aac..af780993d 100644
--- a/src/Discord.Net.Commands/Readers/TypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/TypeReader.cs
@@ -1,10 +1,22 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Defines a reader class that parses user input into a specified type.
+    /// </summary>
     public abstract class TypeReader
     {
+        /// <summary>
+        ///     Attempts to parse the <paramref name="input"/> into the desired type.
+        /// </summary>
+        /// <param name="context">The context of the command.</param>
+        /// <param name="input">The raw input of the command.</param>
+        /// <param name="services">The service collection used for dependency injection.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous parsing operation. The task result contains the parsing result.
+        /// </returns>
         public abstract Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services);
     }
 }
diff --git a/src/Discord.Net.Commands/Readers/UserTypeReader.cs b/src/Discord.Net.Commands/Readers/UserTypeReader.cs
index 498a214e4..6d9f1dd8c 100644
--- a/src/Discord.Net.Commands/Readers/UserTypeReader.cs
+++ b/src/Discord.Net.Commands/Readers/UserTypeReader.cs
@@ -7,21 +7,25 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     A <see cref="TypeReader"/> for parsing objects implementing <see cref="IUser"/>.
+    /// </summary>
+    /// <typeparam name="T">The type to be checked; must implement <see cref="IUser"/>.</typeparam>
     public class UserTypeReader<T> : TypeReader
         where T : class, IUser
     {
+        /// <inheritdoc />
         public override async Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
         {
             var results = new Dictionary<ulong, TypeReaderValue>();
             IAsyncEnumerable<IUser> channelUsers = context.Channel.GetUsersAsync(CacheMode.CacheOnly).Flatten(); // it's better
             IReadOnlyCollection<IGuildUser> guildUsers = ImmutableArray.Create<IGuildUser>();
-            ulong id;
 
             if (context.Guild != null)
                 guildUsers = await context.Guild.GetUsersAsync(CacheMode.CacheOnly).ConfigureAwait(false);
 
             //By Mention (1.0)
-            if (MentionUtils.TryParseUser(input, out id))
+            if (MentionUtils.TryParseUser(input, out var id))
             {
                 if (context.Guild != null)
                     AddResult(results, await context.Guild.GetUserAsync(id, CacheMode.CacheOnly).ConfigureAwait(false) as T, 1.00f);
@@ -46,7 +50,7 @@ namespace Discord.Commands
                 if (ushort.TryParse(input.Substring(index + 1), out ushort discriminator))
                 {
                     var channelUser = await channelUsers.FirstOrDefault(x => x.DiscriminatorValue == discriminator &&
-                        string.Equals(username, x.Username, StringComparison.OrdinalIgnoreCase));
+                        string.Equals(username, x.Username, StringComparison.OrdinalIgnoreCase)).ConfigureAwait(false);
                     AddResult(results, channelUser as T, channelUser?.Username == username ? 0.85f : 0.75f);
 
                     var guildUser = guildUsers.FirstOrDefault(x => x.DiscriminatorValue == discriminator &&
@@ -59,7 +63,8 @@ namespace Discord.Commands
             {
                 await channelUsers
                     .Where(x => string.Equals(input, x.Username, StringComparison.OrdinalIgnoreCase))
-                    .ForEachAsync(channelUser => AddResult(results, channelUser as T, channelUser.Username == input ? 0.65f : 0.55f));
+                    .ForEachAsync(channelUser => AddResult(results, channelUser as T, channelUser.Username == input ? 0.65f : 0.55f))
+                    .ConfigureAwait(false);
                 
                 foreach (var guildUser in guildUsers.Where(x => string.Equals(input, x.Username, StringComparison.OrdinalIgnoreCase)))
                     AddResult(results, guildUser as T, guildUser.Username == input ? 0.60f : 0.50f);
@@ -69,7 +74,8 @@ namespace Discord.Commands
             {
                 await channelUsers
                     .Where(x => string.Equals(input, (x as IGuildUser)?.Nickname, StringComparison.OrdinalIgnoreCase))
-                    .ForEachAsync(channelUser => AddResult(results, channelUser as T, (channelUser as IGuildUser).Nickname == input ? 0.65f : 0.55f));
+                    .ForEachAsync(channelUser => AddResult(results, channelUser as T, (channelUser as IGuildUser).Nickname == input ? 0.65f : 0.55f))
+                    .ConfigureAwait(false);
 
                 foreach (var guildUser in guildUsers.Where(x => string.Equals(input, x.Nickname, StringComparison.OrdinalIgnoreCase)))
                     AddResult(results, guildUser as T, guildUser.Nickname == input ? 0.60f : 0.50f);
diff --git a/src/Discord.Net.Commands/Results/ExecuteResult.cs b/src/Discord.Net.Commands/Results/ExecuteResult.cs
index bad39e230..055999596 100644
--- a/src/Discord.Net.Commands/Results/ExecuteResult.cs
+++ b/src/Discord.Net.Commands/Results/ExecuteResult.cs
@@ -1,16 +1,25 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Contains information of the command's overall execution result.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct ExecuteResult : IResult
     {
+        /// <summary>
+        ///     Gets the exception that may have occurred during the command execution.
+        /// </summary>
         public Exception Exception { get; }
 
+        /// <inheritdoc />
         public CommandError? Error { get; }
+        /// <inheritdoc />
         public string ErrorReason { get; }
 
+        /// <inheritdoc />
         public bool IsSuccess => !Error.HasValue;
 
         private ExecuteResult(Exception exception, CommandError? error, string errorReason)
@@ -20,15 +29,56 @@ namespace Discord.Commands
             ErrorReason = errorReason;
         }
 
+        /// <summary>
+        ///     Initializes a new <see cref="ExecuteResult" /> with no error, indicating a successful execution.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ExecuteResult" /> that does not contain any errors.
+        /// </returns>
         public static ExecuteResult FromSuccess()
             => new ExecuteResult(null, null, null);
+        /// <summary>
+        ///     Initializes a new <see cref="ExecuteResult" /> with a specified <see cref="CommandError" /> and its
+        ///     reason, indicating an unsuccessful execution.
+        /// </summary>
+        /// <param name="error">The type of error.</param>
+        /// <param name="reason">The reason behind the error.</param>
+        /// <returns>
+        ///     A <see cref="ExecuteResult" /> that contains a <see cref="CommandError" /> and reason.
+        /// </returns>
         public static ExecuteResult FromError(CommandError error, string reason)
             => new ExecuteResult(null, error, reason);
+        /// <summary>
+        ///     Initializes a new <see cref="ExecuteResult" /> with a specified exception, indicating an unsuccessful
+        ///     execution.
+        /// </summary>
+        /// <param name="ex">The exception that caused the command execution to fail.</param>
+        /// <returns>
+        ///     A <see cref="ExecuteResult" /> that contains the exception that caused the unsuccessful execution, along
+        ///     with a <see cref="CommandError" /> of type <c>Exception</c> as well as the exception message as the
+        ///     reason.
+        /// </returns>
         public static ExecuteResult FromError(Exception ex)
             => new ExecuteResult(ex, CommandError.Exception, ex.Message);
+        /// <summary>
+        ///     Initializes a new <see cref="ExecuteResult" /> with a specified result; this may or may not be an
+        ///     successful execution depending on the <see cref="Discord.Commands.IResult.Error" /> and
+        ///     <see cref="Discord.Commands.IResult.ErrorReason" /> specified.
+        /// </summary>
+        /// <param name="result">The result to inherit from.</param>
+        /// <returns>
+        ///     A <see cref="ExecuteResult"/> that inherits the <see cref="IResult"/> error type and reason.
+        /// </returns>
         public static ExecuteResult FromError(IResult result)
             => new ExecuteResult(null, result.Error, result.ErrorReason);
-        
+
+        /// <summary>
+        ///     Gets a string that indicates the execution result.
+        /// </summary>
+        /// <returns>
+        ///     <c>Success</c> if <see cref="IsSuccess"/> is <c>true</c>; otherwise "<see cref="Error"/>: 
+        ///     <see cref="ErrorReason"/>".
+        /// </returns>
         public override string ToString() => IsSuccess ? "Success" : $"{Error}: {ErrorReason}";
         private string DebuggerDisplay => IsSuccess ? "Success" : $"{Error}: {ErrorReason}";
     }
diff --git a/src/Discord.Net.Commands/Results/IResult.cs b/src/Discord.Net.Commands/Results/IResult.cs
index 928d1139e..c11b58001 100644
--- a/src/Discord.Net.Commands/Results/IResult.cs
+++ b/src/Discord.Net.Commands/Results/IResult.cs
@@ -1,9 +1,31 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary>
+    ///     Contains information of the result related to a command.
+    /// </summary>
     public interface IResult
     {
+        /// <summary>
+        ///     Describes the error type that may have occurred during the operation.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="CommandError" /> indicating the type of error that may have occurred during the operation; 
+        ///     <c>null</c> if the operation was successful.
+        /// </returns>
         CommandError? Error { get; }
+        /// <summary>
+        ///     Describes the reason for the error.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the error reason.
+        /// </returns>
         string ErrorReason { get; }
+        /// <summary>
+        ///     Indicates whether the operation was successful or not.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the result is positive; otherwise <c>false</c>.
+        /// </returns>
         bool IsSuccess { get; }
     }
 }
diff --git a/src/Discord.Net.Commands/Results/ParseResult.cs b/src/Discord.Net.Commands/Results/ParseResult.cs
index 3a0692b2d..8e10dc66c 100644
--- a/src/Discord.Net.Commands/Results/ParseResult.cs
+++ b/src/Discord.Net.Commands/Results/ParseResult.cs
@@ -4,15 +4,21 @@ using System.Diagnostics;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Contains information for the parsing result from the command service's parser.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct ParseResult : IResult
     {
         public IReadOnlyList<TypeReaderResult> ArgValues { get; }
         public IReadOnlyList<TypeReaderResult> ParamValues { get; }
 
+        /// <inheritdoc/>
         public CommandError? Error { get; }
+        /// <inheritdoc/>
         public string ErrorReason { get; }
 
+        /// <inheritdoc/>
         public bool IsSuccess => !Error.HasValue;
 
         private ParseResult(IReadOnlyList<TypeReaderResult> argValues, IReadOnlyList<TypeReaderResult> paramValues, CommandError? error, string errorReason)
@@ -22,7 +28,7 @@ namespace Discord.Commands
             Error = error;
             ErrorReason = errorReason;
         }
-
+        
         public static ParseResult FromSuccess(IReadOnlyList<TypeReaderResult> argValues, IReadOnlyList<TypeReaderResult> paramValues)
         {
             for (int i = 0; i < argValues.Count; i++)
diff --git a/src/Discord.Net.Commands/Results/PreconditionGroupResult.cs b/src/Discord.Net.Commands/Results/PreconditionGroupResult.cs
index ee650600a..7ecade4f8 100644
--- a/src/Discord.Net.Commands/Results/PreconditionGroupResult.cs
+++ b/src/Discord.Net.Commands/Results/PreconditionGroupResult.cs
@@ -15,7 +15,7 @@ namespace Discord.Commands
             PreconditionResults = (preconditions ?? new List<PreconditionResult>(0)).ToReadOnlyCollection();
         }
 
-        public static new PreconditionGroupResult FromSuccess()
+        public new static PreconditionGroupResult FromSuccess()
             => new PreconditionGroupResult(null, null, null);
         public static PreconditionGroupResult FromError(string reason, ICollection<PreconditionResult> preconditions)
             => new PreconditionGroupResult(CommandError.UnmetPrecondition, reason, preconditions);
diff --git a/src/Discord.Net.Commands/Results/PreconditionResult.cs b/src/Discord.Net.Commands/Results/PreconditionResult.cs
index 01fc1a3fd..d8e399a01 100644
--- a/src/Discord.Net.Commands/Results/PreconditionResult.cs
+++ b/src/Discord.Net.Commands/Results/PreconditionResult.cs
@@ -3,29 +3,56 @@ using System.Diagnostics;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Represents a result type for command preconditions.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class PreconditionResult : IResult
     {
+        /// <inheritdoc/>
         public CommandError? Error { get; }
+        /// <inheritdoc/>
         public string ErrorReason { get; }
 
+        /// <inheritdoc/>
         public bool IsSuccess => !Error.HasValue;
 
+        /// <summary>
+        ///     Initializes a new <see cref="PreconditionResult" /> class with the command <paramref name="error"/> type
+        ///     and reason.
+        /// </summary>
+        /// <param name="error">The type of failure.</param>
+        /// <param name="errorReason">The reason of failure.</param>
         protected PreconditionResult(CommandError? error, string errorReason)
         {
             Error = error;
             ErrorReason = errorReason;
         }
 
+        /// <summary>
+        ///     Returns a <see cref="PreconditionResult" /> with no errors.
+        /// </summary>
         public static PreconditionResult FromSuccess()
             => new PreconditionResult(null, null);
+        /// <summary>
+        ///     Returns a <see cref="PreconditionResult" /> with <see cref="CommandError.UnmetPrecondition" /> and the
+        ///     specified reason.
+        /// </summary>
+        /// <param name="reason">The reason of failure.</param>
         public static PreconditionResult FromError(string reason)
             => new PreconditionResult(CommandError.UnmetPrecondition, reason);
         public static PreconditionResult FromError(Exception ex)
             => new PreconditionResult(CommandError.Exception, ex.Message);
+        /// <summary>
+        ///     Returns a <see cref="PreconditionResult" /> with the specified <paramref name="result"/> type.
+        /// </summary>
+        /// <param name="result">The result of failure.</param>
         public static PreconditionResult FromError(IResult result)
             => new PreconditionResult(result.Error, result.ErrorReason);
 
+        /// <summary>
+        /// Returns a string indicating whether the <see cref="PreconditionResult"/> is successful.
+        /// </summary>
         public override string ToString() => IsSuccess ? "Success" : $"{Error}: {ErrorReason}";
         private string DebuggerDisplay => IsSuccess ? "Success" : $"{Error}: {ErrorReason}";
     }
diff --git a/src/Discord.Net.Commands/Results/RuntimeResult.cs b/src/Discord.Net.Commands/Results/RuntimeResult.cs
index 2a326a7a3..e4c86fc23 100644
--- a/src/Discord.Net.Commands/Results/RuntimeResult.cs
+++ b/src/Discord.Net.Commands/Results/RuntimeResult.cs
@@ -1,24 +1,30 @@
-using System;
-using System.Collections.Generic;
 using System.Diagnostics;
-using System.Text;
 
 namespace Discord.Commands
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public abstract class RuntimeResult : IResult
     {
+        /// <summary>
+        ///     Initializes a new <see cref="RuntimeResult" /> class with the type of error and reason.
+        /// </summary>
+        /// <param name="error">The type of failure, or <c>null</c> if none.</param>
+        /// <param name="reason">The reason of failure.</param>
         protected RuntimeResult(CommandError? error, string reason)
         {
             Error = error;
             Reason = reason;
         }
 
+        /// <inheritdoc/>
         public CommandError? Error { get; }
+        /// <summary> Describes the execution reason or result. </summary>
         public string Reason { get; }
 
+        /// <inheritdoc/>
         public bool IsSuccess => !Error.HasValue;
 
+        /// <inheritdoc/>
         string IResult.ErrorReason => Reason;
 
         public override string ToString() => Reason ?? (IsSuccess ? "Successful" : "Unsuccessful");
diff --git a/src/Discord.Net.Commands/Results/SearchResult.cs b/src/Discord.Net.Commands/Results/SearchResult.cs
index 6a5878ea2..d1f1ea0d7 100644
--- a/src/Discord.Net.Commands/Results/SearchResult.cs
+++ b/src/Discord.Net.Commands/Results/SearchResult.cs
@@ -10,9 +10,12 @@ namespace Discord.Commands
         public string Text { get; }
         public IReadOnlyList<CommandMatch> Commands { get; }
 
+        /// <inheritdoc/>
         public CommandError? Error { get; }
+        /// <inheritdoc/>
         public string ErrorReason { get; }
 
+        /// <inheritdoc/>
         public bool IsSuccess => !Error.HasValue;
 
         private SearchResult(string text, IReadOnlyList<CommandMatch> commands, CommandError? error, string errorReason)
diff --git a/src/Discord.Net.Commands/Results/TypeReaderResult.cs b/src/Discord.Net.Commands/Results/TypeReaderResult.cs
index e696dbc17..2fbdb45d6 100644
--- a/src/Discord.Net.Commands/Results/TypeReaderResult.cs
+++ b/src/Discord.Net.Commands/Results/TypeReaderResult.cs
@@ -27,10 +27,15 @@ namespace Discord.Commands
     {
         public IReadOnlyCollection<TypeReaderValue> Values { get; }
 
+        /// <inheritdoc/>
         public CommandError? Error { get; }
+        /// <inheritdoc/>
         public string ErrorReason { get; }
 
+        /// <inheritdoc/>
         public bool IsSuccess => !Error.HasValue;
+
+        /// <exception cref="InvalidOperationException">TypeReaderResult was not successful.</exception>
         public object BestMatch => IsSuccess
             ? (Values.Count == 1 ? Values.Single().Value : Values.OrderByDescending(v => v.Score).First().Value)
             : throw new InvalidOperationException("TypeReaderResult was not successful.");
diff --git a/src/Discord.Net.Commands/RunMode.cs b/src/Discord.Net.Commands/RunMode.cs
index ecb6a4b58..8e230b500 100644
--- a/src/Discord.Net.Commands/RunMode.cs
+++ b/src/Discord.Net.Commands/RunMode.cs
@@ -1,9 +1,23 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary>
+    ///     Specifies the behavior of the command execution workflow.
+    /// </summary>
+    /// <seealso cref="CommandServiceConfig"/>
+    /// <seealso cref="CommandAttribute"/>
     public enum RunMode
     {
+        /// <summary>
+        /// The default behaviour set in <see cref="CommandServiceConfig"/>.
+        /// </summary>
         Default,
+        /// <summary>
+        /// Executes the command on the same thread as gateway one.
+        /// </summary>
         Sync,
+        /// <summary>
+        /// Executes the command on a different thread from the gateway one.
+        /// </summary>
         Async
     }
 }
diff --git a/src/Discord.Net.Commands/Utilities/QuotationAliasUtils.cs b/src/Discord.Net.Commands/Utilities/QuotationAliasUtils.cs
index 15a08b9b3..2612e99e5 100644
--- a/src/Discord.Net.Commands/Utilities/QuotationAliasUtils.cs
+++ b/src/Discord.Net.Commands/Utilities/QuotationAliasUtils.cs
@@ -1,19 +1,18 @@
-using System;
 using System.Collections.Generic;
-using System.Text;
-using System.Globalization;
 
 namespace Discord.Commands
 {
     /// <summary>
-    /// Utility methods for generating matching pairs of unicode quotation marks for CommandServiceConfig
+    /// Utility class which contains the default matching pairs of quotation marks for CommandServiceConfig
     /// </summary>
     internal static class QuotationAliasUtils
     {
         /// <summary>
-        /// Generates an IEnumerable of characters representing open-close pairs of
-        /// quotation punctuation.
+        /// A default map of open-close pairs of quotation marks.
+        /// Contains many regional and Unicode equivalents.
+        /// Used in the <see cref="CommandServiceConfig"/>.
         /// </summary>
+        /// <seealso cref="CommandServiceConfig.QuotationMarkAliasMap"/>
         internal static Dictionary<char, char> GetDefaultAliasMap
         {
             get
diff --git a/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs b/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
index ec981cf52..062af0481 100644
--- a/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
+++ b/src/Discord.Net.Commands/Utilities/ReflectionUtils.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace Discord.Commands
 {
@@ -38,7 +37,7 @@ namespace Discord.Commands
             }
             catch (Exception ex)
             {
-                throw new Exception($"Failed to create \"{ownerType.FullName}\"", ex);
+                throw new Exception($"Failed to create \"{ownerType.FullName}\".", ex);
             }
         }
 
@@ -46,12 +45,12 @@ namespace Discord.Commands
         {
             var constructors = ownerType.DeclaredConstructors.Where(x => !x.IsStatic).ToArray();
             if (constructors.Length == 0)
-                throw new InvalidOperationException($"No constructor found for \"{ownerType.FullName}\"");
+                throw new InvalidOperationException($"No constructor found for \"{ownerType.FullName}\".");
             else if (constructors.Length > 1)
-                throw new InvalidOperationException($"Multiple constructors found for \"{ownerType.FullName}\"");
+                throw new InvalidOperationException($"Multiple constructors found for \"{ownerType.FullName}\".");
             return constructors[0];
         }
-        private static System.Reflection.PropertyInfo[] GetProperties(TypeInfo ownerType)
+        private static PropertyInfo[] GetProperties(TypeInfo ownerType)
         {
             var result = new List<System.Reflection.PropertyInfo>();
             while (ownerType != ObjectTypeInfo)
@@ -71,7 +70,7 @@ namespace Discord.Commands
                 return commands;
             if (memberType == typeof(IServiceProvider) || memberType == services.GetType())
                 return services;
-            var service = services?.GetService(memberType);
+            var service = services.GetService(memberType);
             if (service != null)
                 return service;
             throw new InvalidOperationException($"Failed to create \"{ownerType.FullName}\", dependency \"{memberType.Name}\" was not found.");
diff --git a/src/Discord.Net.Core/Audio/AudioOutStream.cs b/src/Discord.Net.Core/Audio/AudioOutStream.cs
index 7019ba8cd..cbc3167a2 100644
--- a/src/Discord.Net.Core/Audio/AudioOutStream.cs
+++ b/src/Discord.Net.Core/Audio/AudioOutStream.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 
 namespace Discord.Audio
@@ -7,8 +7,17 @@ namespace Discord.Audio
     {
         public override bool CanWrite => true;
 
-        public override int Read(byte[] buffer, int offset, int count) { throw new NotSupportedException(); }
-        public override void SetLength(long value) { throw new NotSupportedException(); }
-        public override long Seek(long offset, SeekOrigin origin) { throw new NotSupportedException(); }
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Reading this stream is not supported.</exception>
+        public override int Read(byte[] buffer, int offset, int count) =>
+            throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Setting the length to this stream is not supported.</exception>
+        public override void SetLength(long value) =>
+            throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Seeking this stream is not supported..</exception>
+        public override long Seek(long offset, SeekOrigin origin) =>
+            throw new NotSupportedException();
     }
 }
diff --git a/src/Discord.Net.Core/Audio/AudioStream.cs b/src/Discord.Net.Core/Audio/AudioStream.cs
index 97820ea73..2287d47fa 100644
--- a/src/Discord.Net.Core/Audio/AudioStream.cs
+++ b/src/Discord.Net.Core/Audio/AudioStream.cs
@@ -11,10 +11,9 @@ namespace Discord.Audio
         public override bool CanSeek => false;
         public override bool CanWrite => false;
 
-        public virtual void WriteHeader(ushort seq, uint timestamp, bool missed) 
-        { 
-            throw new InvalidOperationException("This stream does not accept headers");
-        }
+        /// <exception cref="InvalidOperationException">This stream does not accept headers.</exception>
+        public virtual void WriteHeader(ushort seq, uint timestamp, bool missed) => 
+            throw new InvalidOperationException("This stream does not accept headers.");
         public override void Write(byte[] buffer, int offset, int count)
         {
             WriteAsync(buffer, offset, count, CancellationToken.None).GetAwaiter().GetResult();
@@ -30,15 +29,30 @@ namespace Discord.Audio
 
         public virtual Task ClearAsync(CancellationToken cancellationToken) { return Task.Delay(0); }
 
-        public override long Length { get { throw new NotSupportedException(); } }
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Reading stream length is not supported.</exception>
+        public override long Length => 
+            throw new NotSupportedException();
+
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Getting or setting this stream position is not supported.</exception>
         public override long Position
         {
-            get { throw new NotSupportedException(); }
-            set { throw new NotSupportedException(); }
+            get => throw new NotSupportedException();
+            set => throw new NotSupportedException();
         }
 
-        public override int Read(byte[] buffer, int offset, int count) { throw new NotSupportedException(); }
-        public override void SetLength(long value) { throw new NotSupportedException(); }
-        public override long Seek(long offset, SeekOrigin origin) { throw new NotSupportedException(); }
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Reading this stream is not supported.</exception>
+        public override int Read(byte[] buffer, int offset, int count) =>
+            throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Setting the length to this stream is not supported.</exception>
+        public override void SetLength(long value) =>
+            throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Seeking this stream is not supported..</exception>
+        public override long Seek(long offset, SeekOrigin origin) =>
+            throw new NotSupportedException();
     }
 }
diff --git a/src/Discord.Net.Core/Audio/IAudioClient.cs b/src/Discord.Net.Core/Audio/IAudioClient.cs
index 9be8ceef5..018c8bc05 100644
--- a/src/Discord.Net.Core/Audio/IAudioClient.cs
+++ b/src/Discord.Net.Core/Audio/IAudioClient.cs
@@ -15,7 +15,7 @@ namespace Discord.Audio
 
         /// <summary> Gets the current connection state of this client. </summary>
         ConnectionState ConnectionState { get; }
-        /// <summary> Gets the estimated round-trip latency, in milliseconds, to the voice websocket server. </summary>
+        /// <summary> Gets the estimated round-trip latency, in milliseconds, to the voice WebSocket server. </summary>
         int Latency { get; }
         /// <summary> Gets the estimated round-trip latency, in milliseconds, to the voice UDP server. </summary>
         int UdpLatency { get; }
diff --git a/src/Discord.Net.Core/CDN.cs b/src/Discord.Net.Core/CDN.cs
index 6bac241aa..0fefc9a0d 100644
--- a/src/Discord.Net.Core/CDN.cs
+++ b/src/Discord.Net.Core/CDN.cs
@@ -2,10 +2,32 @@ using System;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a class containing the strings related to various Content Delivery Networks (CDNs).
+    /// </summary>
     public static class CDN
     {
+        /// <summary>
+        ///     Returns an application icon URL.
+        /// </summary>
+        /// <param name="appId">The application identifier.</param>
+        /// <param name="iconId">The icon identifier.</param>
+        /// <returns>
+        ///     A URL pointing to the application's icon.
+        /// </returns>
         public static string GetApplicationIconUrl(ulong appId, string iconId)
             => iconId != null ? $"{DiscordConfig.CDNUrl}app-icons/{appId}/{iconId}.jpg" : null;
+
+        /// <summary>
+        ///     Returns a user avatar URL.
+        /// </summary>
+        /// <param name="userId">The user snowflake identifier.</param>
+        /// <param name="avatarId">The avatar identifier.</param>
+        /// <param name="size">The size of the image to return in. This can be any power of two between 16 and 2048.</param>
+        /// <param name="format">The format to return.</param>
+        /// <returns>
+        ///     A URL pointing to the user's avatar in the specified size.
+        /// </returns>
         public static string GetUserAvatarUrl(ulong userId, string avatarId, ushort size, ImageFormat format)
         {
             if (avatarId == null)
@@ -13,27 +35,90 @@ namespace Discord
             string extension = FormatToExtension(format, avatarId);
             return $"{DiscordConfig.CDNUrl}avatars/{userId}/{avatarId}.{extension}?size={size}";
         }
+        /// <summary>
+        ///     Returns the default user avatar URL.
+        /// </summary>
+        /// <param name="discriminator">The discriminator value of a user.</param>
+        /// <returns>
+        ///     A URL pointing to the user's default avatar when one isn't set.
+        /// </returns>
         public static string GetDefaultUserAvatarUrl(ushort discriminator)
         {
             return $"{DiscordConfig.CDNUrl}embed/avatars/{discriminator % 5}.png";
         }
+        /// <summary>
+        ///     Returns an icon URL.
+        /// </summary>
+        /// <param name="guildId">The guild snowflake identifier.</param>
+        /// <param name="iconId">The icon identifier.</param>
+        /// <returns>
+        ///     A URL pointing to the guild's icon.
+        /// </returns>
         public static string GetGuildIconUrl(ulong guildId, string iconId)
             => iconId != null ? $"{DiscordConfig.CDNUrl}icons/{guildId}/{iconId}.jpg" : null;
+        /// <summary>
+        ///     Returns a guild splash URL.
+        /// </summary>
+        /// <param name="guildId">The guild snowflake identifier.</param>
+        /// <param name="splashId">The splash icon identifier.</param>
+        /// <returns>
+        ///     A URL pointing to the guild's icon.
+        /// </returns>
         public static string GetGuildSplashUrl(ulong guildId, string splashId)
             => splashId != null ? $"{DiscordConfig.CDNUrl}splashes/{guildId}/{splashId}.jpg" : null;
+        /// <summary>
+        ///     Returns a channel icon URL.
+        /// </summary>
+        /// <param name="channelId">The channel snowflake identifier.</param>
+        /// <param name="iconId">The icon identifier.</param>
+        /// <returns>
+        ///     A URL pointing to the channel's icon.
+        /// </returns>
         public static string GetChannelIconUrl(ulong channelId, string iconId)
             => iconId != null ? $"{DiscordConfig.CDNUrl}channel-icons/{channelId}/{iconId}.jpg" : null;
+        /// <summary>
+        ///     Returns an emoji URL.
+        /// </summary>
+        /// <param name="emojiId">The emoji snowflake identifier.</param>
+        /// <param name="animated">Whether this emoji is animated.</param>
+        /// <returns>
+        ///     A URL pointing to the custom emote.
+        /// </returns>
         public static string GetEmojiUrl(ulong emojiId, bool animated)
             => $"{DiscordConfig.CDNUrl}emojis/{emojiId}.{(animated ? "gif" : "png")}";
 
+        /// <summary>
+        ///     Returns a Rich Presence asset URL.
+        /// </summary>
+        /// <param name="appId">The application identifier.</param>
+        /// <param name="assetId">The asset identifier.</param>
+        /// <param name="size">The size of the image to return in. This can be any power of two between 16 and 2048.</param>
+        /// <param name="format">The format to return.</param>
+        /// <returns>
+        ///     A URL pointing to the asset image in the specified size.
+        /// </returns>
         public static string GetRichAssetUrl(ulong appId, string assetId, ushort size, ImageFormat format)
         {
             string extension = FormatToExtension(format, "");
             return $"{DiscordConfig.CDNUrl}app-assets/{appId}/{assetId}.{extension}?size={size}";
         }
 
+        /// <summary>
+        ///     Returns a Spotify album URL.
+        /// </summary>
+        /// <param name="albumArtId">The identifier for the album art (e.g. 6be8f4c8614ecf4f1dd3ebba8d8692d8ce4951ac).</param>
+        /// <returns>
+        ///     A URL pointing to the Spotify album art.
+        /// </returns>
         public static string GetSpotifyAlbumArtUrl(string albumArtId)
             => $"https://i.scdn.co/image/{albumArtId}";
+        /// <summary>
+        ///     Returns a Spotify direct URL for a track.
+        /// </summary>
+        /// <param name="trackId">The identifier for the track (e.g. 4uLU6hMCjMI75M1A2tKUQC).</param>
+        /// <returns>
+        ///     A URL pointing to the Spotify track.
+        /// </returns>
         public static string GetSpotifyDirectUrl(string trackId)
             => $"https://open.spotify.com/track/{trackId}";
 
diff --git a/src/Discord.Net.Core/Commands/ICommandContext.cs b/src/Discord.Net.Core/Commands/ICommandContext.cs
index ac1424339..d56eb38a0 100644
--- a/src/Discord.Net.Core/Commands/ICommandContext.cs
+++ b/src/Discord.Net.Core/Commands/ICommandContext.cs
@@ -1,11 +1,29 @@
-namespace Discord.Commands
+namespace Discord.Commands
 {
+    /// <summary>
+    ///     Represents a context of a command. This may include the client, guild, channel, user, and message.
+    /// </summary>
     public interface ICommandContext
     {
+        /// <summary>
+        ///     Gets the <see cref="IDiscordClient" /> that the command is executed with.
+        /// </summary>
         IDiscordClient Client { get; }
+        /// <summary>
+        ///     Gets the <see cref="IGuild" /> that the command is executed in.
+        /// </summary>
         IGuild Guild { get; }
+        /// <summary>
+        ///     Gets the <see cref="IMessageChannel" /> that the command is executed in.
+        /// </summary>
         IMessageChannel Channel { get; }
+        /// <summary>
+        ///     Gets the <see cref="IUser" /> who executed the command.
+        /// </summary>
         IUser User { get; }
+        /// <summary>
+        ///     Gets the <see cref="IUserMessage" /> that the command is interpreted from.
+        /// </summary>
         IUserMessage Message { get; }
     }
 }
diff --git a/src/Discord.Net.Core/ConnectionState.cs b/src/Discord.Net.Core/ConnectionState.cs
index 42c505ccd..fadbc4065 100644
--- a/src/Discord.Net.Core/ConnectionState.cs
+++ b/src/Discord.Net.Core/ConnectionState.cs
@@ -1,10 +1,15 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Specifies the connection state of a client. </summary>
     public enum ConnectionState : byte
     {
+        /// <summary> The client has disconnected from Discord. </summary>
         Disconnected,
+        /// <summary> The client is connecting to Discord. </summary>
         Connecting,
+        /// <summary> The client has established a connection to Discord. </summary>
         Connected,
+        /// <summary> The client is disconnecting from Discord. </summary>
         Disconnecting
     }
 }
diff --git a/src/Discord.Net.Core/DiscordConfig.cs b/src/Discord.Net.Core/DiscordConfig.cs
index 8c6cfc28c..d0c1c3a84 100644
--- a/src/Discord.Net.Core/DiscordConfig.cs
+++ b/src/Discord.Net.Core/DiscordConfig.cs
@@ -2,35 +2,143 @@ using System.Reflection;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Defines various behaviors of Discord.Net.
+    /// </summary>
     public class DiscordConfig
     {
+        /// <summary> 
+        ///     Returns the API version Discord.Net uses. 
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the API version that Discord.Net uses to communicate with Discord.
+        ///     <para>A list of available API version can be seen on the official 
+        ///     <see href="https://discordapp.com/developers/docs/reference#api-versioning">Discord API documentation</see>
+        ///     .</para>
+        /// </returns>
         public const int APIVersion = 6;
+        /// <summary>
+        /// Returns the Voice API version Discord.Net uses.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the API version that Discord.Net uses to communicate with Discord's
+        ///     voice server.
+        /// </returns>
         public const int VoiceAPIVersion = 3;
+        /// <summary>
+        ///     Gets the Discord.Net version, including the build number.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the detailed version information, including its build number; <c>Unknown</c> when
+        ///     the version fails to be fetched.
+        /// </returns>
         public static string Version { get; } =
             typeof(DiscordConfig).GetTypeInfo().Assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion ??
             typeof(DiscordConfig).GetTypeInfo().Assembly.GetName().Version.ToString(3) ??
             "Unknown";
-
+        
+        /// <summary>
+        ///     Gets the user agent that Discord.Net uses in its clients.
+        /// </summary>
+        /// <returns>
+        ///     The user agent used in each Discord.Net request.
+        /// </returns>
         public static string UserAgent { get; } = $"DiscordBot (https://github.com/RogueException/Discord.Net, v{Version})";
+        /// <summary>
+        ///     Returns the base Discord API URL.
+        /// </summary>
+        /// <returns>
+        ///     The Discord API URL using <see cref="APIVersion"/>.
+        /// </returns>
         public static readonly string APIUrl = $"https://discordapp.com/api/v{APIVersion}/";
+        /// <summary> 
+        ///     Returns the base Discord CDN URL. 
+        /// </summary>
+        /// <returns>
+        ///     The base Discord Content Delivery Network (CDN) URL.
+        /// </returns>
         public const string CDNUrl = "https://cdn.discordapp.com/";
+        /// <summary> 
+        ///     Returns the base Discord invite URL.
+        /// </summary>
+        /// <returns>
+        ///     The base Discord invite URL.
+        /// </returns>
         public const string InviteUrl = "https://discord.gg/";
 
+        /// <summary> 
+        ///     Returns the default timeout for requests. 
+        /// </summary>
+        /// <returns>
+        ///     The amount of time it takes in milliseconds before a request is timed out.
+        /// </returns>
         public const int DefaultRequestTimeout = 15000;
+        /// <summary> 
+        ///     Returns the max length for a Discord message. 
+        /// </summary>
+        /// <returns>
+        ///     The maximum length of a message allowed by Discord.
+        /// </returns>
         public const int MaxMessageSize = 2000;
+        /// <summary> 
+        ///     Returns the max messages allowed to be in a request. 
+        /// </summary>
+        /// <returns>
+        ///     The maximum number of messages that can be gotten per-batch.
+        /// </returns>
         public const int MaxMessagesPerBatch = 100;
+        /// <summary> 
+        ///     Returns the max users allowed to be in a request.
+        /// </summary>
+        /// <returns>
+        ///     The maximum number of users that can be gotten per-batch.
+        /// </returns>
         public const int MaxUsersPerBatch = 1000;
+        /// <summary> 
+        ///     Returns the max guilds allowed to be in a request. 
+        /// </summary>
+        /// <returns>
+        ///     The maximum number of guilds that can be gotten per-batch.
+        /// </returns>
         public const int MaxGuildsPerBatch = 100;
+        /// <summary>
+        ///     Returns the max user reactions allowed to be in a request.
+        /// </summary>
+        /// <returns>
+        ///     The maximum number of user reactions that can be gotten per-batch.
+        /// </returns>
         public const int MaxUserReactionsPerBatch = 100;
+        /// <summary> 
+        ///     Returns the max audit log entries allowed to be in a request. 
+        /// </summary>
+        /// <returns>
+        ///     The maximum number of audit log entries that can be gotten per-batch.
+        /// </returns>
         public const int MaxAuditLogEntriesPerBatch = 100;
 
-        /// <summary> Gets or sets how a request should act in the case of an error, by default. </summary>
+        /// <summary>
+        ///     Gets or sets how a request should act in the case of an error, by default.
+        /// </summary>
+        /// <returns>
+        ///     The currently set <see cref="RetryMode"/>.
+        /// </returns>
         public RetryMode DefaultRetryMode { get; set; } = RetryMode.AlwaysRetry;
-
-        /// <summary> Gets or sets the minimum log level severity that will be sent to the Log event. </summary>
+        
+        /// <summary>
+        ///     Gets or sets the minimum log level severity that will be sent to the Log event.
+        /// </summary>
+        /// <returns>
+        ///     The currently set <see cref="LogSeverity"/> for logging level.
+        /// </returns>
         public LogSeverity LogLevel { get; set; } = LogSeverity.Info;
 
-        /// <summary> Gets or sets whether the initial log entry should be printed. </summary>
+        /// <summary>
+        ///     Gets or sets whether the initial log entry should be printed.
+        /// </summary>
+        /// <remarks>
+        ///     If set to <c>true</c>, the library will attempt to print the current version of the library, as well as
+        ///     the API version it uses on startup.
+        /// </remarks>
         internal bool DisplayInitialLog { get; set; } = true;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Activities/ActivityType.cs b/src/Discord.Net.Core/Entities/Activities/ActivityType.cs
index c7db7b247..67235c499 100644
--- a/src/Discord.Net.Core/Entities/Activities/ActivityType.cs
+++ b/src/Discord.Net.Core/Entities/Activities/ActivityType.cs
@@ -1,10 +1,25 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies a Discord user's activity type.
+    /// </summary>
     public enum ActivityType
     {
+        /// <summary>
+        ///     The user is playing a game.
+        /// </summary>
         Playing = 0,
+        /// <summary>
+        ///     The user is streaming online.
+        /// </summary>
         Streaming = 1,
+        /// <summary>
+        ///     The user is listening to a song.
+        /// </summary>
         Listening = 2,
+        /// <summary>
+        ///     The user is watching a media.
+        /// </summary>
         Watching = 3
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Activities/Game.cs b/src/Discord.Net.Core/Entities/Activities/Game.cs
index 179ad4eaa..5be99cacb 100644
--- a/src/Discord.Net.Core/Entities/Activities/Game.cs
+++ b/src/Discord.Net.Core/Entities/Activities/Game.cs
@@ -2,19 +2,30 @@ using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A user's game status.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class Game : IActivity
     {
+        /// <inheritdoc/>
         public string Name { get; internal set; }
+        /// <inheritdoc/>
         public ActivityType Type { get; internal set; }
 
         internal Game() { }
+        /// <summary>
+        ///     Creates a <see cref="Game"/> with the provided <paramref name="name"/> and <see cref="ActivityType"/>.
+        /// </summary>
+        /// <param name="name">The name of the game.</param>
+        /// <param name="type">The type of activity. Default is <see cref="Discord.ActivityType.Playing"/>.</param>
         public Game(string name, ActivityType type = ActivityType.Playing)
         {
             Name = name;
             Type = type;
         }
         
+        /// <summary> Returns the name of the <see cref="Game"/>. </summary>
         public override string ToString() => Name;
         private string DebuggerDisplay => Name;
     }
diff --git a/src/Discord.Net.Core/Entities/Activities/GameAsset.cs b/src/Discord.Net.Core/Entities/Activities/GameAsset.cs
index 02c29ba41..7217bded3 100644
--- a/src/Discord.Net.Core/Entities/Activities/GameAsset.cs
+++ b/src/Discord.Net.Core/Entities/Activities/GameAsset.cs
@@ -1,14 +1,37 @@
 namespace Discord
 {
+    /// <summary>
+    ///     An asset for a <see cref="RichGame" /> object containing the text and image.
+    /// </summary>
     public class GameAsset
     {
         internal GameAsset() { }
 
         internal ulong? ApplicationId { get; set; }
-        
+
+        /// <summary>
+        ///     Gets the description of the asset.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the description of the asset.
+        /// </returns>
         public string Text { get; internal set; }
+        /// <summary>
+        ///     Gets the image ID of the asset.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the unique image identifier of the asset.
+        /// </returns>
         public string ImageId { get; internal set; }
-        
+
+        /// <summary>
+        ///     Returns the image URL of the asset.
+        /// </summary>
+        /// <param name="size">The size of the image to return in. This can be any power of two between 16 and 2048.</param>
+        /// <param name="format">The format to return.</param>
+        /// <returns>
+        ///     A string pointing to the image URL of the asset; <c>null</c> when the application ID does not exist.
+        /// </returns>
         public string GetImageUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128)
             => ApplicationId.HasValue ? CDN.GetRichAssetUrl(ApplicationId.Value, ImageId, size, format) : null;
     }
diff --git a/src/Discord.Net.Core/Entities/Activities/GameParty.cs b/src/Discord.Net.Core/Entities/Activities/GameParty.cs
index 54e6deef4..0cfa9980d 100644
--- a/src/Discord.Net.Core/Entities/Activities/GameParty.cs
+++ b/src/Discord.Net.Core/Entities/Activities/GameParty.cs
@@ -1,11 +1,26 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Party information for a <see cref="RichGame" /> object.
+    /// </summary>
     public class GameParty
     {
         internal GameParty() { }
 
+        /// <summary>
+        ///     Gets the ID of the party.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the unique identifier of the party.
+        /// </returns>
         public string Id { get; internal set; }
         public long Members { get; internal set; }
+        /// <summary>
+        ///     Gets the party's current and maximum size.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="long"/> representing the capacity of the party.
+        /// </returns>
         public long Capacity { get; internal set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Activities/GameSecrets.cs b/src/Discord.Net.Core/Entities/Activities/GameSecrets.cs
index e9d988ba9..595b8851c 100644
--- a/src/Discord.Net.Core/Entities/Activities/GameSecrets.cs
+++ b/src/Discord.Net.Core/Entities/Activities/GameSecrets.cs
@@ -1,9 +1,21 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Party secret for a <see cref="RichGame" /> object.
+    /// </summary>
     public class GameSecrets
     {
+        /// <summary>
+        ///     Gets the secret for a specific instanced match.
+        /// </summary>
         public string Match { get; }
+        /// <summary>
+        ///     Gets the secret for joining a party.
+        /// </summary>
         public string Join { get; }
+        /// <summary>
+        /// 	Gets the secret for spectating a game.
+        /// </summary>
         public string Spectate { get; }
 
         internal GameSecrets(string match, string join, string spectate)
@@ -13,4 +25,4 @@
             Spectate = spectate;
         }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Activities/GameTimestamps.cs b/src/Discord.Net.Core/Entities/Activities/GameTimestamps.cs
index 8c8c992fa..a41388afb 100644
--- a/src/Discord.Net.Core/Entities/Activities/GameTimestamps.cs
+++ b/src/Discord.Net.Core/Entities/Activities/GameTimestamps.cs
@@ -1,10 +1,19 @@
-using System;
+using System;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Timestamps for a <see cref="RichGame" /> object.
+    /// </summary>
     public class GameTimestamps
     {
+        /// <summary>
+        ///     Gets when the activity started.
+        /// </summary>
         public DateTimeOffset? Start { get; }
+        /// <summary>
+        ///     Gets when the activity ends.
+        /// </summary>
         public DateTimeOffset? End { get; }
 
         internal GameTimestamps(DateTimeOffset? start, DateTimeOffset? end)
@@ -13,4 +22,4 @@ namespace Discord
             End = end;
         }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Activities/IActivity.cs b/src/Discord.Net.Core/Entities/Activities/IActivity.cs
index 1f158217d..ac0c1b5d7 100644
--- a/src/Discord.Net.Core/Entities/Activities/IActivity.cs
+++ b/src/Discord.Net.Core/Entities/Activities/IActivity.cs
@@ -1,8 +1,23 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     A user's activity status, typically a <see cref="Game"/>.
+    /// </summary>
     public interface IActivity
     {
+        /// <summary>
+        ///     Gets the name of the activity.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the activity that the user is doing.
+        /// </returns>
         string Name { get; }
+        /// <summary>
+        ///     Gets the type of the activity.
+        /// </summary>
+        /// <returns>
+        ///     The type of activity.
+        /// </returns>
         ActivityType Type { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Activities/RichGame.cs b/src/Discord.Net.Core/Entities/Activities/RichGame.cs
index fc3f68cf0..2455fd557 100644
--- a/src/Discord.Net.Core/Entities/Activities/RichGame.cs
+++ b/src/Discord.Net.Core/Entities/Activities/RichGame.cs
@@ -2,20 +2,50 @@ using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A user's Rich Presence status.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RichGame : Game
     {
         internal RichGame() { }
 
+        /// <summary>
+        ///     Gets what the player is currently doing.
+        /// </summary>
         public string Details { get; internal set; }
+        /// <summary>
+        ///     Gets the user's current party status.
+        /// </summary>
         public string State { get; internal set; }
+        /// <summary>
+        ///     Gets the application ID for the game.
+        /// </summary>
         public ulong ApplicationId { get; internal set; }
+        /// <summary>
+        ///     Gets the small image for the presence and their hover texts.
+        /// </summary>
         public GameAsset SmallAsset { get; internal set; }
+        /// <summary>
+        ///     Gets the large image for the presence and their hover texts.
+        /// </summary>
         public GameAsset LargeAsset { get; internal set; }
+        /// <summary>
+        ///     Gets the information for the current party of the player.
+        /// </summary>
         public GameParty Party { get; internal set; }
+        /// <summary>
+        ///     Gets the secrets for Rich Presence joining and spectating.
+        /// </summary>
         public GameSecrets Secrets { get; internal set; }
+        /// <summary>
+        ///     Gets the timestamps for start and/or end of the game.
+        /// </summary>
         public GameTimestamps Timestamps { get; internal set; }
-        
+
+        /// <summary>
+        ///     Returns the name of the Rich Presence.
+        /// </summary>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} (Rich)";
     }
diff --git a/src/Discord.Net.Core/Entities/Activities/SpotifyGame.cs b/src/Discord.Net.Core/Entities/Activities/SpotifyGame.cs
index 8b966d68b..23f88687d 100644
--- a/src/Discord.Net.Core/Entities/Activities/SpotifyGame.cs
+++ b/src/Discord.Net.Core/Entities/Activities/SpotifyGame.cs
@@ -4,22 +4,85 @@ using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A user's activity for listening to a song on Spotify.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SpotifyGame : Game
     {
+        /// <summary>
+        ///     Gets the song's artist(s).
+        /// </summary>
+        /// <returns>
+        ///     A collection of string containing all artists featured in the track (e.g. <c>Avicii</c>; <c>Rita Ora</c>).
+        /// </returns>
         public IReadOnlyCollection<string> Artists { get; internal set; }
+        /// <summary>
+        ///     Gets the Spotify album title of the song.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the album (e.g. <c>AVĪCI (01)</c>).
+        /// </returns>
         public string AlbumTitle { get; internal set; }
+        /// <summary>
+        ///     Gets the track title of the song.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the song (e.g. <c>Lonely Together (feat. Rita Ora)</c>).
+        /// </returns>
         public string TrackTitle { get; internal set; }
+        /// <summary>
+        ///     Gets the duration of the song.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="TimeSpan"/> containing the duration of the song.
+        /// </returns>
         public TimeSpan? Duration { get; internal set; }
 
+        /// <summary>
+        ///     Gets the track ID of the song.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the Spotify ID of the track (e.g. <c>7DoN0sCGIT9IcLrtBDm4f0</c>).
+        /// </returns>
         public string TrackId { get; internal set; }
+        /// <summary>
+        ///     Gets the session ID of the song.
+        /// </summary>
+        /// <remarks>
+        ///     The purpose of this property is currently unknown.
+        /// </remarks>
+        /// <returns>
+        ///     A string containing the session ID.
+        /// </returns>
         public string SessionId { get; internal set; }
 
+        /// <summary>
+        ///     Gets the URL of the album art.
+        /// </summary>
+        /// <returns>
+        ///     A URL pointing to the album art of the track (e.g. 
+        ///     <c>https://i.scdn.co/image/ba2fd8823d42802c2f8738db0b33a4597f2f39e7</c>).
+        /// </returns>
         public string AlbumArtUrl { get; internal set; }
+        /// <summary>
+        ///     Gets the direct Spotify URL of the track.
+        /// </summary>
+        /// <returns>
+        ///     A URL pointing directly to the track on Spotify. (e.g. 
+        ///     <c>https://open.spotify.com/track/7DoN0sCGIT9IcLrtBDm4f0</c>).
+        /// </returns>
         public string TrackUrl { get; internal set; }
 
         internal SpotifyGame() { }
 
+        /// <summary>
+        ///     Gets the full information of the song.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the full information of the song (e.g. 
+        ///     <c>Avicii, Rita Ora - Lonely Together (feat. Rita Ora) (3:08)</c>
+        /// </returns>
         public override string ToString() => $"{string.Join(", ", Artists)} - {TrackTitle} ({Duration})";
         private string DebuggerDisplay => $"{Name} (Spotify)";
     }
diff --git a/src/Discord.Net.Core/Entities/Activities/StreamingGame.cs b/src/Discord.Net.Core/Entities/Activities/StreamingGame.cs
index afbc24cd9..127ae0b7f 100644
--- a/src/Discord.Net.Core/Entities/Activities/StreamingGame.cs
+++ b/src/Discord.Net.Core/Entities/Activities/StreamingGame.cs
@@ -1,12 +1,23 @@
-using System.Diagnostics;
+using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A user's activity for streaming on services such as Twitch.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class StreamingGame : Game
     {
+        /// <summary>
+        ///     Gets the URL of the stream.
+        /// </summary>
         public string Url { get; internal set; }
 
+        /// <summary>
+        ///     Creates a new <see cref="StreamingGame" /> based on the <paramref name="name"/> on the stream URL.
+        /// </summary>
+        /// <param name="name">The name of the stream.</param>
+        /// <param name="url">The URL of the stream.</param>
         public StreamingGame(string name, string url)
         {
             Name = name;
@@ -14,7 +25,10 @@ namespace Discord
             Type = ActivityType.Streaming;
         }
 
+        /// <summary>
+        ///     Gets the name of the stream.
+        /// </summary>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Url})";
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/AuditLogs/ActionType.cs b/src/Discord.Net.Core/Entities/AuditLogs/ActionType.cs
index e5a4ff30a..2561a0970 100644
--- a/src/Discord.Net.Core/Entities/AuditLogs/ActionType.cs
+++ b/src/Discord.Net.Core/Entities/AuditLogs/ActionType.cs
@@ -1,50 +1,122 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
 namespace Discord
 {
     /// <summary>
-    /// The action type within a <see cref="IAuditLogEntry"/>
+    ///     Representing a type of action within an <see cref="IAuditLogEntry"/>.
     /// </summary>
     public enum ActionType
     {
+        /// <summary>
+        ///     this guild was updated.
+        /// </summary>
         GuildUpdated = 1,
 
+        /// <summary>
+        ///     A channel was created.
+        /// </summary>
         ChannelCreated = 10,
+        /// <summary>
+        ///     A channel was updated.
+        /// </summary>
         ChannelUpdated = 11,
+        /// <summary>
+        ///     A channel was deleted.
+        /// </summary>
         ChannelDeleted = 12,
 
+        /// <summary>
+        ///     A permission overwrite was created for a channel.
+        /// </summary>
         OverwriteCreated = 13,
+        /// <summary>
+        ///     A permission overwrite was updated for a channel.
+        /// </summary>
         OverwriteUpdated = 14,
+        /// <summary>
+        ///     A permission overwrite was deleted for a channel.
+        /// </summary>
         OverwriteDeleted = 15,
 
+        /// <summary>
+        ///     A user was kicked from this guild.
+        /// </summary>
         Kick = 20,
+        /// <summary>
+        ///     A prune took place in this guild.
+        /// </summary>
         Prune = 21,
+        /// <summary>
+        ///     A user banned another user from this guild.
+        /// </summary>
         Ban = 22,
+        /// <summary>
+        ///     A user unbanned another user from this guild.
+        /// </summary>
         Unban = 23,
 
+        /// <summary>
+        ///     A guild member whose information was updated.
+        /// </summary>
         MemberUpdated = 24,
+        /// <summary>
+        ///     A guild member's role collection was updated.
+        /// </summary>
         MemberRoleUpdated = 25,
 
+        /// <summary>
+        ///     A role was created in this guild.
+        /// </summary>
         RoleCreated = 30,
+        /// <summary>
+        ///     A role was updated in this guild.
+        /// </summary>
         RoleUpdated = 31,
+        /// <summary>
+        ///     A role was deleted from this guild.
+        /// </summary>
         RoleDeleted = 32,
 
+        /// <summary>
+        ///     An invite was created in this guild.
+        /// </summary>
         InviteCreated = 40,
+        /// <summary>
+        ///     An invite was updated in this guild.
+        /// </summary>
         InviteUpdated = 41,
+        /// <summary>
+        ///     An invite was deleted from this guild.
+        /// </summary>
         InviteDeleted = 42,
 
+        /// <summary>
+        ///     A Webhook was created in this guild.
+        /// </summary>
         WebhookCreated = 50,
+        /// <summary>
+        ///     A Webhook was updated in this guild.
+        /// </summary>
         WebhookUpdated = 51,
+        /// <summary>
+        ///     A Webhook was deleted from this guild.
+        /// </summary>
         WebhookDeleted = 52,
 
+        /// <summary>
+        ///     An emoji was created in this guild.
+        /// </summary>
         EmojiCreated = 60,
+        /// <summary>
+        ///     An emoji was updated in this guild.
+        /// </summary>
         EmojiUpdated = 61,
+        /// <summary>
+        ///     An emoji was deleted from this guild.
+        /// </summary>
         EmojiDeleted = 62,
 
+        /// <summary>
+        ///     A message was deleted from this guild.
+        /// </summary>
         MessageDeleted = 72
     }
 }
diff --git a/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogData.cs b/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogData.cs
index 47aaffb26..a99a14eda 100644
--- a/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogData.cs
+++ b/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogData.cs
@@ -1,13 +1,7 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
 namespace Discord
 {
     /// <summary>
-    /// Represents data applied to an <see cref="IAuditLogEntry"/>
+    ///     Represents data applied to an <see cref="IAuditLogEntry"/>.
     /// </summary>
     public interface IAuditLogData
     { }
diff --git a/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogEntry.cs b/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogEntry.cs
index 150c59a42..15ae5fd89 100644
--- a/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogEntry.cs
+++ b/src/Discord.Net.Core/Entities/AuditLogs/IAuditLogEntry.cs
@@ -7,28 +7,40 @@ using System.Threading.Tasks;
 namespace Discord
 {
     /// <summary>
-    /// Represents an entry in an audit log
+    ///     Represents a generic audit log entry.
     /// </summary>
     public interface IAuditLogEntry : ISnowflakeEntity
     {
         /// <summary>
-        /// The action which occured to create this entry
+        ///     Gets the action which occurred to create this entry.
         /// </summary>
+        /// <returns>
+        ///     The type of action for this audit log entry.
+        /// </returns>
         ActionType Action { get; }
 
         /// <summary>
-        /// The data for this entry. May be <see cref="null"/> if no data was available.
+        ///     Gets the data for this entry.
         /// </summary>
+        /// <returns>
+        ///     An <see cref="IAuditLogData" /> for this audit log entry; <c>null</c> if no data is available.
+        /// </returns>
         IAuditLogData Data { get; }
 
         /// <summary>
-        /// The user responsible for causing the changes
+        ///     Gets the user responsible for causing the changes.
         /// </summary>
+        /// <returns>
+        ///     A user object.
+        /// </returns>
         IUser User { get; }
 
         /// <summary>
-        /// The reason behind the change. May be <see cref="null"/> if no reason was provided.
+        ///     Gets the reason behind the change.
         /// </summary>
+        /// <returns>
+        ///     A string containing the reason for the change; <c>null</c> if none is provided.
+        /// </returns>
         string Reason { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/CacheMode.cs b/src/Discord.Net.Core/Entities/CacheMode.cs
index a047bd616..503a80479 100644
--- a/src/Discord.Net.Core/Entities/CacheMode.cs
+++ b/src/Discord.Net.Core/Entities/CacheMode.cs
@@ -1,8 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the cache mode that should be used.
+    /// </summary>
     public enum CacheMode
     {
+        /// <summary>
+        ///     Allows the object to be downloaded if it does not exist in the current cache.
+        /// </summary>
         AllowDownload,
+        /// <summary>
+        ///     Only allows the object to be pulled from the existing cache.
+        /// </summary>
         CacheOnly
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/ChannelType.cs b/src/Discord.Net.Core/Entities/Channels/ChannelType.cs
index e9f069a50..7759622c2 100644
--- a/src/Discord.Net.Core/Entities/Channels/ChannelType.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ChannelType.cs
@@ -1,11 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Defines the types of channels. </summary>
     public enum ChannelType
     {
+        /// <summary> The channel is a text channel. </summary>
         Text = 0,
+        /// <summary> The channel is a Direct Message channel. </summary>
         DM = 1,
+        /// <summary> The channel is a voice channel. </summary>
         Voice = 2,
+        /// <summary> The channel is a group channel. </summary>
         Group = 3,
+        /// <summary> The channel is a category channel. </summary>
         Category = 4
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/Direction.cs b/src/Discord.Net.Core/Entities/Channels/Direction.cs
index 5d8d5e621..6d5f7cd6b 100644
--- a/src/Discord.Net.Core/Entities/Channels/Direction.cs
+++ b/src/Discord.Net.Core/Entities/Channels/Direction.cs
@@ -1,9 +1,21 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the direction of where message(s) should be gotten from.
+    /// </summary>
     public enum Direction
     {
+        /// <summary>
+        ///     The message(s) should be retrieved before a message.
+        /// </summary>
         Before,
+        /// <summary>
+        ///     The message(s) should be retrieved after a message.
+        /// </summary>
         After,
+        /// <summary>
+        ///     The message(s) should be retrieved around a message.
+        /// </summary>
         Around
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
index 2ac6c8d52..4e92a2369 100644
--- a/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
@@ -1,33 +1,28 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify an IGuildChannel with the specified changes.
+    ///     Properties that are used to modify an <see cref="IGuildChannel" /> with the specified changes.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await (Context.Channel as ITextChannel)?.ModifyAsync(x =>
-    /// {
-    ///     x.Name = "do-not-enter";
-    /// });
-    /// </code>
-    /// </example>
+    /// <seealso cref="IGuildChannel.ModifyAsync"/>
     public class GuildChannelProperties
     {
         /// <summary>
-        /// Set the channel to this name
+        ///     Gets or sets the channel to this name.
         /// </summary>
         /// <remarks>
-        /// When modifying an ITextChannel, the Name MUST be alphanumeric with dashes.
-        /// It must match the following RegEx: [a-z0-9-_]{2,100}
+        ///     This property defines the new name for this channel.
+        ///     <note type="warning">
+        ///         When modifying an <see cref="ITextChannel"/>, the <see cref="Name"/> must be alphanumeric with
+        ///         dashes. It must match the RegEx <c>[a-z0-9-_]{2,100}</c>.
+        ///     </note>
         /// </remarks>
-        /// <exception cref="Net.HttpException">A BadRequest will be thrown if the name does not match the above RegEx.</exception>
         public Optional<string> Name { get; set; }
         /// <summary>
-        /// Move the channel to the following position. This is 0-based!
+        ///     Moves the channel to the following position. This property is zero-based.
         /// </summary>
         public Optional<int> Position { get; set; }
         /// <summary>
-        /// Sets the category for this channel
+        ///     Gets or sets the category ID for this channel.
         /// </summary>
         public Optional<ulong?> CategoryId { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Channels/IAudioChannel.cs b/src/Discord.Net.Core/Entities/Channels/IAudioChannel.cs
index a152ff744..179f4b03e 100644
--- a/src/Discord.Net.Core/Entities/Channels/IAudioChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IAudioChannel.cs
@@ -1,15 +1,31 @@
 using Discord.Audio;
-using System;
 using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic audio channel.
+    /// </summary>
     public interface IAudioChannel : IChannel
     {
-        /// <summary> Connects to this audio channel. </summary>
+        /// <summary>
+        ///     Connects to this audio channel.
+        /// </summary>
+        /// <param name="selfDeaf">Determines whether the client should deaf itself upon connection.</param>
+        /// <param name="selfMute">Determines whether the client should mute itself upon connection.</param>
+        /// <param name="external">Determines whether the audio client is an external one or not.</param>
+        /// <returns>
+        ///     A task representing the asynchronous connection operation. The task result contains the
+        ///     <see cref="IAudioClient"/> responsible for the connection.
+        /// </returns>
         Task<IAudioClient> ConnectAsync(bool selfDeaf = false, bool selfMute = false, bool external = false);
 
-        /// <summary> Disconnects from this audio channel. </summary>
+        /// <summary>
+        ///     Disconnects from this audio channel.
+        /// </summary>
+        /// <returns>
+        ///     A task representing the asynchronous operation for disconnecting from the audio channel.
+        /// </returns>
         Task DisconnectAsync();
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/ICategoryChannel.cs b/src/Discord.Net.Core/Entities/Channels/ICategoryChannel.cs
index c004cafd5..838908b68 100644
--- a/src/Discord.Net.Core/Entities/Channels/ICategoryChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ICategoryChannel.cs
@@ -1,11 +1,8 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic category channel.
+    /// </summary>
     public interface ICategoryChannel : IGuildChannel
     {
     }
diff --git a/src/Discord.Net.Core/Entities/Channels/IChannel.cs b/src/Discord.Net.Core/Entities/Channels/IChannel.cs
index ea930e112..b66f778fb 100644
--- a/src/Discord.Net.Core/Entities/Channels/IChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IChannel.cs
@@ -1,17 +1,43 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic channel.
+    /// </summary>
     public interface IChannel : ISnowflakeEntity
     {
-        /// <summary> Gets the name of this channel. </summary>
+        /// <summary>
+        ///     Gets the name of this channel.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this channel.
+        /// </returns>
         string Name { get; }
-        
-        /// <summary> Gets a collection of all users in this channel. </summary>
+
+        /// <summary>
+        ///     Gets a collection of all users in this channel.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A paged collection containing a collection of users that can access this channel. Flattening the
+        ///     paginated response into a collection of users with 
+        ///     <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<IUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        
-        /// <summary> Gets a user in this channel with the provided id. </summary>
+
+        /// <summary>
+        ///     Gets a user in this channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user (e.g. <c>168693960628371456</c>).</param>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a user object that
+        ///     represents the found user; <c>null</c> if none is found.
+        /// </returns>
         Task<IUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/IDMChannel.cs b/src/Discord.Net.Core/Entities/Channels/IDMChannel.cs
index 1608d1543..f0ef7f3f3 100644
--- a/src/Discord.Net.Core/Entities/Channels/IDMChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IDMChannel.cs
@@ -1,13 +1,27 @@
-using System.Threading.Tasks;
+using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic direct-message channel.
+    /// </summary>
     public interface IDMChannel : IMessageChannel, IPrivateChannel
     {
-        /// <summary> Gets the recipient of all messages in this channel. </summary>
+        /// <summary>
+        ///     Gets the recipient of all messages in this channel.
+        /// </summary>
+        /// <returns>
+        ///     A user object that represents the other user in this channel.
+        /// </returns>
         IUser Recipient { get; }
 
-        /// <summary> Closes this private channel, removing it from your channel list. </summary>
+        /// <summary>
+        ///     Closes this private channel, removing it from your channel list.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous close operation.
+        /// </returns>
         Task CloseAsync(RequestOptions options = null);
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Channels/IGroupChannel.cs b/src/Discord.Net.Core/Entities/Channels/IGroupChannel.cs
index d6cb2c182..77af3450e 100644
--- a/src/Discord.Net.Core/Entities/Channels/IGroupChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IGroupChannel.cs
@@ -1,10 +1,19 @@
-using System.Threading.Tasks;
+using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic private group channel.
+    /// </summary>
     public interface IGroupChannel : IMessageChannel, IPrivateChannel, IAudioChannel
     {
-        /// <summary> Leaves this group. </summary>
+        /// <summary>
+        ///     Leaves this group.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous leave operation.
+        /// </returns>
         Task LeaveAsync(RequestOptions options = null);
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs b/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
index 6514d46cd..c3a2161cc 100644
--- a/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
@@ -4,45 +4,172 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic guild channel.
+    /// </summary>
+    /// <seealso cref="ITextChannel"/>
+    /// <seealso cref="IVoiceChannel"/>
+    /// <seealso cref="ICategoryChannel"/>
     public interface IGuildChannel : IChannel, IDeletable
     {
-        /// <summary> Gets the position of this channel in the guild's channel list, relative to others of the same type. </summary>
+        /// <summary>
+        ///     Gets the position of this channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the position of this channel in the guild's channel list relative to
+        ///     others of the same type.
+        /// </returns>
         int Position { get; }
 
-        /// <summary> Gets the guild this channel is a member of. </summary>
+        /// <summary>
+        ///     Gets the guild associated with this channel.
+        /// </summary>
+        /// <returns>
+        ///     A guild object that this channel belongs to.
+        /// </returns>
         IGuild Guild { get; }
-        /// <summary> Gets the id of the guild this channel is a member of. </summary>
+        /// <summary>
+        ///     Gets the guild ID associated with this channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="ulong"/> representing the guild snowflake identifier for the guild that this channel
+        ///     belongs to.
+        /// </returns>
         ulong GuildId { get; }
-        /// <summary> Gets a collection of permission overwrites for this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of permission overwrites for this channel.
+        /// </summary>
+        /// <returns>
+        ///     A collection of overwrites associated with this channel.
+        /// </returns>
         IReadOnlyCollection<Overwrite> PermissionOverwrites { get; }
 
-        /// <summary> Creates a new invite to this channel. </summary>
-        /// <param name="maxAge"> The time (in seconds) until the invite expires. Set to null to never expire. </param>
-        /// <param name="maxUses"> The max amount  of times this invite may be used. Set to null to have unlimited uses. </param>
-        /// <param name="isTemporary"> If true, a user accepting this invite will be kicked from the guild after closing their client. </param>
+        /// <summary>
+        ///     Creates a new invite to this channel.
+        /// </summary>
+        /// <example>
+        ///     The following example creates a new invite to this channel; the invite lasts for 12 hours and can only
+        ///     be used 3 times throughout its lifespan.
+        ///     <code language="cs">
+        ///     await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3);
+        ///     </code>
+        /// </example>
+        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
+        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
+        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
+        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
+        ///     metadata object containing information for the created invite.
+        /// </returns>
         Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = default(int?), bool isTemporary = false, bool isUnique = false, RequestOptions options = null);
-        /// <summary> Returns a collection of all invites to this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of all invites to this channel.
+        /// </summary>
+        /// <example>
+        ///     The following example gets all of the invites that have been created in this channel and selects the
+        ///     most used invite.
+        ///     <code language="cs">
+        ///     var invites = await channel.GetInvitesAsync();
+        ///     if (invites.Count == 0) return;
+        ///     var invite = invites.OrderByDescending(x => x.Uses).FirstOrDefault();
+        ///     </code>
+        /// </example>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of invite metadata that are created for this channel.
+        /// </returns>
         Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null);
 
-        /// <summary> Modifies this guild channel. </summary>
+        /// <summary>
+        ///     Modifies this guild channel.
+        /// </summary>
+        /// <param name="func">The delegate containing the properties to modify the channel with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
         Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null);
 
-        /// <summary> Gets the permission overwrite for a specific role, or null if one does not exist. </summary>
+        /// <summary>
+        ///     Gets the permission overwrite for a specific role.
+        /// </summary>
+        /// <param name="role">The role to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted role; <c>null</c> if none is set.
+        /// </returns>
         OverwritePermissions? GetPermissionOverwrite(IRole role);
-        /// <summary> Gets the permission overwrite for a specific user, or null if one does not exist. </summary>
+        /// <summary>
+        ///     Gets the permission overwrite for a specific user.
+        /// </summary>
+        /// <param name="user">The user to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted user; <c>null</c> if none is set.
+        /// </returns>
         OverwritePermissions? GetPermissionOverwrite(IUser user);
-        /// <summary> Removes the permission overwrite for the given role, if one exists. </summary>
+        /// <summary>
+        ///     Removes the permission overwrite for the given role, if one exists.
+        /// </summary>
+        /// <param name="role">The role to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null);
-        /// <summary> Removes the permission overwrite for the given user, if one exists. </summary>
+        /// <summary>
+        ///     Removes the permission overwrite for the given user, if one exists.
+        /// </summary>
+        /// <param name="user">The user to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null);
-        /// <summary> Adds or updates the permission overwrite for the given role. </summary>
+
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given role.
+        /// </summary>
+        /// <param name="role">The role to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the role.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
         Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null);
-        /// <summary> Adds or updates the permission overwrite for the given user. </summary>
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given user.
+        /// </summary>
+        /// <param name="user">The user to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
         Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null);
 
-        /// <summary> Gets a collection of all users in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of users that are able to view the channel.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A paged collection containing a collection of guild users that can access this channel. Flattening the
+        ///     paginated response into a collection of users with 
+        ///     <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users.
+        /// </returns>
         new IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets a user in this channel with the provided id.</summary>
+        /// <summary>
+        ///     Gets a user in this channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous get operation. The task result contains a guild user object that
+        ///     represents the user; <c>null</c> if none is found.
+        /// </returns>
         new Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/IMessageChannel.cs b/src/Discord.Net.Core/Entities/Channels/IMessageChannel.cs
index ef5a6fa7a..919b3f60b 100644
--- a/src/Discord.Net.Core/Entities/Channels/IMessageChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IMessageChannel.cs
@@ -5,38 +5,276 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic channel that can send and receive messages.
+    /// </summary>
     public interface IMessageChannel : IChannel
     {
-        /// <summary> Sends a message to this message channel. </summary>
+        /// <summary>
+        ///     Sends a message to this message channel.
+        /// </summary>
+        /// <example>
+        ///     The following example sends a message with the current system time in RFC 1123 format to the channel and
+        ///     deletes itself after 5 seconds.
+        ///     <code language="cs">
+        ///     var message = await channel.SendMessageAsync(DateTimeOffset.UtcNow.ToString("R"));
+        ///     await Task.Delay(TimeSpan.FromSeconds(5))
+        ///         .ContinueWith(x => message.DeleteAsync());
+        ///     </code>
+        /// </example>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Determines whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         Task<IUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <example>
+        ///     The following example uploads a local file called <c>wumpus.txt</c> along with the text 
+        ///     <c>good discord boi</c> to the channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync("wumpus.txt", "good discord boi");
+        ///     </code>
+        /// 
+        ///     The following example uploads a local image called <c>b1nzy.jpg</c> embedded inside a rich embed to the
+        ///     channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync("b1nzy.jpg",
+        ///         embed: new EmbedBuilder {ImageUrl = "attachment://b1nzy.jpg"}.Build());
+        ///     </code>
+        /// </example>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/> embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>. See the example section for its usage.
+        ///     </note>
+        /// </remarks>
+        /// <param name="filePath">The file path of the file.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich" /> <see cref="Embed" /> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         Task<IUserMessage> SendFileAsync(string filePath, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <example>
+        ///     The following example uploads a streamed image that will be called <c>b1nzy.jpg</c> embedded inside a
+        ///     rich embed to the channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync(b1nzyStream, "b1nzy.jpg",
+        ///         embed: new EmbedBuilder {ImageUrl = "attachment://b1nzy.jpg"}.Build());
+        ///     </code>
+        /// </example>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/> embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>. See the example section for its usage.
+        ///     </note>
+        /// </remarks>
+        /// <param name="stream">The <see cref="Stream" /> of the file to be sent.</param>
+        /// <param name="filename">The name of the attachment.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         Task<IUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
 
-        /// <summary> Gets a message from this message channel with the given id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a message from this message channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the message.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous get operation for retrieving the message. The task result contains
+        ///     the retrieved message; <c>null</c> if no message is found with the specified identifier.
+        /// </returns>
         Task<IMessage> GetMessageAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets the last N messages from this message channel. </summary>
+
+        /// <summary>
+        ///     Gets the last N messages from this message channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/>. The
+        ///     library will attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example downloads 300 messages and gets messages that belong to the user 
+        ///     <c>53905483156684800</c>.
+        ///     <code lang="cs">
+        ///     var messages = await messageChannel.GetMessagesAsync(300).FlattenAsync();
+        ///     var userMessages = messages.Where(x =&gt; x.Author.Id == 53905483156684800);
+        ///     </code>
+        /// </example>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from
+        /// cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, 
             CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessageId"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to the message identifier <c>442012544660537354</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(442012544660537354, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessageId">The ID of the starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from
+        /// cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, 
             CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessage"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to a specific message, <c>oldMessage</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(oldMessage, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessage">The starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from
+        /// cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, 
             CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets a collection of pinned messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of pinned messages in this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation for retrieving pinned messages in this channel.
+        ///     The task result contains a collection of messages found in the pinned messages.
+        /// </returns>
         Task<IReadOnlyCollection<IMessage>> GetPinnedMessagesAsync(RequestOptions options = null);
 
-        /// <summary> Deletes a message based on the message ID in this channel. </summary>
+        /// <summary>
+        ///     Deletes a message.
+        /// </summary>
+        /// <param name="messageId">The snowflake identifier of the message that would be removed.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation.
+        /// </returns>
         Task DeleteMessageAsync(ulong messageId, RequestOptions options = null);
         /// <summary> Deletes a message based on the provided message in this channel. </summary>
+        /// <param name="message">The message that would be removed.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation.
+        /// </returns>
         Task DeleteMessageAsync(IMessage message, RequestOptions options = null);
 
-        /// <summary> Broadcasts the "user is typing" message to all users in this channel, lasting 10 seconds. </summary>
+        /// <summary>
+        ///     Broadcasts the "user is typing" message to all users in this channel, lasting 10 seconds.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation that triggers the broadcast.
+        /// </returns>
         Task TriggerTypingAsync(RequestOptions options = null);
-        /// <summary> Continuously broadcasts the "user is typing" message to all users in this channel until the returned object is disposed. </summary>
+        /// <summary>
+        ///     Continuously broadcasts the "user is typing" message to all users in this channel until the returned
+        ///     object is disposed.
+        /// </summary>
+        /// <example>
+        ///     The following example keeps the client in the typing state until <c>LongRunningAsync</c> has finished.
+        ///     <code lang="cs">
+        ///     using (messageChannel.EnterTypingState())
+        ///     {
+        ///         await LongRunningAsync();
+        ///     }
+        ///     </code>
+        /// </example>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A disposable object that, upon its disposal, will stop the client from broadcasting its typing state in
+        ///     this channel.
+        /// </returns>
         IDisposable EnterTypingState(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
index c8d2bcaaf..22182a4ca 100644
--- a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
@@ -3,14 +3,27 @@ using System.Threading.Tasks;
 namespace Discord
 {
     /// <summary>
-    /// A type of guild channel that can be nested within a category.
-    /// Contains a CategoryId that is set to the parent category, if it is set.
+    ///     Represents a type of guild channel that can be nested within a category.
     /// </summary>
     public interface INestedChannel : IGuildChannel
     {
-        /// <summary> Gets the parentid (category) of this channel in the guild's channel list. </summary>
+        /// <summary>
+        ///     Gets the parent (category) ID of this channel in the guild's channel list.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the parent of this channel; 
+        ///     <c>null</c> if none is set.
+        /// </returns>
         ulong? CategoryId { get; }
-        /// <summary> Gets the parent channel (category) of this channel, if it is set. If unset, returns null.</summary>
+        /// <summary>
+        ///     Gets the parent (category) channel of this channel.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the category channel
+        ///     representing the parent of this channel; <c>null</c> if none is set.
+        /// </returns>
         Task<ICategoryChannel> GetCategoryAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/IPrivateChannel.cs b/src/Discord.Net.Core/Entities/Channels/IPrivateChannel.cs
index 9a3289794..cd2307c2d 100644
--- a/src/Discord.Net.Core/Entities/Channels/IPrivateChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IPrivateChannel.cs
@@ -1,9 +1,18 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic channel that is private to select recipients.
+    /// </summary>
     public interface IPrivateChannel : IChannel
     {
+        /// <summary>
+        ///     Gets the users that can access this channel.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of users that can access this channel.
+        /// </returns>
         IReadOnlyCollection<IUser> Recipients { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
index 89e10e65e..440349eca 100644
--- a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
@@ -5,30 +5,114 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic channel in a guild that can send and receive messages.
+    /// </summary>
     public interface ITextChannel : IMessageChannel, IMentionable, INestedChannel
     {
-        /// <summary> Checks if the channel is NSFW. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the channel is NSFW.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the channel has the NSFW flag enabled; otherwise <c>false</c>.
+        /// </returns>
         bool IsNsfw { get; }
 
-        /// <summary> Gets the current topic for this text channel. </summary>
+        /// <summary>
+        ///     Gets the current topic for this text channel.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the topic set in the channel; <c>null</c> if none is set.
+        /// </returns>
         string Topic { get; }
 
-        ///<summary> Gets the current slow-mode delay for this channel. 0 if disabled. </summary>
+        /// <summary>
+        ///     Gets the current slow-mode delay for this channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="Int32"/> representing the time in seconds required before the user can send another
+        ///     message; <c>0</c> if disabled.
+        /// </returns>
         int SlowModeInterval { get; }
 
-        /// <summary> Bulk deletes multiple messages. </summary>
+        /// <summary>
+        ///     Bulk-deletes multiple messages.
+        /// </summary>
+        /// <example>
+        ///     The following example gets 250 messages from the channel and deletes them.
+        ///     <code lang="cs">
+        ///     var messages = await textChannel.GetMessagesAsync(250).FlattenAsync();
+        ///     await textChannel.DeleteMessagesAsync(messages);
+        ///     </code>
+        /// </example>
+        /// <remarks>
+        ///     This method attempts to remove the messages specified in bulk.
+        ///     <note type="important">
+        ///         Due to the limitation set by Discord, this method can only remove messages that are posted within 14 days!
+        ///     </note>
+        /// </remarks>
+        /// <param name="messages">The messages to be bulk-deleted.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous bulk-removal operation.
+        /// </returns>
         Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null);
-        /// <summary> Bulk deletes multiple messages. </summary>
+        /// <summary>
+        ///     Bulk-deletes multiple messages.
+        /// </summary>
+        /// <remarks>
+        ///     This method attempts to remove the messages specified in bulk.
+        ///     <note type="important">
+        ///         Due to the limitation set by Discord, this method can only remove messages that are posted within 14 days!
+        ///     </note>
+        /// </remarks>
+        /// <param name="messageIds">The snowflake identifier of the messages to be bulk-deleted.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous bulk-removal operation.
+        /// </returns>
         Task DeleteMessagesAsync(IEnumerable<ulong> messageIds, RequestOptions options = null);
 
-        /// <summary> Modifies this text channel. </summary>
+        /// <summary>
+        ///     Modifies this text channel.
+        /// </summary>
+        /// <param name="func">The delegate containing the properties to modify the channel with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
+        /// <seealso cref="TextChannelProperties"/>
         Task ModifyAsync(Action<TextChannelProperties> func, RequestOptions options = null);
-
-        /// <summary> Creates a webhook in this text channel. </summary>
+        
+        /// <summary>
+        ///     Creates a webhook in this text channel.
+        /// </summary>
+        /// <param name="name">The name of the webhook.</param>
+        /// <param name="avatar">The avatar of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     webhook.
+        /// </returns>
         Task<IWebhook> CreateWebhookAsync(string name, Stream avatar = null, RequestOptions options = null);
-        /// <summary> Gets the webhook in this text channel with the provided id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a webhook available in this text channel.
+        /// </summary>
+        /// <param name="id">The identifier of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a webhook associated
+        ///     with the identifier; <c>null</c> if the webhook is not found.
+        /// </returns>
         Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null);
-        /// <summary> Gets the webhooks for this text channel. </summary>
+        /// <summary>
+        ///     Gets the webhooks available in this text channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks that is available in this channel.
+        /// </returns>
         Task<IReadOnlyCollection<IWebhook>> GetWebhooksAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/IVoiceChannel.cs b/src/Discord.Net.Core/Entities/Channels/IVoiceChannel.cs
index 2e345bfda..9c2d008ee 100644
--- a/src/Discord.Net.Core/Entities/Channels/IVoiceChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IVoiceChannel.cs
@@ -3,14 +3,37 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic voice channel in a guild.
+    /// </summary>
     public interface IVoiceChannel : INestedChannel, IAudioChannel
     {
-        /// <summary> Gets the bitrate, in bits per second, clients in this voice channel are requested to use. </summary>
+        /// <summary>
+        ///     Gets the bit-rate that the clients in this voice channel are requested to use.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the bit-rate (bps) that this voice channel defines and requests the
+        ///     client(s) to use.
+        /// </returns>
         int Bitrate { get; }
-        /// <summary> Gets the max amount of users allowed to be connected to this channel at one time. </summary>
+        /// <summary>
+        ///     Gets the max number of users allowed to be connected to this channel at once.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the maximum number of users that are allowed to be connected to this
+        ///     channel at once; <c>null</c> if a limit is not set.
+        /// </returns>
         int? UserLimit { get; }
 
-        /// <summary> Modifies this voice channel. </summary>
+        /// <summary>
+        ///     Modifies this voice channel.
+        /// </summary>
+        /// <param name="func">The properties to modify the channel with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
+        /// <seealso cref="VoiceChannelProperties"/>
         Task ModifyAsync(Action<VoiceChannelProperties> func, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/ReorderChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/ReorderChannelProperties.cs
index 31f814334..ffd90dae6 100644
--- a/src/Discord.Net.Core/Entities/Channels/ReorderChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ReorderChannelProperties.cs
@@ -1,12 +1,28 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Provides properties that are used to reorder an <see cref="IGuildChannel"/>.
+    /// </summary>
     public class ReorderChannelProperties
     {
-        /// <summary>The id of the channel to apply this position to.</summary>
+        /// <summary>
+        ///     Gets the ID of the channel to apply this position to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of this channel.
+        /// </returns>
         public ulong Id { get; }
-        /// <summary>The new zero-based position of this channel. </summary>
+        /// <summary>
+        ///     Gets the new zero-based position of this channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the new position of this channel.
+        /// </returns>
         public int Position { get; }
 
+        /// <summary> Initializes a new instance of the <see cref="ReorderChannelProperties"/> class used to reorder a channel. </summary>
+        /// <param name="id"> Sets the ID of the channel to apply this position to. </param>
+        /// <param name="position"> Sets the new zero-based position of this channel. </param>
         public ReorderChannelProperties(ulong id, int position)
         {
             Id = id;
diff --git a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
index 87adccb85..fbe4bfa43 100644
--- a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
@@ -1,27 +1,29 @@
-using System;
-
 namespace Discord
 {
-    /// <inheritdoc />
+    /// <summary>
+    ///     Provides properties that are used to modify an <see cref="ITextChannel"/> with the specified changes.
+    /// </summary>
+    /// <seealso cref="ITextChannel.ModifyAsync(System.Action{TextChannelProperties}, RequestOptions)"/>
     public class TextChannelProperties : GuildChannelProperties
     {
         /// <summary>
-        /// What the topic of the channel should be set to.
+        ///     Gets or sets the topic of the channel.
         /// </summary>
         public Optional<string> Topic { get; set; }
         /// <summary>
-        /// Should this channel be flagged as NSFW?
+        ///     Gets or sets whether this channel should be flagged as NSFW.
         /// </summary>
         public Optional<bool> IsNsfw { get; set; }
         /// <summary>
-        /// What the slow-mode ratelimit for this channel should be set to; 0 will disable slow-mode.
+        ///     Gets or sets the slow-mode ratelimit in seconds for this channel.
         /// </summary>
         /// <remarks>
-        /// This value must fall within [0, 120]
-        /// 
-        /// Users with <see cref="ChannelPermission.ManageMessages"/> will be exempt from slow-mode.
+        ///     Setting this value to <c>0</c> will disable slow-mode for this channel.
+        ///     <note>
+        ///         Users with <see cref="Discord.ChannelPermission.ManageMessages" /> will be exempt from slow-mode.
+        ///     </note>
         /// </remarks>
-        /// <exception cref="ArgumentOutOfRangeException">Throws ArgummentOutOfRange if the value does not fall within [0, 120]</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Thrown if the value does not fall within [0, 120].</exception>
         public Optional<int> SlowModeInterval { get; set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/VoiceChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/VoiceChannelProperties.cs
index 81dd8063e..fb4d47800 100644
--- a/src/Discord.Net.Core/Entities/Channels/VoiceChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/VoiceChannelProperties.cs
@@ -1,14 +1,16 @@
-namespace Discord
+namespace Discord
 {
-    /// <inheritdoc />
+    /// <summary>
+    ///     Provides properties that are used to modify an <see cref="IVoiceChannel" /> with the specified changes.
+    /// </summary>
     public class VoiceChannelProperties : GuildChannelProperties
     {
         /// <summary>
-        /// The bitrate of the voice connections in this channel. Must be greater than 8000
+        ///     Gets or sets the bitrate of the voice connections in this channel. Must be greater than 8000.
         /// </summary>
         public Optional<int> Bitrate { get; set; }
         /// <summary>
-        /// The maximum number of users that can be present in a channel.
+        ///     Gets or sets the maximum number of users that can be present in a channel, or <c>null</c> if none.
         /// </summary>
         public Optional<int?> UserLimit { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Emotes/Emoji.cs b/src/Discord.Net.Core/Entities/Emotes/Emoji.cs
index c2dfc31ad..d5e795094 100644
--- a/src/Discord.Net.Core/Entities/Emotes/Emoji.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/Emoji.cs
@@ -1,28 +1,35 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// A unicode emoji
+    ///     A Unicode emoji.
     /// </summary>
     public class Emoji : IEmote
     {
-        // TODO: need to constrain this to unicode-only emojis somehow
+        // TODO: need to constrain this to Unicode-only emojis somehow
 
+        /// <inheritdoc />
+        public string Name { get; }
         /// <summary>
-        /// The unicode representation of this emote.
+        ///     Gets the Unicode representation of this emote.
         /// </summary>
-        public string Name { get; }
-
+        /// <returns>
+        ///     A string that resolves to <see cref="Emoji.Name"/>.
+        /// </returns>
         public override string ToString() => Name;
 
         /// <summary>
-        /// Creates a unicode emoji.
+        ///     Initializes a new <see cref="Emoji"/> class with the provided Unicode.
         /// </summary>
-        /// <param name="unicode">The pure UTF-8 encoding of an emoji</param>
+        /// <param name="unicode">The pure UTF-8 encoding of an emoji.</param>
         public Emoji(string unicode)
         {
             Name = unicode;
         }
 
+        /// <summary>
+        ///     Determines whether the specified emoji is equal to the current one.
+        /// </summary>
+        /// <param name="other">The object to compare with the current object.</param>
         public override bool Equals(object other)
         {
             if (other == null) return false;
@@ -34,6 +41,7 @@
             return string.Equals(Name, otherEmoji.Name);
         }
 
+        /// <inheritdoc />
         public override int GetHashCode() => Name.GetHashCode();
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Emotes/Emote.cs b/src/Discord.Net.Core/Entities/Emotes/Emote.cs
index a71a73327..bebd9fa4f 100644
--- a/src/Discord.Net.Core/Entities/Emotes/Emote.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/Emote.cs
@@ -1,26 +1,34 @@
 using System;
 using System.Globalization;
+using System.Diagnostics;
 
 namespace Discord
 {
     /// <summary>
-    /// A custom image-based emote
+    ///     A custom image-based emote.
     /// </summary>
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class Emote : IEmote, ISnowflakeEntity
     {
-        /// <summary>
-        /// The display name (tooltip) of this emote
-        /// </summary>
+        /// <inheritdoc />
         public string Name { get; }
-        /// <summary>
-        /// The ID of this emote
-        /// </summary>
+        /// <inheritdoc />
         public ulong Id { get; }
         /// <summary>
-        /// Is this emote animated?
+        ///     Gets whether this emote is animated.
         /// </summary>
+        /// <returns>
+        ///     A boolean that determines whether or not this emote is an animated one.
+        /// </returns>
         public bool Animated { get; }
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <summary>
+        ///     Gets the image URL of this emote.
+        /// </summary>
+        /// <returns>
+        ///     A string that points to the URL of this emote.
+        /// </returns>
         public string Url => CDN.GetEmojiUrl(Id, Animated);
 
         internal Emote(ulong id, string name, bool animated)
@@ -30,6 +38,10 @@ namespace Discord
             Animated = animated;
         }
 
+        /// <summary>
+        ///     Determines whether the specified emote is equal to the current emote.
+        /// </summary>
+        /// <param name="other">The object to compare with the current object.</param>
         public override bool Equals(object other)
         {
             if (other == null) return false;
@@ -41,6 +53,7 @@ namespace Discord
             return string.Equals(Name, otherEmote.Name) && Id == otherEmote.Id;
         }
 
+        /// <inheritdoc />
         public override int GetHashCode()
         {
             unchecked
@@ -49,18 +62,20 @@ namespace Discord
             }
         }
 
-        /// <summary>
-        /// Parse an Emote from its raw format
-        /// </summary>
-        /// <param name="text">The raw encoding of an emote; for example, &lt;:dab:277855270321782784&gt;</param>
-        /// <returns>An emote</returns>
+        /// <summary> Parses an <see cref="Emote"/> from its raw format. </summary>
+        /// <param name="text">The raw encoding of an emote (e.g. <c>&lt;:dab:277855270321782784&gt;</c>).</param>
+        /// <returns>An emote.</returns>
+        /// <exception cref="ArgumentException">Invalid emote format.</exception>
         public static Emote Parse(string text)
         {
             if (TryParse(text, out Emote result))
                 return result;
-            throw new ArgumentException(message: "Invalid emote format", paramName: nameof(text));
+            throw new ArgumentException(message: "Invalid emote format.", paramName: nameof(text));
         }
 
+        /// <summary> Tries to parse an <see cref="Emote"/> from its raw format. </summary>
+        /// <param name="text">The raw encoding of an emote; for example, &lt;:dab:277855270321782784&gt;.</param>
+        /// <param name="result">An emote.</param>
         public static bool TryParse(string text, out Emote result)
         {
             result = null;
@@ -85,6 +100,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Name} ({Id})";
+        /// <summary>
+        ///     Returns the raw representation of the emote.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the raw presentation of the emote (e.g. <c>&lt;:thonkang:282745590985523200&gt;</c>).
+        /// </returns>
         public override string ToString() => $"<{(Animated ? "a" : "")}:{Name}:{Id}>";
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Emotes/EmoteProperties.cs b/src/Discord.Net.Core/Entities/Emotes/EmoteProperties.cs
index be24d306c..41679d2af 100644
--- a/src/Discord.Net.Core/Entities/Emotes/EmoteProperties.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/EmoteProperties.cs
@@ -1,10 +1,20 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Provides properties that are used to modify an <see cref="Emote" /> with the specified changes.
+    /// </summary>
+    /// <seealso cref="IGuild.ModifyEmoteAsync"/>
     public class EmoteProperties
     {
+        /// <summary>
+        ///     Gets or sets the name of the <see cref="Emote"/>.
+        /// </summary>
         public Optional<string> Name { get; set; }
+        /// <summary>
+        ///     Gets or sets the roles that can access this <see cref="Emote"/>.
+        /// </summary>
         public Optional<IEnumerable<IRole>> Roles { get; set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Emotes/GuildEmote.cs b/src/Discord.Net.Core/Entities/Emotes/GuildEmote.cs
index 95b062bd2..9affb1e89 100644
--- a/src/Discord.Net.Core/Entities/Emotes/GuildEmote.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/GuildEmote.cs
@@ -1,16 +1,34 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Diagnostics;
 
 namespace Discord
 {
     /// <summary>
-    /// An image-based emote that is attached to a guild
+    ///     An image-based emote that is attached to a guild.
     /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class GuildEmote : Emote
     {
+        /// <summary>
+        ///     Gets whether this emoji is managed by an integration.
+        /// </summary>
+        /// <returns>
+        ///     A boolean that determines whether or not this emote is managed by a Twitch integration.
+        /// </returns>
         public bool IsManaged { get; }
+        /// <summary>
+        ///     Gets whether this emoji must be wrapped in colons.
+        /// </summary>
+        /// <returns>
+        ///     A boolean that determines whether or not this emote requires the use of colons in chat to be used.
+        /// </returns>
         public bool RequireColons { get; }
+        /// <summary>
+        ///     Gets the roles that are allowed to use this emoji.
+        /// </summary>
+        /// <returns>
+        ///     A read-only list containing snowflake identifiers for roles that are allowed to use this emoji.
+        /// </returns>
         public IReadOnlyList<ulong> RoleIds { get; }
 
         internal GuildEmote(ulong id, string name, bool animated, bool isManaged, bool requireColons, IReadOnlyList<ulong> roleIds) : base(id, name, animated)
@@ -21,6 +39,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Name} ({Id})";
+        /// <summary>
+        ///     Gets the raw representation of the emote.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the raw presentation of the emote (e.g. <c>&lt;:thonkang:282745590985523200&gt;</c>).
+        /// </returns>
         public override string ToString() => $"<{(Animated ? "a" : "")}:{Name}:{Id}>";
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Emotes/IEmote.cs b/src/Discord.Net.Core/Entities/Emotes/IEmote.cs
index fac61402a..9141e8537 100644
--- a/src/Discord.Net.Core/Entities/Emotes/IEmote.cs
+++ b/src/Discord.Net.Core/Entities/Emotes/IEmote.cs
@@ -1,13 +1,16 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// A general container for any type of emote in a message.
+    ///     Represents a general container for any type of emote in a message.
     /// </summary>
     public interface IEmote
     {
         /// <summary>
-        /// The display name or unicode representation of this emote
+        ///     Gets the display name or Unicode representation of this emote.
         /// </summary>
+        /// <returns>
+        ///     A string representing the display name or the Unicode representation (e.g. <c>🤔</c>) of this emote.
+        /// </returns>
         string Name { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/DefaultMessageNotifications.cs b/src/Discord.Net.Core/Entities/Guilds/DefaultMessageNotifications.cs
index a5cabc117..ffcd28cee 100644
--- a/src/Discord.Net.Core/Entities/Guilds/DefaultMessageNotifications.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/DefaultMessageNotifications.cs
@@ -1,10 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the default message notification behavior the guild uses.
+    /// </summary>
     public enum DefaultMessageNotifications
     {
-        /// <summary> By default, all messages will trigger notifications. </summary>
+        /// <summary>
+        ///     By default, all messages will trigger notifications.
+        /// </summary>
         AllMessages = 0,
-        /// <summary> By default, only mentions will trigger notifications. </summary>
+        /// <summary>
+        ///     By default, only mentions will trigger notifications.
+        /// </summary>
         MentionsOnly = 1
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/GuildEmbedProperties.cs b/src/Discord.Net.Core/Entities/Guilds/GuildEmbedProperties.cs
index a2b2ec4fc..34473e93c 100644
--- a/src/Discord.Net.Core/Entities/Guilds/GuildEmbedProperties.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/GuildEmbedProperties.cs
@@ -1,20 +1,20 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify the widget of an IGuild with the specified parameters
+    ///     Provides properties that are used to modify the widget of an <see cref="IGuild" /> with the specified changes.
     /// </summary>
     public class GuildEmbedProperties
     {
         /// <summary>
-        /// Should the widget be enabled?
+        ///     Sets whether the widget should be enabled.
         /// </summary>
         public Optional<bool> Enabled { get; set; }
         /// <summary>
-        /// What channel should the invite place users in, if not null.
+        ///     Sets the channel that the invite should place its users in, if not <c>null</c>.
         /// </summary>
         public Optional<IChannel> Channel { get; set; }
         /// <summary>
-        /// What channel should the invite place users in, if not null.
+        ///     Sets the channel the invite should place its users in, if not <c>null</c>.
         /// </summary>
         public Optional<ulong?> ChannelId { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Guilds/GuildIntegrationProperties.cs b/src/Discord.Net.Core/Entities/Guilds/GuildIntegrationProperties.cs
index f329e78e6..2ca19b50a 100644
--- a/src/Discord.Net.Core/Entities/Guilds/GuildIntegrationProperties.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/GuildIntegrationProperties.cs
@@ -1,9 +1,21 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Provides properties used to modify an <see cref="IGuildIntegration" /> with the specified changes.
+    /// </summary>
     public class GuildIntegrationProperties
     {
+        /// <summary>
+        ///     Gets or sets the behavior when an integration subscription lapses.
+        /// </summary>
         public Optional<int> ExpireBehavior { get; set; }
+        /// <summary>
+        ///     Gets or sets the period (in seconds) where the integration will ignore lapsed subscriptions.
+        /// </summary>
         public Optional<int> ExpireGracePeriod { get; set; }
+        /// <summary>
+        ///     Gets or sets whether emoticons should be synced for this integration.
+        /// </summary>
         public Optional<bool> EnableEmoticons { get; set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
index 1b406ef7f..0ffe8db35 100644
--- a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
@@ -1,78 +1,69 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify an IGuild with the specified changes
+    ///     Provides properties that are used to modify an <see cref="IGuild" /> with the specified changes.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await Context.Guild.ModifyAsync(async x =>
-    /// {
-    ///     x.Name = "aaaaaah";
-    ///     x.RegionId = (await Context.Client.GetOptimalVoiceRegionAsync()).Id;
-    /// });
-    /// </code>
-    /// </example>
-    /// <see cref="IGuild"/>
+    /// <see cref="IGuild.ModifyAsync"/>
     public class GuildProperties
     {
-        public Optional<string> Username { get; set; }
         /// <summary>
-        /// The name of the Guild
+        ///     Gets or sets the name of the guild. Must be within 100 characters.
         /// </summary>
         public Optional<string> Name { get; set; }
         /// <summary>
-        /// The region for the Guild's voice connections
+        ///     Gets or sets the region for the guild's voice connections.
         /// </summary>
         public Optional<IVoiceRegion> Region { get; set; }
         /// <summary>
-        /// The ID of the region for the Guild's voice connections
+        ///     Gets or sets the ID of the region for the guild's voice connections.
         /// </summary>
         public Optional<string> RegionId { get; set; }
         /// <summary>
-        /// What verification level new users need to achieve before speaking
+        ///     Gets or sets the verification level new users need to achieve before speaking.
         /// </summary>
         public Optional<VerificationLevel> VerificationLevel { get; set; }
         /// <summary>
-        /// The default message notification state for the guild
+        ///     Gets or sets the default message notification state for the guild.
         /// </summary>
         public Optional<DefaultMessageNotifications> DefaultMessageNotifications { get; set; }
         /// <summary>
-        /// How many seconds before a user is sent to AFK. This value MUST be one of: (60, 300, 900, 1800, 3600).
+        ///     Gets or sets how many seconds before a user is sent to AFK. This value MUST be one of: (60, 300, 900,
+        ///     1800, 3600).
         /// </summary>
         public Optional<int> AfkTimeout { get; set; }
         /// <summary>
-        /// The icon of the guild
+        ///     Gets or sets the icon of the guild.
         /// </summary>
         public Optional<Image?> Icon { get; set; }
         /// <summary>
-        /// The guild's splash image
+        ///     Gets or sets the guild's splash image.
         /// </summary>
         /// <remarks>
-        /// The guild must be partnered for this value to have any effect.
+        ///     The guild must be partnered for this value to have any effect.
         /// </remarks>
         public Optional<Image?> Splash { get; set; }
         /// <summary>
-        /// The IVoiceChannel where AFK users should be sent.
+        ///     Gets or sets the <see cref="IVoiceChannel"/> where AFK users should be sent.
         /// </summary>
         public Optional<IVoiceChannel> AfkChannel { get; set; }
         /// <summary>
-        /// The ID of the IVoiceChannel where AFK users should be sent.
+        ///     Gets or sets the ID of the <see cref="IVoiceChannel"/> where AFK users should be sent.
         /// </summary>
         public Optional<ulong?> AfkChannelId { get; set; }
         /// <summary>
-        /// The ITextChannel where System messages should be sent.
+        ///     Gets or sets the <see cref="ITextChannel" /> where system messages should be sent.
         /// </summary>
         public Optional<ITextChannel> SystemChannel { get; set; }
         /// <summary>
-        /// The ID of the ITextChannel where System messages should be sent.
+        ///     Gets or sets the ID of the <see cref="ITextChannel" /> where system messages should be sent.
         /// </summary>
         public Optional<ulong?> SystemChannelId { get; set; }
         /// <summary>
-        /// The owner of this guild.
+        ///     Gets or sets the owner of this guild.
         /// </summary>
         public Optional<IUser> Owner { get; set; }
         /// <summary>
-        /// The ID of the owner of this guild.
+        ///     Gets or sets the ID of the owner of this guild.
         /// </summary>
         public Optional<ulong> OwnerId { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IBan.cs b/src/Discord.Net.Core/Entities/Guilds/IBan.cs
index 05ab0c00f..617f2fe04 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IBan.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IBan.cs
@@ -1,8 +1,23 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic ban object.
+    /// </summary>
     public interface IBan
     {
+        /// <summary>
+        ///     Gets the banned user.
+        /// </summary>
+        /// <returns>
+        ///     A user that was banned.
+        /// </returns>
         IUser User { get; }
+        /// <summary>
+        ///     Gets the reason why the user is banned if specified.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the reason behind the ban; <c>null</c> if none is specified.
+        /// </returns>
         string Reason { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
index bbe7051cb..8f9108d95 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
@@ -5,165 +5,668 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic guild/server.
+    /// </summary>
     public interface IGuild : IDeletable, ISnowflakeEntity
     {
-        /// <summary> Gets the name of this guild. </summary>
+        /// <summary>
+        ///     Gets the name of this guild.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this guild.
+        /// </returns>
         string Name { get; }
-        /// <summary> Gets the amount of time (in seconds) a user must be inactive in a voice channel for until they are automatically moved to the AFK voice channel, if one is set. </summary>
+        /// <summary>
+        ///     Gets the amount of time (in seconds) a user must be inactive in a voice channel for until they are
+        ///     automatically moved to the AFK voice channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the amount of time in seconds for a user to be marked as inactive
+        ///     and moved into the AFK voice channel.
+        /// </returns>
         int AFKTimeout { get; }
-        /// <summary> Returns true if this guild is embeddable (e.g. widget) </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this guild is embeddable (i.e. can use widget).
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this guild can be embedded via widgets; otherwise <c>false</c>.
+        /// </returns>
         bool IsEmbeddable { get; }
-        /// <summary> Gets the default message notifications for users who haven't explicitly set their notification settings. </summary>
+        /// <summary>
+        ///     Gets the default message notifications for users who haven't explicitly set their notification settings.
+        /// </summary>
         DefaultMessageNotifications DefaultMessageNotifications { get; }
-        /// <summary> Gets the level of mfa requirements a user must fulfill before being allowed to perform administrative actions in this guild. </summary>
+        /// <summary>
+        ///     Gets the level of Multi-Factor Authentication requirements a user must fulfill before being allowed to
+        ///     perform administrative actions in this guild.
+        /// </summary>
+        /// <returns>
+        ///     The level of MFA requirement.
+        /// </returns>
         MfaLevel MfaLevel { get; }
-        /// <summary> Gets the level of requirements a user must fulfill before being allowed to post messages in this guild. </summary>
+        /// <summary>
+        ///     Gets the level of requirements a user must fulfill before being allowed to post messages in this guild.
+        /// </summary>
+        /// <returns>
+        ///     The level of requirements.
+        /// </returns>
         VerificationLevel VerificationLevel { get; }
-        /// <summary> Returns the id of this guild's icon, or null if one is not set. </summary>
+        /// <summary>
+        ///     Gets the ID of this guild's icon.
+        /// </summary>
+        /// <returns>
+        ///     An identifier for the splash image; <c>null</c> if none is set.
+        /// </returns>
         string IconId { get; }
-        /// <summary> Returns the url to this guild's icon, or null if one is not set. </summary>
+        /// <summary>
+        ///     Gets the URL of this guild's icon.
+        /// </summary>
+        /// <returns>
+        ///     A URL pointing to the guild's icon; <c>null</c> if none is set.
+        /// </returns>
         string IconUrl { get; }
-        /// <summary> Returns the id of this guild's splash image, or null if one is not set. </summary>
+        /// <summary>
+        ///     Gets the ID of this guild's splash image.
+        /// </summary>
+        /// <returns>
+        ///     An identifier for the splash image; <c>null</c> if none is set.
+        /// </returns>
         string SplashId { get; }
-        /// <summary> Returns the url to this guild's splash image, or null if one is not set. </summary>
+        /// <summary>
+        ///     Gets the URL of this guild's splash image.
+        /// </summary>
+        /// <returns>
+        ///     A URL pointing to the guild's splash image; <c>null</c> if none is set.
+        /// </returns>
         string SplashUrl { get; }
-        /// <summary> Returns true if this guild is currently connected and ready to be used. Only applies to the WebSocket client. </summary>
+        /// <summary>
+        ///     Determines if this guild is currently connected and ready to be used.
+        /// </summary>
+        /// <remarks>
+        ///     <note>
+        ///         This property only applies to a WebSocket-based client.
+        ///     </note>
+        ///     This boolean is used to determine if the guild is currently connected to the WebSocket and is ready to be used/accessed.
+        /// </remarks>
+        /// <returns>
+        ///     <c>true</c> if this guild is currently connected and ready to be used; otherwise <c>false</c>.
+        /// </returns>
         bool Available { get; }
 
-        /// <summary> Gets the id of the AFK voice channel for this guild if set, or null if not. </summary>
+        /// <summary>
+        ///     Gets the ID of the AFK voice channel for this guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the AFK voice channel; <c>null</c> if
+        ///     none is set.
+        /// </returns>
         ulong? AFKChannelId { get; }
-        /// <summary> Gets the id of the the default channel for this guild. </summary>
+        /// <summary>
+        ///     Gets the ID of the default channel for this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This property retrieves the snowflake identifier of the first viewable text channel for this guild.
+        ///     <note type="warning">
+        ///         This channel does not guarantee the user can send message to it, as it only looks for the first viewable
+        ///         text channel.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the default text channel; <c>0</c> if
+        ///     none can be found.
+        /// </returns>
         ulong DefaultChannelId { get; }
-        /// <summary> Gets the id of the embed channel for this guild if set, or null if not. </summary>
+        /// <summary>
+        ///     Gets the ID of the widget embed channel of this guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the embedded channel found within the
+        ///     widget settings of this guild; <c>null</c> if none is set.
+        /// </returns>
         ulong? EmbedChannelId { get; }
-        /// <summary> Gets the id of the channel where randomized welcome messages are sent, or null if not. </summary>
+        /// <summary>
+        ///     Gets the ID of the channel where randomized welcome messages are sent.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the system channel where randomized
+        ///     welcome messages are sent; <c>null</c> if none is set.
+        /// </returns>
         ulong? SystemChannelId { get; }
-        /// <summary> Gets the id of the user that created this guild. </summary>
+        /// <summary>
+        ///     Gets the ID of the user that owns this guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the user that owns this guild.
+        /// </returns>
         ulong OwnerId { get; }
-        /// <summary> Gets the id of the region hosting this guild's voice channels. </summary>
+        /// <summary>
+        ///     Gets the ID of the region hosting this guild's voice channels.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the identifier for the voice region that this guild uses (e.g. <c>eu-central</c>).
+        /// </returns>
         string VoiceRegionId { get; }
-        /// <summary> Gets the IAudioClient currently associated with this guild. </summary>
+        /// <summary>
+        ///     Gets the <see cref="IAudioClient"/> currently associated with this guild.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="IAudioClient"/> currently associated with this guild.
+        /// </returns>
         IAudioClient AudioClient { get; }
-        /// <summary> Gets the built-in role containing all users in this guild. </summary>
+        /// <summary>
+        ///     Gets the built-in role containing all users in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A role object that represents an <c>@everyone</c> role in this guild.
+        /// </returns>
         IRole EveryoneRole { get; }
-        /// <summary> Gets a collection of all custom emojis for this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all custom emotes for this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of all custom emotes for this guild.
+        /// </returns>
         IReadOnlyCollection<GuildEmote> Emotes { get; }
-        /// <summary> Gets a collection of all extra features added to this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all extra features added to this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of enabled features in this guild.
+        /// </returns>
         IReadOnlyCollection<string> Features { get; }
-        /// <summary> Gets a collection of all roles in this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all roles in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of roles found within this guild.
+        /// </returns>
         IReadOnlyCollection<IRole> Roles { get; }
 
-        /// <summary> Modifies this guild. </summary>
+        /// <summary>
+        ///     Modifies this guild.
+        /// </summary>
+        /// <param name="func">The delegate containing the properties to modify the guild with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
         Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null);
-        /// <summary> Modifies this guild's embed. </summary>
+        /// <summary>
+        ///     Modifies this guild's embed channel.
+        /// </summary>
+        /// <param name="func">The delegate containing the properties to modify the guild widget with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
         Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null);
-        /// <summary> Bulk modifies the channels of this guild. </summary>
+        /// <summary>
+        ///     Bulk-modifies the order of channels in this guild.
+        /// </summary>
+        /// <param name="args">The properties used to modify the channel positions with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous reorder operation.
+        /// </returns>
         Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null);
-        /// <summary> Bulk modifies the roles of this guild. </summary>
+        /// <summary>
+        ///     Bulk-modifies the order of roles in this guild.
+        /// </summary>
+        /// <param name="args">The properties used to modify the role positions with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous reorder operation.
+        /// </returns>
         Task ReorderRolesAsync(IEnumerable<ReorderRoleProperties> args, RequestOptions options = null);
-        /// <summary> Leaves this guild. If you are the owner, use Delete instead. </summary>
+        /// <summary>
+        ///     Leaves this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method will make the currently logged-in user leave the guild.
+        ///     <note>
+        ///         If the user is the owner of this guild, use <see cref="IDeletable.DeleteAsync"/> instead.
+        ///     </note>
+        /// </remarks>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous leave operation.
+        /// </returns>
         Task LeaveAsync(RequestOptions options = null);
 
-        /// <summary> Gets a collection of all users banned on this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all users banned in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     ban objects that this guild currently possesses, with each object containing the user banned and reason
+        ///     behind the ban.
+        /// </returns>
         Task<IReadOnlyCollection<IBan>> GetBansAsync(RequestOptions options = null);
         /// <summary>
         ///     Gets a ban object for a banned user.
         /// </summary>
         /// <param name="user">The banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
-        ///     An awaitable <see cref="Task"/> containing the ban object, which contains the user information and the
-        ///     reason for the ban; <see langword="null"/> if the ban entry cannot be found.
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
         /// </returns>
         Task<IBan> GetBanAsync(IUser user, RequestOptions options = null);
         /// <summary>
         ///     Gets a ban object for a banned user.
         /// </summary>
         /// <param name="userId">The snowflake identifier for the banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
-        ///     An awaitable <see cref="Task"/> containing the ban object, which contains the user information and the
-        ///     reason for the ban; <see langword="null"/> if the ban entry cannot be found.
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
         /// </returns>
         Task<IBan> GetBanAsync(ulong userId, RequestOptions options = null);
-        /// <summary> Bans the provided user from this guild and optionally prunes their recent messages. </summary>
-        /// <param name="pruneDays">The number of days to remove messages from this user for - must be between [0, 7]</param>
+        /// <summary>
+        ///     Bans the user from this guild and optionally prunes their recent messages.
+        /// </summary>
+        /// <param name="user">The user to ban.</param>
+        /// <param name="pruneDays">The number of days to remove messages from this user for, and this number must be between [0, 7].</param>
+        /// <param name="reason">The reason of the ban to be written in the audit log.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentException"><paramref name="pruneDays"/> is not between 0 to 7.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous add operation for the ban.
+        /// </returns>
         Task AddBanAsync(IUser user, int pruneDays = 0, string reason = null, RequestOptions options = null);
-        /// <summary> Bans the provided user id from this guild and optionally prunes their recent messages. </summary>
-        /// <param name="pruneDays">The number of days to remove messages from this user for - must be between [0, 7]</param>
+        /// <summary>
+        ///     Bans the user from this guild and optionally prunes their recent messages.
+        /// </summary>
+        /// <param name="userId">The snowflake ID of the user to ban.</param>
+        /// <param name="pruneDays">The number of days to remove messages from this user for, and this number must be between [0, 7].</param>
+        /// <param name="reason">The reason of the ban to be written in the audit log.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentException"><paramref name="pruneDays"/> is not between 0 to 7.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous add operation for the ban.
+        /// </returns>
         Task AddBanAsync(ulong userId, int pruneDays = 0, string reason = null, RequestOptions options = null);
-        /// <summary> Unbans the provided user if it is currently banned. </summary>
+        /// <summary>
+        ///     Unbans the user if they are currently banned.
+        /// </summary>
+        /// <param name="user">The user to be unbanned.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation for the ban.
+        /// </returns>
         Task RemoveBanAsync(IUser user, RequestOptions options = null);
-        /// <summary> Unbans the provided user id if it is currently banned. </summary>
+        /// <summary>
+        ///     Unbans the user if they are currently banned.
+        /// </summary>
+        /// <param name="userId">The snowflake identifier of the user to be unbanned.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation for the ban.
+        /// </returns>
         Task RemoveBanAsync(ulong userId, RequestOptions options = null);
 
-        /// <summary> Gets a collection of all channels in this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all channels in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     generic channels found within this guild.
+        /// </returns>
         Task<IReadOnlyCollection<IGuildChannel>> GetChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets the channel in this guild with the provided id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the channel.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the generic channel
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<IGuildChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of all text channels in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     message channels found within this guild.
+        /// </returns>
         Task<IReadOnlyCollection<ITextChannel>> GetTextChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a text channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the text channel.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the text channel
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<ITextChannel> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of all voice channels in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     voice channels found within this guild.
+        /// </returns>
         Task<IReadOnlyCollection<IVoiceChannel>> GetVoiceChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of all category channels in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     category channels found within this guild.
+        /// </returns>
         Task<IReadOnlyCollection<ICategoryChannel>> GetCategoriesAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a voice channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the voice channel.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the voice channel associated
+        ///     with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<IVoiceChannel> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets the AFK voice channel in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the voice channel that the
+        ///     AFK users will be moved to after they have idled for too long; <c>null</c> if none is set.
+        /// </returns>
         Task<IVoiceChannel> GetAFKChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets the system channel where randomized welcome messages are sent in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the text channel where
+        ///     randomized welcome messages will be sent to; <c>null</c> if none is set.
+        /// </returns>
         Task<ITextChannel> GetSystemChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets the first viewable text channel in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the first viewable text
+        ///     channel in this guild; <c>null</c> if none is found.
+        /// </returns>
         Task<ITextChannel> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets the embed channel (i.e. the channel set in the guild's widget settings) in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the embed channel set
+        ///     within the server's widget settings; <c>null</c> if none is set.
+        /// </returns>
         Task<IGuildChannel> GetEmbedChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Creates a new text channel. </summary>
+
+        /// <summary>
+        ///     Creates a new text channel in this guild.
+        /// </summary>
+        /// <example>
+        ///     The following example creates a new text channel under an existing category named <c>Wumpus</c> with a set topic.
+        ///     <code lang="cs">
+        ///     var categories = await guild.GetCategoriesAsync();
+        ///     var targetCategory = categories.FirstOrDefault(x => x.Name == "wumpus");
+        ///     if (targetCategory == null) return;
+        ///     await Context.Guild.CreateTextChannelAsync(name, x =>
+        ///     {
+        ///         x.CategoryId = targetCategory.Id;
+        ///         x.Topic = $"This channel was created at {DateTimeOffset.UtcNow} by {user}.";
+        ///     });
+        ///     </code>
+        /// </example>
+        /// <param name="name">The new name for the text channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     text channel.
+        /// </returns>
         Task<ITextChannel> CreateTextChannelAsync(string name, Action<TextChannelProperties> func = null, RequestOptions options = null);
-        /// <summary> Creates a new voice channel. </summary>
+        /// <summary>
+        ///     Creates a new voice channel in this guild.
+        /// </summary>
+        /// <param name="name">The new name for the voice channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     voice channel.
+        /// </returns>
         Task<IVoiceChannel> CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func = null, RequestOptions options = null);
-        /// <summary> Creates a new channel category. </summary>
+        /// <summary>
+        ///     Creates a new channel category in this guild.
+        /// </summary>
+        /// <param name="name">The new name for the category.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     category channel.
+        /// </returns>
         Task<ICategoryChannel> CreateCategoryAsync(string name, RequestOptions options = null);
 
         Task<IReadOnlyCollection<IGuildIntegration>> GetIntegrationsAsync(RequestOptions options = null);
         Task<IGuildIntegration> CreateIntegrationAsync(ulong id, string type, RequestOptions options = null);
 
-        /// <summary> Gets a collection of all invites to this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all invites in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     invite metadata, each representing information for an invite found within this guild.
+        /// </returns>
         Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null);
         /// <summary>
         ///     Gets the vanity invite URL of this guild.
         /// </summary>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
-        ///     An awaitable <see cref="Task"/> containing the partial metadata of the vanity invite found within
-        ///     this guild.
+        ///     A task that represents the asynchronous get operation. The task result contains the partial metadata of
+        ///     the vanity invite found within this guild; <c>null</c> if none is found.
         /// </returns>
         Task<IInviteMetadata> GetVanityInviteAsync(RequestOptions options = null);
 
-        /// <summary> Gets the role in this guild with the provided id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a role in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the role.</param>
+        /// <returns>
+        ///     A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         IRole GetRole(ulong id);
-        /// <summary> Creates a new role. </summary>
+        /// <summary>
+        ///     Creates a new role with the provided name.
+        /// </summary>
+        /// <param name="name">The new name for the role.</param>
+        /// <param name="permissions">The guild permission that the role should possess.</param>
+        /// <param name="color">The color of the role.</param>
+        /// <param name="isHoisted">Whether the role is separated from others on the sidebar.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     role.
+        /// </returns>
         Task<IRole> CreateRoleAsync(string name, GuildPermissions? permissions = null, Color? color = null, bool isHoisted = false, RequestOptions options = null);
 
-        /// <summary> Gets a collection of all users in this guild. </summary>
-        Task<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); //TODO: shouldnt this be paged?
-        /// <summary> Gets the user in this guild with the provided id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a collection of all users in this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method retrieves all users found within this guild.
+        ///     <note>
+        ///         This may return an incomplete collection in the WebSocket implementation due to how Discord does not
+        ///         send a complete user list for large guilds.
+        ///     </note>
+        /// </remarks>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a collection of guild
+        ///     users found within this guild.
+        /// </returns>
+        Task<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a user from this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method retrieves a user found within this guild.
+        ///     <note>
+        ///         This may return <c>null</c> in the WebSocket implementation due to incomplete user collection in
+        ///         large guilds.
+        ///     </note>
+        /// </remarks>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the guild user
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets the current user for this guild. </summary>
+        /// <summary>
+        ///     Gets the current user for this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the currently logged-in
+        ///     user within this guild.
+        /// </returns>
         Task<IGuildUser> GetCurrentUserAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Gets the owner of this guild. </summary>
+        /// <summary>
+        ///     Gets the owner of this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the owner of this guild.
+        /// </returns>
         Task<IGuildUser> GetOwnerAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-        /// <summary> Downloads all users for this guild if the current list is incomplete. </summary>
+        /// <summary>
+        ///     Downloads all users for this guild if the current list is incomplete.
+        /// </summary>
+        /// <returns>
+        ///     A task that represents the asynchronous download operation.
+        /// </returns>
         Task DownloadUsersAsync();
-        /// <summary> Removes all users from this guild if they have not logged on in a provided number of days or, if simulate is true, returns the number of users that would be removed. </summary>
+        /// <summary>
+        ///     Prunes inactive users.
+        /// </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This method removes all users that have not logged on in the provided number of <paramref name="days"/>.
+        ///     </para>
+        ///     <para>
+        ///         If <paramref name="simulate" /> is <c>true</c>, this method will only return the number of users that
+        ///         would be removed without kicking the users.
+        ///     </para>
+        /// </remarks>
+        /// <param name="days">The number of days required for the users to be kicked.</param>
+        /// <param name="simulate">Whether this prune action is a simulation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous prune operation. The task result contains the number of users to
+        ///     be or has been removed from this guild.
+        /// </returns>
         Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null);
 
-        /// <summary> Gets the specified number of audit log entries for this guild. </summary>
+        /// <summary>
+        ///     Gets the specified number of audit log entries for this guild.
+        /// </summary>
+        /// <param name="limit">The number of audit log entries to fetch.</param>
+        /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of the requested audit log entries.
+        /// </returns>
         Task<IReadOnlyCollection<IAuditLogEntry>> GetAuditLogsAsync(int limit = DiscordConfig.MaxAuditLogEntriesPerBatch,
             CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
 
-        /// <summary> Gets the webhook in this guild with the provided id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a webhook found within this guild.
+        /// </summary>
+        /// <param name="id">The identifier for the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the webhook with the
+        ///     specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null);
-        /// <summary> Gets a collection of all webhooks for this guild. </summary>
+        /// <summary>
+        ///     Gets a collection of all webhook from this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks found within the guild.
+        /// </returns>
         Task<IReadOnlyCollection<IWebhook>> GetWebhooksAsync(RequestOptions options = null);
-        
-        /// <summary> Gets a specific emote from this guild. </summary>
+
+        /// <summary>
+        ///     Gets a specific emote from this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the guild emote.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the emote found with the
+        ///     specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null);
-        /// <summary> Creates a new emote in this guild. </summary>
+        /// <summary>
+        ///     Creates a new <see cref="GuildEmote"/> in this guild.
+        /// </summary>
+        /// <param name="name">The name of the guild emote.</param>
+        /// <param name="image">The image of the new emote.</param>
+        /// <param name="roles">The roles to limit the emote usage to.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the created emote.
+        /// </returns>
         Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null);
-        /// <summary> Modifies an existing emote in this guild. </summary>
+
+        /// <summary>
+        ///     Modifies an existing <see cref="GuildEmote"/> in this guild.
+        /// </summary>
+        /// <param name="emote">The emote to be modified.</param>
+        /// <param name="func">The delegate containing the properties to modify the emote with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation. The task result contains the modified
+        ///     emote.
+        /// </returns>
         Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null);
-        /// <summary> Deletes an existing emote from this guild. </summary>
+        /// <summary>
+        ///     Deletes an existing <see cref="GuildEmote"/> from this guild.
+        /// </summary>
+        /// <param name="emote">The emote to delete.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation.
+        /// </returns>
         Task DeleteEmoteAsync(GuildEmote emote, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuildIntegration.cs b/src/Discord.Net.Core/Entities/Guilds/IGuildIntegration.cs
index 225ce05d6..6fe3f7b55 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuildIntegration.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuildIntegration.cs
@@ -1,17 +1,69 @@
-using System;
+using System;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Holds information for a guild integration feature.
+    /// </summary>
     public interface IGuildIntegration
     {
+        /// <summary>
+        ///     Gets the integration ID.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="UInt64"/> representing the unique identifier value of this integration.
+        /// </returns>
         ulong Id { get; }
+        /// <summary>
+        ///     Gets the integration name.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this integration.
+        /// </returns>
         string Name { get; }
+        /// <summary>
+        ///     Gets the integration type (Twitch, YouTube, etc).
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the type of integration.
+        /// </returns>
         string Type { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this integration is enabled or not.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this integration is enabled; otherwise <c>false</c>.
+        /// </returns>
         bool IsEnabled { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this integration is syncing or not.
+        /// </summary>
+        /// <remarks>
+        ///     An integration with syncing enabled will update its "subscribers" on an interval, while one with syncing
+        ///     disabled will not. A user must manually choose when sync the integration if syncing is disabled.
+        /// </remarks>
+        /// <returns>
+        ///      <c>true</c> if this integration is syncing; otherwise <c>false</c>.
+        /// </returns>
         bool IsSyncing { get; }
+        /// <summary>
+        ///     Gets the ID that this integration uses for "subscribers".
+        /// </summary>
         ulong ExpireBehavior { get; }
+        /// <summary>
+        ///     Gets the grace period before expiring "subscribers".
+        /// </summary>
         ulong ExpireGracePeriod { get; }
+        /// <summary>
+        ///     Gets when this integration was last synced.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset"/> containing a date and time of day when the integration was last synced.
+        /// </returns>
         DateTimeOffset SyncedAt { get; }
+        /// <summary>
+        ///     Gets integration account information.
+        /// </summary>
         IntegrationAccount Account { get; }
 
         IGuild Guild { get; }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IUserGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IUserGuild.cs
index b27db9377..b6685edf6 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IUserGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IUserGuild.cs
@@ -1,14 +1,22 @@
-namespace Discord
+namespace Discord
 {
     public interface IUserGuild : IDeletable, ISnowflakeEntity
     {
-        /// <summary> Gets the name of this guild. </summary>
+        /// <summary>
+        ///     Gets the name of this guild.
+        /// </summary>
         string Name { get; }
-        /// <summary> Returns the url to this guild's icon, or null if one is not set. </summary>
+        /// <summary>
+        ///     Gets the icon URL associated with this guild, or <c>null</c> if one is not set.
+        /// </summary>
         string IconUrl { get; }
-        /// <summary> Returns true if the current user owns this guild. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if the current user owns this guild.
+        /// </summary>
         bool IsOwner { get; }
-        /// <summary> Returns the current user's permissions for this guild. </summary>
+        /// <summary>
+        ///     Returns the current user's permissions for this guild.
+        /// </summary>
         GuildPermissions Permissions { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IVoiceRegion.cs b/src/Discord.Net.Core/Entities/Guilds/IVoiceRegion.cs
index 67bedbc3d..9cef84914 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IVoiceRegion.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IVoiceRegion.cs
@@ -1,18 +1,51 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a region of which the user connects to when using voice.
+    /// </summary>
     public interface IVoiceRegion
     {
-        /// <summary> Gets the unique identifier for this voice region. </summary>
+        /// <summary>
+        ///     Gets the unique identifier for this voice region.
+        /// </summary>
+        /// <returns>
+        ///     A string that represents the identifier for this voice region (e.g. <c>eu-central</c>).
+        /// </returns>
         string Id { get; }
-        /// <summary> Gets the name of this voice region. </summary>
+        /// <summary>
+        ///     Gets the name of this voice region.
+        /// </summary>
+        /// <returns>
+        ///     A string that represents the human-readable name of this voice region (e.g. <c>Central Europe</c>).
+        /// </returns>
         string Name { get; }
-        /// <summary> Returns true if this voice region is exclusive to VIP accounts. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether or not this voice region is exclusive to partnered servers.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this voice region is exclusive to VIP accounts; otherwise <c>false</c>.
+        /// </returns>
         bool IsVip { get; }
-        /// <summary> Returns true if this voice region is the closest to your machine. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this voice region is optimal for your client in terms of latency.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this voice region is the closest to your machine; otherwise <c>false</c> .
+        /// </returns>
         bool IsOptimal { get; }
-        /// <summary> Returns true if this is a deprecated voice region (avoid switching to these). </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this voice region is no longer being maintained.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this is a deprecated voice region; otherwise <c>false</c>.
+        /// </returns>
         bool IsDeprecated { get; }
-        /// <summary> Returns true if this is a custom voice region (used for events/etc) </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this voice region is custom-made for events.
+        /// </summary>
+        /// <returns> 
+        ///     <c>true</c> if this is a custom voice region (used for events/etc); otherwise <c>false</c>/
+        /// </returns>
         bool IsCustom { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IntegrationAccount.cs b/src/Discord.Net.Core/Entities/Guilds/IntegrationAccount.cs
index 71bcf10ed..340115fde 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IntegrationAccount.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IntegrationAccount.cs
@@ -1,11 +1,15 @@
-using System.Diagnostics;
+using System.Diagnostics;
 
 namespace Discord
 {
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct IntegrationAccount
     {
+        /// <summary> Gets the ID of the account. </summary>
+        /// <returns> A <see cref="string"/> unique identifier of this integration account. </returns>
         public string Id { get; }
+        /// <summary> Gets the name of the account. </summary>
+        /// <returns> A string containing the name of this integration account. </returns>
         public string Name { get; private set; }
 
         public override string ToString() => Name;
diff --git a/src/Discord.Net.Core/Entities/Guilds/MfaLevel.cs b/src/Discord.Net.Core/Entities/Guilds/MfaLevel.cs
index 1dfef17d5..57edac2b0 100644
--- a/src/Discord.Net.Core/Entities/Guilds/MfaLevel.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/MfaLevel.cs
@@ -1,10 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the guild's Multi-Factor Authentication (MFA) level requirement.
+    /// </summary>
     public enum MfaLevel
     {
-        /// <summary> Users have no additional MFA restriction on this guild. </summary>
+        /// <summary>
+        ///     Users have no additional MFA restriction on this guild.
+        /// </summary>
         Disabled = 0,
-        /// <summary> Users must have MFA enabled on their account to perform administrative actions. </summary>
+        /// <summary>
+        ///     Users must have MFA enabled on their account to perform administrative actions.
+        /// </summary>
         Enabled = 1
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/PermissionTarget.cs b/src/Discord.Net.Core/Entities/Guilds/PermissionTarget.cs
index 96595fb69..3da2fb147 100644
--- a/src/Discord.Net.Core/Entities/Guilds/PermissionTarget.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/PermissionTarget.cs
@@ -1,8 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the target of the permission.
+    /// </summary>
     public enum PermissionTarget
     {
+        /// <summary>
+        ///     The target of the permission is a role.
+        /// </summary>
         Role,
+        /// <summary>
+        ///     The target of the permission is a user.
+        /// </summary>
         User
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/VerificationLevel.cs b/src/Discord.Net.Core/Entities/Guilds/VerificationLevel.cs
index ac51fe927..3a5ae0468 100644
--- a/src/Discord.Net.Core/Entities/Guilds/VerificationLevel.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/VerificationLevel.cs
@@ -1,16 +1,29 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the verification level the guild uses.
+    /// </summary>
     public enum VerificationLevel
     {
-        /// <summary> Users have no additional restrictions on sending messages to this guild. </summary>
+        /// <summary>
+        ///     Users have no additional restrictions on sending messages to this guild.
+        /// </summary>
         None = 0,
-        /// <summary> Users must have a verified email on their account. </summary>
+        /// <summary>
+        ///     Users must have a verified email on their account.
+        /// </summary>
         Low = 1,
-        /// <summary> Users must fulfill the requirements of Low, and be registered on Discord for at least 5 minutes. </summary>
+        /// <summary>
+        ///     Users must fulfill the requirements of Low and be registered on Discord for at least 5 minutes.
+        /// </summary>
         Medium = 2,
-        /// <summary> Users must fulfill the requirements of Medium, and be a member of this guild for at least 10 minutes. </summary>
+        /// <summary>
+        ///     Users must fulfill the requirements of Medium and be a member of this guild for at least 10 minutes.
+        /// </summary>
         High = 3,
-        /// <summary> Users must fulfill the requirements of High, and must have a verified phone on their Discord account. </summary>
+        /// <summary>
+        ///     Users must fulfill the requirements of High and must have a verified phone on their Discord account.
+        /// </summary>
         Extreme = 4
     }
 }
diff --git a/src/Discord.Net.Core/Entities/IApplication.cs b/src/Discord.Net.Core/Entities/IApplication.cs
index 4fb1e4b91..78a87dc19 100644
--- a/src/Discord.Net.Core/Entities/IApplication.cs
+++ b/src/Discord.Net.Core/Entities/IApplication.cs
@@ -1,13 +1,31 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a Discord application created via the developer portal.
+    /// </summary>
     public interface IApplication : ISnowflakeEntity
     {
+        /// <summary>
+        ///     Gets the name of the application.
+        /// </summary>
         string Name { get; }
+        /// <summary>
+        ///     Gets the description of the application.
+        /// </summary>
         string Description { get; }
+        /// <summary>
+        ///     Gets the RPC origins of the application.
+        /// </summary>
         string[] RPCOrigins { get; }
         ulong Flags { get; }
+        /// <summary>
+        ///     Gets the icon URL of the application.
+        /// </summary>
         string IconUrl  { get; }
 
+        /// <summary>
+        ///     Gets the partial user object containing info on the owner of the application.
+        /// </summary>
         IUser Owner { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/IDeletable.cs b/src/Discord.Net.Core/Entities/IDeletable.cs
index ba22a537a..9696eb838 100644
--- a/src/Discord.Net.Core/Entities/IDeletable.cs
+++ b/src/Discord.Net.Core/Entities/IDeletable.cs
@@ -1,10 +1,16 @@
-using System.Threading.Tasks;
+using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Determines whether the object is deletable or not.
+    /// </summary>
     public interface IDeletable
     {
-        /// <summary> Deletes this object and all its children. </summary>
+        /// <summary>
+        ///     Deletes this object and all its children.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
         Task DeleteAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/IEntity.cs b/src/Discord.Net.Core/Entities/IEntity.cs
index 711fd0555..0cd692a41 100644
--- a/src/Discord.Net.Core/Entities/IEntity.cs
+++ b/src/Discord.Net.Core/Entities/IEntity.cs
@@ -8,7 +8,9 @@ namespace Discord
         ///// <summary> Gets the IDiscordClient that created this object. </summary>
         //IDiscordClient Discord { get; }
 
-        /// <summary> Gets the unique identifier for this object. </summary>
+        /// <summary>
+        ///     Gets the unique identifier for this object.
+        /// </summary>
         TId Id { get; }
 
     }
diff --git a/src/Discord.Net.Core/Entities/IMentionable.cs b/src/Discord.Net.Core/Entities/IMentionable.cs
index abccc4480..225806723 100644
--- a/src/Discord.Net.Core/Entities/IMentionable.cs
+++ b/src/Discord.Net.Core/Entities/IMentionable.cs
@@ -1,8 +1,16 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Determines whether the object is mentionable or not.
+    /// </summary>
     public interface IMentionable
     {
-        /// <summary> Returns a special string used to mention this object.  </summary>
+        /// <summary>
+        ///     Returns a special string used to mention this object.
+        /// </summary>
+        /// <returns>
+        ///     A string that is recognized by Discord as a mention (e.g. &lt;@168693960628371456&gt;).
+        /// </returns>
         string Mention { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/ISnowflakeEntity.cs b/src/Discord.Net.Core/Entities/ISnowflakeEntity.cs
index 5b099b5ac..6f2c7512b 100644
--- a/src/Discord.Net.Core/Entities/ISnowflakeEntity.cs
+++ b/src/Discord.Net.Core/Entities/ISnowflakeEntity.cs
@@ -2,8 +2,15 @@ using System;
 
 namespace Discord
 {
+    /// <summary> Represents a Discord snowflake entity. </summary>
     public interface ISnowflakeEntity : IEntity<ulong>
     {
+        /// <summary>
+        ///     Gets when the snowflake was created.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset"/> representing when the entity was first created.
+        /// </returns>
         DateTimeOffset CreatedAt { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/IUpdateable.cs b/src/Discord.Net.Core/Entities/IUpdateable.cs
index b0f51aee7..3ae4613f5 100644
--- a/src/Discord.Net.Core/Entities/IUpdateable.cs
+++ b/src/Discord.Net.Core/Entities/IUpdateable.cs
@@ -1,10 +1,15 @@
-using System.Threading.Tasks;
+using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Defines whether the object is updateable or not.
+    /// </summary>
     public interface IUpdateable
     {
-        /// <summary> Updates this object's properties with its current state. </summary>
+        /// <summary>
+        ///     Updates this object's properties with its current state.
+        /// </summary>
         Task UpdateAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Image.cs b/src/Discord.Net.Core/Entities/Image.cs
index 3b946ce80..d5a9e26a3 100644
--- a/src/Discord.Net.Core/Entities/Image.cs
+++ b/src/Discord.Net.Core/Entities/Image.cs
@@ -2,27 +2,54 @@ using System.IO;
 namespace Discord
 {
     /// <summary>
-    /// An image that will be uploaded to Discord.
+    ///     An image that will be uploaded to Discord.
     /// </summary>
     public struct Image
     {
+        /// <summary>
+        ///     Gets the stream to be uploaded to Discord.
+        /// </summary>
         public Stream Stream { get; }
         /// <summary>
-        /// Create the image with a Stream.
+        ///     Create the image with a <see cref="System.IO.Stream"/>.
         /// </summary>
-        /// <param name="stream">This must be some type of stream with the contents of a file in it.</param>
+        /// <param name="stream">
+        ///     The <see cref="System.IO.Stream" /> to create the image with. Note that this must be some type of stream
+        ///     with the contents of a file in it.
+        /// </param>
         public Image(Stream stream)
         {
             Stream = stream;
         }
 
         /// <summary>
-        /// Create the image from a file path.
+        ///     Create the image from a file path.
         /// </summary>
         /// <remarks>
-        /// This file path is NOT validated, and is passed directly into a <see cref="File.OpenRead(string)"/>
+        ///     This file path is NOT validated and is passed directly into a
+        ///     <see cref="File.OpenRead"/>.
         /// </remarks>
         /// <param name="path">The path to the file.</param>
+        /// <exception cref="System.ArgumentException">
+        /// <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid
+        /// characters as defined by <see cref="Path.GetInvalidPathChars"/>.
+        /// </exception>
+        /// <exception cref="System.ArgumentNullException"><paramref name="path" /> is <c>null</c>.</exception>
+        /// <exception cref="PathTooLongException">
+        /// The specified path, file name, or both exceed the system-defined maximum length. For example, on
+        /// Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260
+        /// characters.
+        /// </exception>
+        /// <exception cref="System.NotSupportedException"><paramref name="path" /> is in an invalid format.</exception>
+        /// <exception cref="DirectoryNotFoundException">
+        /// The specified <paramref name="path"/> is invalid, (for example, it is on an unmapped drive).
+        /// </exception>
+        /// <exception cref="System.UnauthorizedAccessException">
+        /// <paramref name="path" /> specified a directory.-or- The caller does not have the required permission. 
+        /// </exception>
+        /// <exception cref="FileNotFoundException">The file specified in <paramref name="path" /> was not found. 
+        /// </exception>
+        /// <exception cref="IOException">An I/O error occurred while opening the file. </exception>
         public Image(string path)
         {
             Stream = File.OpenRead(path);
diff --git a/src/Discord.Net.Core/Entities/ImageFormat.cs b/src/Discord.Net.Core/Entities/ImageFormat.cs
index 302da79c8..9c04328f4 100644
--- a/src/Discord.Net.Core/Entities/ImageFormat.cs
+++ b/src/Discord.Net.Core/Entities/ImageFormat.cs
@@ -1,11 +1,29 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the type of format the image should return in.
+    /// </summary>
     public enum ImageFormat
     {
+        /// <summary>
+        ///     Use automatically detected format.
+        /// </summary>
         Auto,
+        /// <summary>
+        ///     Use Google's WebP image format.
+        /// </summary>
         WebP,
+        /// <summary>
+        ///     Use PNG.
+        /// </summary>
         Png,
+        /// <summary>
+        ///     Use JPEG.
+        /// </summary>
         Jpeg,
+        /// <summary>
+        ///     Use GIF.
+        /// </summary>
         Gif,
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Invites/IInvite.cs b/src/Discord.Net.Core/Entities/Invites/IInvite.cs
index 1ab26de8f..6455b9f5c 100644
--- a/src/Discord.Net.Core/Entities/Invites/IInvite.cs
+++ b/src/Discord.Net.Core/Entities/Invites/IInvite.cs
@@ -1,30 +1,85 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic invite object.
+    /// </summary>
     public interface IInvite : IEntity<string>, IDeletable
     {
-        /// <summary> Gets the unique identifier for this invite. </summary>
+        /// <summary>
+        ///     Gets the unique identifier for this invite.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the invite code (e.g. <c>FTqNnyS</c>).
+        /// </returns>
         string Code { get; }
-        /// <summary> Gets the url used to accept this invite, using Code. </summary>
+        /// <summary>
+        ///     Gets the URL used to accept this invite using <see cref="Code"/>.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the full invite URL (e.g. <c>https://discord.gg/FTqNnyS</c>).
+        /// </returns>
         string Url { get; }
 
-        /// <summary> Gets the channel this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A generic channel that the invite points to.
+        /// </returns>
         IChannel Channel { get; }
         /// <summary> Gets the type of the channel this invite is linked to. </summary>
         ChannelType ChannelType { get; }
-        /// <summary> Gets the id of the channel this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the ID of the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="ulong"/> representing the channel snowflake identifier that the invite points to.
+        /// </returns>
         ulong ChannelId { get; }
-        /// <summary> Gets the name of the channel this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the name of the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the channel that the invite points to.
+        /// </returns>
         string ChannelName { get; }
 
-        /// <summary> Gets the guild this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the guild this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A guild object representing the guild that the invite points to.
+        /// </returns>
         IGuild Guild { get; }
-        /// <summary> Gets the id of the guild this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the ID of the guild this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="ulong"/> representing the guild snowflake identifier that the invite points to.
+        /// </returns>
         ulong? GuildId { get; }
-        /// <summary> Gets the name of the guild this invite is linked to. </summary>
+        /// <summary>
+        ///     Gets the name of the guild this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the guild that the invite points to.
+        /// </returns>
         string GuildName { get; }
-        /// <summary> Gets the approximated count of online members in the guild. </summary>
+        /// <summary>
+        ///     Gets the approximated count of online members in the guild.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="System.Int32" /> representing the approximated online member count of the guild that the
+        ///     invite points to; <c>null</c> if one cannot be obtained.
+        /// </returns>
         int? PresenceCount { get; }
-        /// <summary> Gets the approximated count of total members in the guild. </summary>
+        /// <summary>
+        ///     Gets the approximated count of total members in the guild.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="System.Int32" /> representing the approximated total member count of the guild that the
+        ///     invite points to; <c>null</c> if one cannot be obtained.
+        /// </returns>
         int? MemberCount { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Invites/IInviteMetadata.cs b/src/Discord.Net.Core/Entities/Invites/IInviteMetadata.cs
index 0e026ab62..471dc377f 100644
--- a/src/Discord.Net.Core/Entities/Invites/IInviteMetadata.cs
+++ b/src/Discord.Net.Core/Entities/Invites/IInviteMetadata.cs
@@ -2,21 +2,62 @@ using System;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents additional information regarding the generic invite object.
+    /// </summary>
     public interface IInviteMetadata : IInvite
     {
-        /// <summary> Gets the user that created this invite. </summary>
+        /// <summary>
+        ///     Gets the user that created this invite.
+        /// </summary>
+        /// <returns>
+        ///     A user that created this invite.
+        /// </returns>
         IUser Inviter { get; }
-        /// <summary> Returns true if this invite was revoked. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the invite has been revoked.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this invite was revoked; otherwise <c>false</c>.
+        /// </returns>
         bool IsRevoked { get; }
-        /// <summary> Returns true if users accepting this invite will be removed from the guild when they log off. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the invite is a temporary one.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if users accepting this invite will be removed from the guild when they log off; otherwise 
+        ///     <c>false</c>.
+        /// </returns>
         bool IsTemporary { get; }
-        /// <summary> Gets the time (in seconds) until the invite expires, or null if it never expires. </summary>
+        /// <summary>
+        ///     Gets the time (in seconds) until the invite expires.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the time in seconds until this invite expires; <c>null</c> if this
+        ///     invite never expires.
+        /// </returns>
         int? MaxAge { get; }
-        /// <summary> Gets the max amount of times this invite may be used, or null if there is no limit. </summary>
+        /// <summary>
+        ///     Gets the max number of uses this invite may have.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of uses this invite may be accepted until it is removed
+        ///     from the guild; <c>null</c> if none is set.
+        /// </returns>
         int? MaxUses { get; }
-        /// <summary> Gets the amount of times this invite has been used. </summary>
+        /// <summary>
+        ///     Gets the number of times this invite has been used.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of times this invite has been used.
+        /// </returns>
         int? Uses { get; }
-        /// <summary> Gets when this invite was created. </summary>
+        /// <summary>
+        ///     Gets when this invite was created.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset"/> representing the time of which the invite was first created.
+        /// </returns>
         DateTimeOffset? CreatedAt { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/Embed.cs b/src/Discord.Net.Core/Entities/Messages/Embed.cs
index dc62066eb..7fa6f6f36 100644
--- a/src/Discord.Net.Core/Entities/Messages/Embed.cs
+++ b/src/Discord.Net.Core/Entities/Messages/Embed.cs
@@ -5,22 +5,38 @@ using System.Linq;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents an embed object seen in an <see cref="IUserMessage"/>.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class Embed : IEmbed
     {
+        /// <inheritdoc/>
         public EmbedType Type { get; }
 
+        /// <inheritdoc/>
         public string Description { get; internal set; }
+        /// <inheritdoc/>
         public string Url { get; internal set; }
+        /// <inheritdoc/>
         public string Title { get; internal set; }
+        /// <inheritdoc/>
         public DateTimeOffset? Timestamp { get; internal set; }
+        /// <inheritdoc/>
         public Color? Color { get; internal set; }
+        /// <inheritdoc/>
         public EmbedImage? Image { get; internal set; }
+        /// <inheritdoc/>
         public EmbedVideo? Video { get; internal set; }
+        /// <inheritdoc/>
         public EmbedAuthor? Author { get; internal set; }
+        /// <inheritdoc/>
         public EmbedFooter? Footer { get; internal set; }
+        /// <inheritdoc/>
         public EmbedProvider? Provider { get; internal set; }
+        /// <inheritdoc/>
         public EmbedThumbnail? Thumbnail { get; internal set; }
+        /// <inheritdoc/>
         public ImmutableArray<EmbedField> Fields { get; internal set; }
 
         internal Embed(EmbedType type)
@@ -57,6 +73,9 @@ namespace Discord
             Fields = fields;
         }
 
+        /// <summary>
+        ///     Gets the total length of all embed properties.
+        /// </summary>
         public int Length
         {
             get
@@ -70,6 +89,9 @@ namespace Discord
             }
         }
 
+        /// <summary>
+        ///     Gets the title of the embed.
+        /// </summary>
         public override string ToString() => Title;
         private string DebuggerDisplay => $"{Title} ({Type})";
     }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedAuthor.cs b/src/Discord.Net.Core/Entities/Messages/EmbedAuthor.cs
index c59473704..3b11f6a8b 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedAuthor.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedAuthor.cs
@@ -1,14 +1,28 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A author field of an <see cref="Embed"/>.
+    /// </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedAuthor
     {
+        /// <summary>
+        ///     Gets the name of the author field.
+        /// </summary>
         public string Name { get; internal set; }
+        /// <summary>
+        ///     Gets the URL of the author field.
+        /// </summary>
         public string Url { get; internal set; }
+        /// <summary>
+        ///     Gets the icon URL of the author field.
+        /// </summary>
         public string IconUrl { get; internal set; }
+        /// <summary>
+        ///     Gets the proxified icon URL of the author field.
+        /// </summary>
         public string ProxyIconUrl { get; internal set; }
 
         internal EmbedAuthor(string name, string url, string iconUrl, string proxyIconUrl)
@@ -20,6 +34,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Name} ({Url})";
+        /// <summary>
+        ///     Gets the name of the author field.
+        /// </summary>
+        /// <returns>
+        ///     
+        /// </returns>
         public override string ToString() => Name;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
index 82e94e39f..39d24fa03 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedBuilder.cs
@@ -5,6 +5,9 @@ using System.Linq;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a builder class for creating a <see cref="EmbedType.Rich"/> <see cref="Embed"/>.
+    /// </summary>
     public class EmbedBuilder
     {
         private string _title;
@@ -14,16 +17,33 @@ namespace Discord
         private EmbedThumbnail? _thumbnail;
         private List<EmbedFieldBuilder> _fields;
 
+        /// <summary> 
+        ///     Returns the maximum number of fields allowed by Discord. 
+        /// </summary>
         public const int MaxFieldCount = 25;
+        /// <summary> 
+        ///     Returns the maximum length of title allowed by Discord. 
+        /// </summary>
         public const int MaxTitleLength = 256;
+        /// <summary> 
+        ///     Returns the maximum length of description allowed by Discord. 
+        /// </summary>
         public const int MaxDescriptionLength = 2048;
+        /// <summary> 
+        ///     Returns the maximum length of total characters allowed by Discord. 
+        /// </summary>
         public const int MaxEmbedLength = 6000;
 
+        /// <summary> Initializes a new <see cref="EmbedBuilder"/> class. </summary>
         public EmbedBuilder()
         {
             Fields = new List<EmbedFieldBuilder>();
         }
 
+        /// <summary> Gets or sets the title of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentException" accessor="set">Title length exceeds <see cref="MaxTitleLength"/>.
+        /// </exception>
+        /// <returns> The title of the embed.</returns>
         public string Title
         {
             get => _title;
@@ -33,6 +53,10 @@ namespace Discord
                 _title = value;
             }
         }
+
+        /// <summary> Gets or sets the description of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentException" accessor="set">Description length exceeds <see cref="MaxDescriptionLength"/>.</exception>
+        /// <returns> The description of the embed.</returns>
         public string Description
         {
             get => _description;
@@ -43,49 +67,96 @@ namespace Discord
             }
         }
 
+        /// <summary> Gets or sets the URL of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns> The URL of the embed.</returns>
         public string Url
         {
             get => _url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(Url));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(Url));
                 _url = value;
             }
         }
+        /// <summary> Gets or sets the thumbnail URL of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns> The thumbnail URL of the embed.</returns>
         public string ThumbnailUrl
         {
             get => _thumbnail?.Url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(ThumbnailUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(ThumbnailUrl));
                 _thumbnail = new EmbedThumbnail(value, null, null, null);
             }
         }
+        /// <summary> Gets or sets the image URL of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns> The image URL of the embed.</returns>
         public string ImageUrl
         {
             get => _image?.Url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(ImageUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(ImageUrl));
                 _image = new EmbedImage(value, null, null, null);
             }
         }
+
+        /// <summary> Gets or sets the list of <see cref="EmbedFieldBuilder"/> of an <see cref="Embed"/>. </summary>
+        /// <exception cref="ArgumentNullException" accessor="set">An embed builder's fields collection is set to 
+        /// <c>null</c>.</exception>
+        /// <exception cref="ArgumentException" accessor="set">Description length exceeds <see cref="MaxFieldCount"/>.
+        /// </exception>
+        /// <returns> The list of existing <see cref="EmbedFieldBuilder"/>.</returns>
         public List<EmbedFieldBuilder> Fields
         {
             get => _fields;
             set
             {
-                if (value == null) throw new ArgumentNullException(paramName: nameof(Fields), message: "Cannot set an embed builder's fields collection to null");
+                if (value == null) throw new ArgumentNullException(paramName: nameof(Fields), message: "Cannot set an embed builder's fields collection to null.");
                 if (value.Count > MaxFieldCount) throw new ArgumentException(message: $"Field count must be less than or equal to {MaxFieldCount}.", paramName: nameof(Fields));
                 _fields = value;
             }
         }
 
+        /// <summary>
+        ///     Gets or sets the timestamp of an <see cref="Embed"/>.
+        /// </summary>
+        /// <returns>
+        ///     The timestamp of the embed, or <c>null</c> if none is set.
+        /// </returns>
         public DateTimeOffset? Timestamp { get; set; }
+        /// <summary>
+        ///     Gets or sets the sidebar color of an <see cref="Embed"/>.
+        /// </summary>
+        /// <returns>
+        ///     The color of the embed, or <c>null</c> if none is set.
+        /// </returns>
         public Color? Color { get; set; }
+        /// <summary>
+        ///     Gets or sets the <see cref="EmbedAuthorBuilder" /> of an <see cref="Embed"/>.
+        /// </summary>
+        /// <returns>
+        ///     The author field builder of the embed, or <c>null</c> if none is set.
+        /// </returns>
         public EmbedAuthorBuilder Author { get; set; }
+        /// <summary>
+        ///     Gets or sets the <see cref="EmbedFooterBuilder" /> of an <see cref="Embed"/>.
+        /// </summary>
+        /// <returns>
+        ///     The footer field builder of the embed, or <c>null</c> if none is set.
+        /// </returns>
         public EmbedFooterBuilder Footer { get; set; }
 
+        /// <summary>
+        ///     Gets the total length of all embed properties.
+        /// </summary>
+        /// <returns>
+        ///     The combined length of <see cref="Title"/>, <see cref="EmbedAuthor.Name"/>, <see cref="Description"/>, 
+        ///     <see cref="EmbedFooter.Text"/>, <see cref="EmbedField.Name"/>, and <see cref="EmbedField.Value"/>.
+        /// </returns>
         public int Length
         {
             get
@@ -100,52 +171,121 @@ namespace Discord
             }
         }
 
+        /// <summary>
+        ///     Sets the title of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="title">The title to be set.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithTitle(string title)
         {
             Title = title;
             return this;
         }
+        /// <summary> 
+        ///     Sets the description of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="description"> The description to be set. </param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithDescription(string description)
         {
             Description = description;
             return this;
         }
+        /// <summary> 
+        ///     Sets the URL of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="url"> The URL to be set. </param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithUrl(string url)
         {
             Url = url;
             return this;
         }
+        /// <summary> 
+        ///     Sets the thumbnail URL of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="thumbnailUrl"> The thumbnail URL to be set. </param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithThumbnailUrl(string thumbnailUrl)
         {
             ThumbnailUrl = thumbnailUrl;
             return this;
         }
+        /// <summary>
+        ///     Sets the image URL of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="imageUrl">The image URL to be set.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithImageUrl(string imageUrl)
         {
             ImageUrl = imageUrl;
             return this;
         }
+        /// <summary>
+        ///     Sets the timestamp of an <see cref="Embed" /> to the current time.
+        /// </summary>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithCurrentTimestamp()
         {
             Timestamp = DateTimeOffset.UtcNow;
             return this;
         }
+        /// <summary>
+        ///     Sets the timestamp of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="dateTimeOffset">The timestamp to be set.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithTimestamp(DateTimeOffset dateTimeOffset)
         {
             Timestamp = dateTimeOffset;
             return this;
         }
+        /// <summary>
+        ///     Sets the sidebar color of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="color">The color to be set.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithColor(Color color)
         {
             Color = color;
             return this;
         }
 
+        /// <summary>
+        ///     Sets the <see cref="EmbedAuthorBuilder" /> of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="author">The author builder class containing the author field properties.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithAuthor(EmbedAuthorBuilder author)
         {
             Author = author;
             return this;
         }
+        /// <summary>
+        ///     Sets the author field of an <see cref="Embed" /> with the provided properties.
+        /// </summary>
+        /// <param name="action">The delegate containing the author field properties.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithAuthor(Action<EmbedAuthorBuilder> action)
         {
             var author = new EmbedAuthorBuilder();
@@ -153,6 +293,15 @@ namespace Discord
             Author = author;
             return this;
         }
+        /// <summary>
+        ///     Sets the author field of an <see cref="Embed" /> with the provided name, icon URL, and URL.
+        /// </summary>
+        /// <param name="name">The title of the author field.</param>
+        /// <param name="iconUrl">The icon URL of the author field.</param>
+        /// <param name="url">The URL of the author field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithAuthor(string name, string iconUrl = null, string url = null)
         {
             var author = new EmbedAuthorBuilder
@@ -164,11 +313,25 @@ namespace Discord
             Author = author;
             return this;
         }
+        /// <summary>
+        ///     Sets the <see cref="EmbedFooterBuilder" /> of an <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="footer">The footer builder class containing the footer field properties.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithFooter(EmbedFooterBuilder footer)
         {
             Footer = footer;
             return this;
         }
+        /// <summary>
+        ///     Sets the footer field of an <see cref="Embed" /> with the provided properties.
+        /// </summary>
+        /// <param name="action">The delegate containing the footer field properties.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithFooter(Action<EmbedFooterBuilder> action)
         {
             var footer = new EmbedFooterBuilder();
@@ -176,6 +339,14 @@ namespace Discord
             Footer = footer;
             return this;
         }
+        /// <summary>
+        ///     Sets the footer field of an <see cref="Embed" /> with the provided name, icon URL.
+        /// </summary>
+        /// <param name="text">The title of the footer field.</param>
+        /// <param name="iconUrl">The icon URL of the footer field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder WithFooter(string text, string iconUrl = null)
         {
             var footer = new EmbedFooterBuilder
@@ -187,6 +358,15 @@ namespace Discord
             return this;
         }
 
+        /// <summary>
+        ///     Adds an <see cref="Embed" /> field with the provided name and value.
+        /// </summary>
+        /// <param name="name">The title of the field.</param>
+        /// <param name="value">The value of the field.</param>
+        /// <param name="inline">Indicates whether the field is in-line or not.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder AddField(string name, object value, bool inline = false)
         {
             var field = new EmbedFieldBuilder()
@@ -196,6 +376,16 @@ namespace Discord
             AddField(field);
             return this;
         }
+
+        /// <summary>
+        ///     Adds a field with the provided <see cref="EmbedFieldBuilder" /> to an
+        ///     <see cref="Embed"/>.
+        /// </summary>
+        /// <param name="field">The field builder class containing the field properties.</param>
+        /// <exception cref="ArgumentException">Field count exceeds <see cref="MaxFieldCount"/>.</exception>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder AddField(EmbedFieldBuilder field)
         {
             if (Fields.Count >= MaxFieldCount)
@@ -206,6 +396,13 @@ namespace Discord
             Fields.Add(field);
             return this;
         }
+        /// <summary>
+        ///     Adds an <see cref="Embed" /> field with the provided properties.
+        /// </summary>
+        /// <param name="action">The delegate containing the field properties.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedBuilder AddField(Action<EmbedFieldBuilder> action)
         {
             var field = new EmbedFieldBuilder();
@@ -214,10 +411,17 @@ namespace Discord
             return this;
         }
 
+        /// <summary>
+        ///     Builds the <see cref="Embed" /> into a Rich Embed ready to be sent.
+        /// </summary>
+        /// <returns>
+        ///     The built embed object.
+        /// </returns>
+        /// <exception cref="InvalidOperationException">Total embed length exceeds <see cref="MaxEmbedLength"/>.</exception>
         public Embed Build()
         {
             if (Length > MaxEmbedLength)
-                throw new InvalidOperationException($"Total embed length must be less than or equal to {MaxEmbedLength}");
+                throw new InvalidOperationException($"Total embed length must be less than or equal to {MaxEmbedLength}.");
 
             var fields = ImmutableArray.CreateBuilder<EmbedField>(Fields.Count);
             for (int i = 0; i < Fields.Count; i++)
@@ -227,13 +431,33 @@ namespace Discord
         }
     }
 
+    /// <summary>
+    ///     Represents a builder class for an embed field.
+    /// </summary>
     public class EmbedFieldBuilder
     {
         private string _name;
         private string _value;
+        /// <summary>
+        ///     Gets the maximum field length for name allowed by Discord.
+        /// </summary>
         public const int MaxFieldNameLength = 256;
+        /// <summary>
+        ///     Gets the maximum field length for value allowed by Discord.
+        /// </summary>
         public const int MaxFieldValueLength = 1024;
 
+        /// <summary>
+        ///     Gets or sets the field name.
+        /// </summary>
+        /// <exception cref="ArgumentException">
+        /// <para>Field name is <c>null</c>, empty or entirely whitespace.</para>
+        /// <para><c>- or -</c></para>
+        /// <para>Field name length exceeds <see cref="MaxFieldNameLength"/>.</para>
+        /// </exception>
+        /// <returns>
+        ///     The name of the field.
+        /// </returns>
         public string Name
         {
             get => _name;
@@ -245,6 +469,17 @@ namespace Discord
             }
         }
 
+        /// <summary>
+        ///     Gets or sets the field value.
+        /// </summary>
+        /// <exception cref="ArgumentException" accessor="set">
+        /// <para>Field value is <c>null</c>, empty or entirely whitespace.</para>
+        /// <para><c>- or -</c></para>
+        /// <para>Field value length exceeds <see cref="MaxFieldValueLength"/>.</para>
+        /// </exception>
+        /// <returns>
+        ///     The value of the field.
+        /// </returns>
         public object Value
         {
             get => _value;
@@ -256,35 +491,84 @@ namespace Discord
                 _value = stringValue;
             }
         }
+        /// <summary>
+        ///     Gets or sets a value that indicates whether the field should be in-line with each other.
+        /// </summary>
         public bool IsInline { get; set; }
 
+        /// <summary>
+        ///     Sets the field name.
+        /// </summary>
+        /// <param name="name">The name to set the field name to.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedFieldBuilder WithName(string name)
         {
             Name = name;
             return this;
         }
+        /// <summary>
+        ///     Sets the field value.
+        /// </summary>
+        /// <param name="value">The value to set the field value to.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedFieldBuilder WithValue(object value)
         {
             Value = value;
             return this;
         }
+        /// <summary>
+        ///     Determines whether the field should be in-line with each other.
+        /// </summary>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedFieldBuilder WithIsInline(bool isInline)
         {
             IsInline = isInline;
             return this;
         }
 
+        /// <summary>
+        ///     Builds the field builder into a <see cref="EmbedField" /> class.
+        /// </summary>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
+        /// <exception cref="ArgumentException">
+        /// <para><see cref="Name"/> or <see cref="Value"/> is <c>null</c>, empty or entirely whitespace.</para>
+        /// <para><c>- or -</c></para>
+        /// <para><see cref="Name"/> or <see cref="Value"/> exceeds the maximum length allowed by Discord.</para>
+        /// </exception>
         public EmbedField Build()
             => new EmbedField(Name, Value.ToString(), IsInline);
     }
 
+    /// <summary>
+    ///     Represents a builder class for a author field.
+    /// </summary>
     public class EmbedAuthorBuilder
     {
         private string _name;
         private string _url;
         private string _iconUrl;
+        /// <summary>
+        ///     Gets the maximum author name length allowed by Discord.
+        /// </summary>
         public const int MaxAuthorNameLength = 256;
 
+        /// <summary>
+        ///     Gets or sets the author name.
+        /// </summary>
+        /// <exception cref="ArgumentException">
+        /// Author name length is longer than <see cref="MaxAuthorNameLength"/>.
+        /// </exception>
+        /// <returns>
+        ///     The author name.
+        /// </returns>
         public string Name
         {
             get => _name;
@@ -294,52 +578,115 @@ namespace Discord
                 _name = value;
             }
         }
+        /// <summary>
+        ///     Gets or sets the URL of the author field.
+        /// </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns>
+        ///     The URL of the author field.
+        /// </returns>
         public string Url
         {
             get => _url;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(Url));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(Url));
                 _url = value;
             }
         }
+        /// <summary>
+        ///     Gets or sets the icon URL of the author field.
+        /// </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns>
+        ///     The icon URL of the author field.
+        /// </returns>
         public string IconUrl
         {
             get => _iconUrl;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(IconUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(IconUrl));
                 _iconUrl = value;
             }
         }
 
+        /// <summary>
+        ///     Sets the name of the author field.
+        /// </summary>
+        /// <param name="name">The name of the author field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedAuthorBuilder WithName(string name)
         {
             Name = name;
             return this;
         }
+        /// <summary>
+        ///     Sets the URL of the author field.
+        /// </summary>
+        /// <param name="url">The URL of the author field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedAuthorBuilder WithUrl(string url)
         {
             Url = url;
             return this;
         }
+        /// <summary>
+        ///     Sets the icon URL of the author field.
+        /// </summary>
+        /// <param name="iconUrl">The icon URL of the author field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedAuthorBuilder WithIconUrl(string iconUrl)
         {
             IconUrl = iconUrl;
             return this;
         }
 
+        /// <summary>
+        ///     Builds the author field to be used.
+        /// </summary>
+        /// <exception cref="ArgumentException">
+        /// <para>Author name length is longer than <see cref="MaxAuthorNameLength"/>.</para>
+        /// <para><c>- or -</c></para>
+        /// <para><see cref="Url"/> is not a well-formed <see cref="Uri"/>.</para>
+        /// <para><c>- or -</c></para>
+        /// <para><see cref="IconUrl"/> is not a well-formed <see cref="Uri"/>.</para>
+        /// </exception>
+        /// <returns>
+        ///     The built author field.
+        /// </returns>
         public EmbedAuthor Build()
             => new EmbedAuthor(Name, Url, IconUrl, null);
     }
 
+    /// <summary>
+    /// Represents a builder class for an embed footer.
+    /// </summary>
     public class EmbedFooterBuilder
     {
         private string _text;
         private string _iconUrl;
 
+        /// <summary>
+        ///     Gets the maximum footer length allowed by Discord.
+        /// </summary>
         public const int MaxFooterTextLength = 2048;
 
+        /// <summary>
+        ///     Gets or sets the footer text.
+        /// </summary>
+        /// <exception cref="ArgumentException">
+        /// Author name length is longer than <see cref="MaxFooterTextLength"/>.
+        /// </exception>
+        /// <returns>
+        ///     The footer text.
+        /// </returns>
         public string Text
         {
             get => _text;
@@ -349,27 +696,60 @@ namespace Discord
                 _text = value;
             }
         }
+        /// <summary>
+        ///     Gets or sets the icon URL of the footer field.
+        /// </summary>
+        /// <exception cref="ArgumentException" accessor="set">Url is not a well-formed <see cref="Uri"/>.</exception>
+        /// <returns>
+        ///     The icon URL of the footer field.
+        /// </returns>
         public string IconUrl
         {
             get => _iconUrl;
             set
             {
-                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI", paramName: nameof(IconUrl));
+                if (!value.IsNullOrUri()) throw new ArgumentException(message: "Url must be a well-formed URI.", paramName: nameof(IconUrl));
                 _iconUrl = value;
             }
         }
 
+        /// <summary>
+        ///     Sets the name of the footer field.
+        /// </summary>
+        /// <param name="text">The text of the footer field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedFooterBuilder WithText(string text)
         {
             Text = text;
             return this;
         }
+        /// <summary>
+        ///     Sets the icon URL of the footer field.
+        /// </summary>
+        /// <param name="iconUrl">The icon URL of the footer field.</param>
+        /// <returns>
+        ///     The current builder.
+        /// </returns>
         public EmbedFooterBuilder WithIconUrl(string iconUrl)
         {
             IconUrl = iconUrl;
             return this;
         }
 
+        /// <summary>
+        ///     Builds the footer field to be used.
+        /// </summary>
+        /// <returns></returns>
+        /// <exception cref="ArgumentException">
+        /// <para><see cref="Text"/> length is longer than <see cref="MaxFooterTextLength"/>.</para>
+        /// <para><c>- or -</c></para>
+        /// <para><see cref="IconUrl"/> is not a well-formed <see cref="Uri"/>.</para>
+        /// </exception>
+        /// <returns>
+        ///     A built footer field.
+        /// </returns>
         public EmbedFooter Build()
             => new EmbedFooter(Text, IconUrl, null);
     }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedField.cs b/src/Discord.Net.Core/Entities/Messages/EmbedField.cs
index f7c1f8348..f6aa2af3b 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedField.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedField.cs
@@ -1,12 +1,24 @@
-using System.Diagnostics;
+using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A field for an <see cref="Embed"/>.
+    /// </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedField
     {
+        /// <summary>
+        ///     Gets the name of the field.
+        /// </summary>
         public string Name { get; internal set; }
+        /// <summary>
+        ///     Gets the value of the field.
+        /// </summary>
         public string Value { get; internal set; }
+        /// <summary>
+        ///     Gets a value that indicates whether the field should be in-line with each other.
+        /// </summary>
         public bool Inline { get; internal set; }
 
         internal EmbedField(string name, string value, bool inline)
@@ -17,6 +29,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Name} ({Value}";
+        /// <summary>
+        ///     Gets the name of the field.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="EmbedField.Name"/>.
+        /// </returns>
         public override string ToString() => Name;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedFooter.cs b/src/Discord.Net.Core/Entities/Messages/EmbedFooter.cs
index 29d85cd90..4c507d017 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedFooter.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedFooter.cs
@@ -1,14 +1,32 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary> A footer field for an <see cref="Embed"/>. </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedFooter
     {
-        public string Text { get; internal set; }
-        public string IconUrl { get; internal set; }
-        public string ProxyUrl { get; internal set; }
+        /// <summary>
+        ///     Gets the text of the footer field.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the text of the footer field.
+        /// </returns>
+        public string Text { get; }
+        /// <summary>
+        ///     Gets the URL of the footer icon.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL of the footer icon.
+        /// </returns>
+        public string IconUrl { get; }
+        /// <summary>
+        ///     Gets the proxied URL of the footer icon link.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the proxied URL of the footer icon.
+        /// </returns>
+        public string ProxyUrl { get; }
 
         internal EmbedFooter(string text, string iconUrl, string proxyUrl)
         {
@@ -18,6 +36,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Text} ({IconUrl})";
+        /// <summary>
+        ///     Gets the text of the footer field.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.EmbedFooter.Text"/>.
+        /// </returns>
         public override string ToString() => Text;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs b/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
index e12ffc53f..9ce2bfe73 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedImage.cs
@@ -1,14 +1,40 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary> An image for an <see cref="Embed"/>. </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedImage
     {
+        /// <summary>
+        ///     Gets the URL of the image.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL of the image.
+        /// </returns>
         public string Url { get; }
+        /// <summary>
+        ///     Gets a proxied URL of this image.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the proxied URL of this image.
+        /// </returns>
         public string ProxyUrl { get; }
+        /// <summary>
+        ///     Gets the height of this image.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the height of this image if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Height { get; }
+        /// <summary>
+        ///     Gets the width of this image.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the width of this image if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Width { get; }
 
         internal EmbedImage(string url, string proxyUrl, int? height, int? width)
@@ -20,6 +46,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
+        /// <summary>
+        ///     Gets the URL of the thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.EmbedImage.Url"/> .
+        /// </returns>
         public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedProvider.cs b/src/Discord.Net.Core/Entities/Messages/EmbedProvider.cs
index 24722b158..960fb3d78 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedProvider.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedProvider.cs
@@ -1,12 +1,24 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary> A provider field for an <see cref="Embed"/>. </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedProvider
     {
+        /// <summary>
+        ///     Gets the name of the provider.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the name of the provider.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the URL of the provider.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the link to the provider.
+        /// </returns>
         public string Url { get; }
 
         internal EmbedProvider(string name, string url)
@@ -16,6 +28,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Name} ({Url})";
+        /// <summary>
+        ///     Gets the name of the provider.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.EmbedProvider.Name" />.
+        /// </returns>
         public override string ToString() => Name;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs b/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
index 9b3d6153a..7f7b582dc 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedThumbnail.cs
@@ -1,14 +1,40 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary> A thumbnail featured in an <see cref="Embed"/>. </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedThumbnail
     {
+        /// <summary>
+        ///     Gets the URL of the thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL of the thumbnail.
+        /// </returns>
         public string Url { get; }
+        /// <summary>
+        ///     Gets a proxied URL of this thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the proxied URL of this thumbnail.
+        /// </returns>
         public string ProxyUrl { get; }
+        /// <summary>
+        ///     Gets the height of this thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the height of this thumbnail if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Height { get; }
+        /// <summary>
+        ///     Gets the width of this thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the width of this thumbnail if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Width { get; }
 
         internal EmbedThumbnail(string url, string proxyUrl, int? height, int? width)
@@ -20,6 +46,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
+        /// <summary>
+        ///     Gets the URL of the thumbnail.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.EmbedThumbnail.Url" />.
+        /// </returns>
         public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedType.cs b/src/Discord.Net.Core/Entities/Messages/EmbedType.cs
index 5bb2653e2..978f45bc2 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedType.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedType.cs
@@ -1,15 +1,45 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Specifies the type of embed.
+    /// </summary>
     public enum EmbedType
     {
+        /// <summary>
+        ///     An unknown embed type.
+        /// </summary>
         Unknown = -1,
+        /// <summary>
+        ///     A rich embed type.
+        /// </summary>
         Rich,
+        /// <summary>
+        ///     A link embed type.
+        /// </summary>
         Link,
+        /// <summary>
+        ///     A video embed type.
+        /// </summary>
         Video,
+        /// <summary>
+        ///     An image embed type.
+        /// </summary>
         Image,
+        /// <summary>
+        ///     A GIFV embed type.
+        /// </summary>
         Gifv,
+        /// <summary>
+        ///     An article embed type.
+        /// </summary>
         Article,
+        /// <summary>
+        ///     A tweet embed type.
+        /// </summary>
         Tweet,
+        /// <summary>
+        ///     A HTML embed type.
+        /// </summary>
         Html,
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs b/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
index 5725e0e14..ca0300e80 100644
--- a/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
+++ b/src/Discord.Net.Core/Entities/Messages/EmbedVideo.cs
@@ -1,13 +1,35 @@
-using System;
 using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     A video featured in an <see cref="Embed"/>.
+    /// </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct EmbedVideo
     {
+        /// <summary>
+        ///     Gets the URL of the video.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL of the image.
+        /// </returns>
         public string Url { get; }
+        /// <summary>
+        ///     Gets the height of the video.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the height of this video if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Height { get; }
+        /// <summary>
+        ///     Gets the weight of the video.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="int"/> representing the width of this video if it can be retrieved; otherwise 
+        ///     <c>null</c>.
+        /// </returns>
         public int? Width { get; }
 
         internal EmbedVideo(string url, int? height, int? width)
@@ -18,6 +40,12 @@ namespace Discord
         }
 
         private string DebuggerDisplay => $"{Url} ({(Width != null && Height != null ? $"{Width}x{Height}" : "0x0")})";
+        /// <summary>
+        ///     Gets the URL of the video.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Url"/>.
+        /// </returns>
         public override string ToString() => Url;
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/IAttachment.cs b/src/Discord.Net.Core/Entities/Messages/IAttachment.cs
index 225e9cf2e..13b2cf48a 100644
--- a/src/Discord.Net.Core/Entities/Messages/IAttachment.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IAttachment.cs
@@ -1,14 +1,59 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a Discord attachment.
+    /// </summary>
     public interface IAttachment
     {
+        /// <summary>
+        ///     Gets the ID of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     A snowflake ID associated with this attachment.
+        /// </returns>
         ulong Id { get; }
 
+        /// <summary>
+        ///     Gets the filename of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the full filename of this attachment (e.g. <c>textFile.txt</c>).
+        /// </returns>
         string Filename { get; }
+        /// <summary>
+        ///     Gets the URL of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL of this attachment.
+        /// </returns>
         string Url { get; }
+        /// <summary>
+        ///     Gets a proxied URL of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the proxied URL of this attachment.
+        /// </returns>
         string ProxyUrl { get; }
+        /// <summary>
+        ///     Gets the file size of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     The size of this attachment in bytes.
+        /// </returns>
         int Size { get; }
+        /// <summary>
+        ///     Gets the height of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     The height of this attachment if it is a picture; otherwise <c>null</c>.
+        /// </returns>
         int? Height { get; }
+        /// <summary>
+        ///     Gets the width of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     The width of this attachment if it is a picture; otherwise <c>null</c>.
+        /// </returns>
         int? Width { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/IEmbed.cs b/src/Discord.Net.Core/Entities/Messages/IEmbed.cs
index f390c4c28..4c1029a10 100644
--- a/src/Discord.Net.Core/Entities/Messages/IEmbed.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IEmbed.cs
@@ -1,22 +1,104 @@
-using System;
+using System;
 using System.Collections.Immutable;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a Discord embed object.
+    /// </summary>
     public interface IEmbed
     {
+        /// <summary>
+        ///     Gets the title URL of this embed.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the URL set in a title of the embed.
+        /// </returns>
         string Url { get; }
+        /// <summary>
+        ///     Gets the title of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The title of the embed.
+        /// </returns>
         string Title { get; }
+        /// <summary>
+        ///     Gets the description of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The description field of the embed.
+        /// </returns>
         string Description { get; }
+        /// <summary>
+        ///     Gets the type of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The type of the embed.
+        /// </returns>
         EmbedType Type { get; }
+        /// <summary>
+        ///     Gets the timestamp of this embed.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset"/> based on the timestamp present at the bottom left of the embed, or 
+        ///     <c>null</c> if none is set.
+        /// </returns>
         DateTimeOffset? Timestamp { get; }
+        /// <summary>
+        ///     Gets the color of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The color of the embed present on the side of the embed, or <c>null</c> if none is set.
+        /// </returns>
         Color? Color { get; }
+        /// <summary>
+        ///     Gets the image of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The image of the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedImage? Image { get; }
+        /// <summary>
+        ///     Gets the video of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The video of the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedVideo? Video { get; }
+        /// <summary>
+        ///     Gets the author field of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The author field of the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedAuthor? Author { get; }
+        /// <summary>
+        ///     Gets the footer field of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The author field of the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedFooter? Footer { get; }
+        /// <summary>
+        ///     Gets the provider of this embed.
+        /// </summary>
+        /// <returns>
+        ///     The source of the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedProvider? Provider { get; }
+        /// <summary>
+        ///     Gets the thumbnail featured in this embed.
+        /// </summary>
+        /// <returns>
+        ///     The thumbnail featured in the embed, or <c>null</c> if none is set.
+        /// </returns>
         EmbedThumbnail? Thumbnail { get; }
+        /// <summary>
+        ///     Gets the fields of the embed.
+        /// </summary>
+        /// <returns>
+        ///     An array of the fields of the embed.
+        /// </returns>
         ImmutableArray<EmbedField> Fields { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/IMessage.cs b/src/Discord.Net.Core/Entities/Messages/IMessage.cs
index 4266f893a..87754eecd 100644
--- a/src/Discord.Net.Core/Entities/Messages/IMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IMessage.cs
@@ -1,41 +1,104 @@
-using System;
+using System;
 using System.Collections.Generic;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a message object.
+    /// </summary>
     public interface IMessage : ISnowflakeEntity, IDeletable
     {
-        /// <summary> Gets the type of this system message. </summary>
+        /// <summary>
+        ///     Gets the type of this system message.
+        /// </summary>
         MessageType Type { get; }
-        /// <summary> Gets the source of this message. </summary>
+        /// <summary>
+        ///     Gets the source type of this message.
+        /// </summary>
         MessageSource Source { get; }
-        /// <summary> Returns true if this message was sent as a text-to-speech message. </summary>
+        /// <summary>
+        ///     Gets the value that indicates whether this message was meant to be read-aloud by Discord.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this message was sent as a text-to-speech message; otherwise <c>false</c>.
+        /// </returns>
         bool IsTTS { get; }
-        /// <summary> Returns true if this message was added to its channel's pinned messages. </summary>
+        /// <summary>
+        ///     Gets the value that indicates whether this message is pinned.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this message was added to its channel's pinned messages; otherwise <c>false</c>.
+        /// </returns>
         bool IsPinned { get; }
-        /// <summary> Returns the content for this message. </summary>
+        /// <summary>
+        ///     Gets the content for this message.
+        /// </summary>
+        /// <returns>
+        ///     A string that contains the body of the message; note that this field may be empty if there is an embed.
+        /// </returns>
         string Content { get; }
-        /// <summary> Gets the time this message was sent. </summary>
+        /// <summary>
+        ///     Gets the time this message was sent.
+        /// </summary>
+        /// <returns>
+        ///     Time of when the message was sent.
+        /// </returns>
         DateTimeOffset Timestamp { get; }
-        /// <summary> Gets the time of this message's last edit, if any. </summary>
+        /// <summary>
+        ///     Gets the time of this message's last edit.
+        /// </summary>
+        /// <returns>
+        ///     Time of when the message was last edited; <c>null</c> when the message is never edited.
+        /// </returns>
         DateTimeOffset? EditedTimestamp { get; }
         
-        /// <summary> Gets the channel this message was sent to. </summary>
+        /// <summary>
+        ///     Gets the source channel of the message.
+        /// </summary>
         IMessageChannel Channel { get; }
-        /// <summary> Gets the author of this message. </summary>
+        /// <summary>
+        ///     Gets the author of this message.
+        /// </summary>
         IUser Author { get; }
 
-        /// <summary> Returns all attachments included in this message. </summary>
+        /// <summary>
+        ///     Returns all attachments included in this message.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of attachments.
+        /// </returns>
         IReadOnlyCollection<IAttachment> Attachments { get; }
-        /// <summary> Returns all embeds included in this message. </summary>
+        /// <summary>
+        ///     Returns all embeds included in this message.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of embed objects.
+        /// </returns>
         IReadOnlyCollection<IEmbed> Embeds { get; }
-        /// <summary> Returns all tags included in this message's content. </summary>
+        /// <summary>
+        ///     Returns all tags included in this message's content.
+        /// </summary>
         IReadOnlyCollection<ITag> Tags { get; }
-        /// <summary> Returns the ids of channels mentioned in this message. </summary>
+        /// <summary>
+        ///     Returns the IDs of channels mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of channel IDs.
+        /// </returns>
         IReadOnlyCollection<ulong> MentionedChannelIds { get; }
-        /// <summary> Returns the ids of roles mentioned in this message. </summary>
+        /// <summary>
+        ///     Returns the IDs of roles mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of role IDs.
+        /// </returns>
         IReadOnlyCollection<ulong> MentionedRoleIds { get; }
-        /// <summary> Returns the ids of users mentioned in this message. </summary>
+        /// <summary>
+        ///     Returns the IDs of users mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of user IDs.
+        /// </returns>
         IReadOnlyCollection<ulong> MentionedUserIds { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/IReaction.cs b/src/Discord.Net.Core/Entities/Messages/IReaction.cs
index 37ead42ae..b7d7128c0 100644
--- a/src/Discord.Net.Core/Entities/Messages/IReaction.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IReaction.cs
@@ -1,7 +1,13 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic reaction object.
+    /// </summary>
     public interface IReaction
     {
+        /// <summary>
+        ///     The <see cref="IEmote" /> used in the reaction.
+        /// </summary>
         IEmote Emote { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/ISystemMessage.cs b/src/Discord.Net.Core/Entities/Messages/ISystemMessage.cs
index 2dfaf8f2d..89cd17a35 100644
--- a/src/Discord.Net.Core/Entities/Messages/ISystemMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/ISystemMessage.cs
@@ -1,5 +1,8 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic message sent by the system.
+    /// </summary>
     public interface ISystemMessage : IMessage
     {
     }
diff --git a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
index 36ee725ff..b31890e51 100644
--- a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
@@ -4,28 +4,114 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic message sent by a user.
+    /// </summary>
     public interface IUserMessage : IMessage
     {
-        /// <summary> Modifies this message. </summary>
+        /// <summary>
+        ///     Modifies this message.
+        /// </summary>
+        /// <example>
+        /// <code language="cs">
+        /// await msg.ModifyAsync(x =&gt; x.Content = "Hello World!");
+        /// </code>
+        /// </example>
+        /// <param name="func">A delegate containing the properties to modify the message with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
         Task ModifyAsync(Action<MessageProperties> func, RequestOptions options = null);
-        /// <summary> Adds this message to its channel's pinned messages. </summary>
+        /// <summary>
+        ///     Adds this message to its channel's pinned messages.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for pinning this message.
+        /// </returns>
         Task PinAsync(RequestOptions options = null);
-        /// <summary> Removes this message from its channel's pinned messages. </summary>
+        /// <summary>
+        ///     Removes this message from its channel's pinned messages.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for unpinning this message.
+        /// </returns>
         Task UnpinAsync(RequestOptions options = null);
 
-        /// <summary> Returns all reactions included in this message. </summary>
+        /// <summary>
+        ///     Gets all reactions included in this message.
+        /// </summary>
         IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions { get; }
 
-        /// <summary> Adds a reaction to this message. </summary>
+        /// <summary>
+        ///     Adds a reaction to this message.
+        /// </summary>
+        /// <example>
+        /// <code language="cs">
+        /// await msg.AddReactionAsync(new Emoji("\U0001f495"));
+        /// </code>
+        /// </example>
+        /// <param name="emote">The emoji used to react to this message.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for adding a reaction to this message.
+        /// </returns>
+        /// <seealso cref="IEmote"/>
         Task AddReactionAsync(IEmote emote, RequestOptions options = null);
-        /// <summary> Removes a reaction from message. </summary>
+        /// <summary>
+        ///     Removes a reaction from message.
+        /// </summary>
+        /// <example>
+        /// <code language="cs">
+        /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), msg.Author);
+        /// </code>
+        /// </example>
+        /// <param name="emote">The emoji used to react to this message.</param>
+        /// <param name="user">The user that added the emoji.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for removing a reaction to this message.
+        /// </returns>
+        /// <seealso cref="IEmote"/>
         Task RemoveReactionAsync(IEmote emote, IUser user, RequestOptions options = null);
-        /// <summary> Removes all reactions from this message. </summary>
+        /// <summary>
+        ///     Removes all reactions from this message.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous removal operation.
+        /// </returns>
         Task RemoveAllReactionsAsync(RequestOptions options = null);
-        /// <summary>  Gets all users that reacted to a message with a given emote </summary>
+
+        /// <summary>
+        ///     Gets all users that reacted to a message with a given emote.
+        /// </summary>
+        /// <example>
+        ///     <code language="cs">
+        ///     var emoji = new Emoji("\U0001f495");
+        ///     var reactedUsers = await message.GetReactionUsersAsync(emoji, 100).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="emoji">The emoji that represents the reaction that you wish to get.</param>
+        /// <param name="limit">The number of users to request.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A paged collection containing a read-only collection of users that has reacted to this message.
+        ///     Flattening the paginated response into a collection of users with 
+        ///     <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IEmote emoji, int limit, RequestOptions options = null);
 
-        /// <summary> Transforms this message's text into a human readable form by resolving its tags. </summary>
+        /// <summary>
+        ///     Transforms this message's text into a human-readable form by resolving its tags.
+        /// </summary>
+        /// <param name="userHandling">Determines how the user tag should be handled.</param>
+        /// <param name="channelHandling">Determines how the channel tag should be handled.</param>
+        /// <param name="roleHandling">Determines how the role tag should be handled.</param>
+        /// <param name="everyoneHandling">Determines how the @everyone tag should be handled.</param>
+        /// <param name="emojiHandling">Determines how the emoji tag should be handled.</param>
         string Resolve(
             TagHandling userHandling = TagHandling.Name,
             TagHandling channelHandling = TagHandling.Name,
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageProperties.cs b/src/Discord.Net.Core/Entities/Messages/MessageProperties.cs
index b3f3a9c89..2cc0eab8e 100644
--- a/src/Discord.Net.Core/Entities/Messages/MessageProperties.cs
+++ b/src/Discord.Net.Core/Entities/Messages/MessageProperties.cs
@@ -1,36 +1,23 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify a message with the specified parameters.
+    ///     Properties that are used to modify an <see cref="IUserMessage" /> with the specified changes.
     /// </summary>
     /// <remarks>
-    /// The content of a message can be cleared with String.Empty; if and only if an Embed is present.
+    ///     The content of a message can be cleared with <see cref="System.String.Empty"/> if and only if an <see cref="Discord.Embed"/> is present.
     /// </remarks>
-    /// <example>
-    /// <code language="c#">
-    /// var message = await ReplyAsync("abc");
-    /// await message.ModifyAsync(x =>
-    /// {
-    ///     x.Content = "";
-    ///     x.Embed = new EmbedBuilder()
-    ///         .WithColor(new Color(40, 40, 120))
-    ///         .WithAuthor(a => a.Name = "foxbot")
-    ///         .WithTitle("Embed!")
-    ///         .WithDescription("This is an embed.");
-    /// });
-    /// </code>
-    /// </example>
+    /// <seealso cref="IUserMessage.ModifyAsync"/>
     public class MessageProperties
     {
         /// <summary>
-        /// The content of the message
+        ///     Gets or sets the content of the message.
         /// </summary>
         /// <remarks>
-        /// This must be less than 2000 characters.
+        ///     This must be less than the constant defined by <see cref="DiscordConfig.MaxMessageSize"/>.
         /// </remarks>
         public Optional<string> Content { get; set; }
         /// <summary>
-        /// The embed the message should display
+        ///     Gets or sets the embed the message should display.
         /// </summary>
         public Optional<Embed> Embed { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageSource.cs b/src/Discord.Net.Core/Entities/Messages/MessageSource.cs
index 1cb2f8b94..bd4f23727 100644
--- a/src/Discord.Net.Core/Entities/Messages/MessageSource.cs
+++ b/src/Discord.Net.Core/Entities/Messages/MessageSource.cs
@@ -1,10 +1,25 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Specifies the source of the Discord message.
+    /// </summary>
     public enum MessageSource
     {
+        /// <summary>
+        ///     The message is sent by the system.
+        /// </summary>
         System,
+        /// <summary>
+        ///     The message is sent by a user.
+        /// </summary>
         User,
+        /// <summary>
+        ///     The message is sent by a bot.
+        /// </summary>
         Bot,
+        /// <summary>
+        ///     The message is sent by a webhook.
+        /// </summary>
         Webhook
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageType.cs b/src/Discord.Net.Core/Entities/Messages/MessageType.cs
index 687e69e14..5056da8ea 100644
--- a/src/Discord.Net.Core/Entities/Messages/MessageType.cs
+++ b/src/Discord.Net.Core/Entities/Messages/MessageType.cs
@@ -1,13 +1,37 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the type of message.
+    /// </summary>
     public enum MessageType
     {
+        /// <summary>
+        ///     The default message type.
+        /// </summary>
         Default = 0,
+        /// <summary>
+        ///     The message when a recipient is added.
+        /// </summary>
         RecipientAdd = 1,
+        /// <summary>
+        ///     The message when a recipient is removed.
+        /// </summary>
         RecipientRemove = 2,
+        /// <summary>
+        ///     The message when a user is called.
+        /// </summary>
         Call = 3,
+        /// <summary>
+        ///     The message when a channel name is changed.
+        /// </summary>
         ChannelNameChange = 4,
+        /// <summary>
+        ///     The message when a channel icon is changed.
+        /// </summary>
         ChannelIconChange = 5,
+        /// <summary>
+        ///     The message when another message is pinned.
+        /// </summary>
         ChannelPinnedMessage = 6
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/ReactionMetadata.cs b/src/Discord.Net.Core/Entities/Messages/ReactionMetadata.cs
index 005276202..850666921 100644
--- a/src/Discord.Net.Core/Entities/Messages/ReactionMetadata.cs
+++ b/src/Discord.Net.Core/Entities/Messages/ReactionMetadata.cs
@@ -1,11 +1,24 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     A metadata containing reaction information.
+    /// </summary>
     public struct ReactionMetadata
     {
-        /// <summary> Gets the number of reactions </summary>
+        /// <summary>
+        ///     Gets the number of reactions.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of this reactions that has been added to this message.
+        /// </returns>
         public int ReactionCount { get; internal set; }
 
-        /// <summary> Returns true if the current user has used this reaction </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the current user has reacted to this.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the user has reacted to the message; otherwise <c>false</c>.
+        /// </returns>
         public bool IsMe { get; internal set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/TagHandling.cs b/src/Discord.Net.Core/Entities/Messages/TagHandling.cs
index 492f05879..eaadd6400 100644
--- a/src/Discord.Net.Core/Entities/Messages/TagHandling.cs
+++ b/src/Discord.Net.Core/Entities/Messages/TagHandling.cs
@@ -1,13 +1,39 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the handling type the tag should use.
+    /// </summary>
+    /// <seealso cref="MentionUtils"/>
+    /// <seealso cref="IUserMessage.Resolve"/>
     public enum TagHandling
     {
-        Ignore = 0,         //<@53905483156684800> -> <@53905483156684800>
-        Remove,             //<@53905483156684800> -> 
-        Name,               //<@53905483156684800> -> @Voltana
-        NameNoPrefix,       //<@53905483156684800> -> Voltana
-        FullName,           //<@53905483156684800> -> @Voltana#8252
-        FullNameNoPrefix,   //<@53905483156684800> -> Voltana#8252
-        Sanitize            //<@53905483156684800> -> <@53905483156684800> (w/ nbsp)
+        /// <summary> 
+        ///     Tag handling is ignored (e.g. &lt;@53905483156684800&gt; -&gt; &lt;@53905483156684800&gt;).
+        /// </summary>
+        Ignore = 0,
+        /// <summary> 
+        ///     Removes the tag entirely. 
+        /// </summary>
+        Remove,
+        /// <summary> 
+        ///     Resolves to username (e.g. &lt;@53905483156684800&gt; -&gt; @Voltana). 
+        /// </summary>
+        Name,
+        /// <summary> 
+        ///     Resolves to username without mention prefix (e.g. &lt;@53905483156684800&gt; -&gt; Voltana). 
+        /// </summary>
+        NameNoPrefix,
+        /// <summary> 
+        ///     Resolves to username with discriminator value. (e.g. &lt;@53905483156684800&gt; -&gt; @Voltana#8252). 
+        /// </summary>
+        FullName,
+        /// <summary> 
+        ///     Resolves to username with discriminator value without mention prefix. (e.g. &lt;@53905483156684800&gt; -&gt; Voltana#8252). 
+        /// </summary>
+        FullNameNoPrefix,
+        /// <summary> 
+        ///     Sanitizes the tag (e.g. &lt;@53905483156684800&gt; -&gt; &lt;@53905483156684800&gt; (w/ nbsp)).
+        /// </summary>
+        Sanitize
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/TagType.cs b/src/Discord.Net.Core/Entities/Messages/TagType.cs
index 2d93bb3e3..177157251 100644
--- a/src/Discord.Net.Core/Entities/Messages/TagType.cs
+++ b/src/Discord.Net.Core/Entities/Messages/TagType.cs
@@ -1,12 +1,19 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Specifies the type of Discord tag. </summary>
     public enum TagType
     {
+        /// <summary> The object is an user mention. </summary>
         UserMention,
+        /// <summary> The object is a channel mention. </summary>
         ChannelMention,
+        /// <summary> The object is a role mention. </summary>
         RoleMention,
+        /// <summary> The object is an everyone mention. </summary>
         EveryoneMention,
+        /// <summary> The object is a here mention. </summary>
         HereMention,
+        /// <summary> The object is an emoji. </summary>
         Emoji
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Permissions/ChannelPermission.cs b/src/Discord.Net.Core/Entities/Permissions/ChannelPermission.cs
index 0fbd22c4e..e3cfc0e19 100644
--- a/src/Discord.Net.Core/Entities/Permissions/ChannelPermission.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/ChannelPermission.cs
@@ -2,38 +2,103 @@ using System;
 
 namespace Discord
 {
-    [FlagsAttribute]
+    /// <summary> Defines the available permissions for a channel. </summary>
+    [Flags]
     public enum ChannelPermission : ulong
     {
         // General
-        CreateInstantInvite = 0x00_00_00_01,
-        ManageChannels      = 0x00_00_00_10,
+        /// <summary>
+        ///     Allows creation of instant invites.
+        /// </summary>
+        CreateInstantInvite	= 0x00_00_00_01,
+        /// <summary>
+        ///     Allows management and editing of channels.
+        /// </summary>
+        ManageChannels		= 0x00_00_00_10,
 
         // Text
-        AddReactions        = 0x00_00_00_40,
+        /// <summary>
+        ///     Allows for the addition of reactions to messages.
+        /// </summary>
+        AddReactions		= 0x00_00_00_40,
+        /// <summary>
+        ///     Allows for reading of messages. This flag is obsolete, use <see cref = "ViewChannel" /> instead.
+        /// </summary>
         [Obsolete("Use ViewChannel instead.")]
-        ReadMessages        = ViewChannel,
-        ViewChannel         = 0x00_00_04_00,
-        SendMessages        = 0x00_00_08_00,
-        SendTTSMessages     = 0x00_00_10_00,
-        ManageMessages      = 0x00_00_20_00,
-        EmbedLinks          = 0x00_00_40_00,
+        ReadMessages		= ViewChannel,
+        /// <summary>
+        ///     Allows guild members to view a channel, which includes reading messages in text channels.
+        /// </summary>
+        ViewChannel			= 0x00_00_04_00,
+        /// <summary>
+        ///     Allows for sending messages in a channel.
+        /// </summary>
+        SendMessages		= 0x00_00_08_00,
+        /// <summary>
+        ///     Allows for sending of text-to-speech messages.
+        /// </summary>
+        SendTTSMessages		= 0x00_00_10_00,
+        /// <summary>
+        ///     Allows for deletion of other users messages.
+        /// </summary>
+        ManageMessages		= 0x00_00_20_00,
+        /// <summary>
+        ///     Allows links sent by users with this permission will be auto-embedded.
+        /// </summary>
+        EmbedLinks			= 0x00_00_40_00,
+        /// <summary>
+        ///     Allows for uploading images and files.
+        /// </summary>
         AttachFiles         = 0x00_00_80_00,
-        ReadMessageHistory  = 0x00_01_00_00,
+        /// <summary>
+        ///     Allows for reading of message history.
+        /// </summary>
+        ReadMessageHistory	= 0x00_01_00_00,
+        /// <summary>
+        ///     Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all
+        ///     online users in a channel.
+        /// </summary>
         MentionEveryone     = 0x00_02_00_00,
+        /// <summary>
+        ///     Allows the usage of custom emojis from other servers.
+        /// </summary>
         UseExternalEmojis   = 0x00_04_00_00,
 
         // Voice
-        Connect             = 0x00_10_00_00,
-        Speak               = 0x00_20_00_00,
-        MuteMembers         = 0x00_40_00_00,
-        DeafenMembers       = 0x00_80_00_00,
+        /// <summary>
+        ///     Allows for joining of a voice channel.
+        /// </summary>
+        Connect				= 0x00_10_00_00,
+        /// <summary>
+        ///     Allows for speaking in a voice channel.
+        /// </summary>
+        Speak				= 0x00_20_00_00,
+        /// <summary>
+        ///     Allows for muting members in a voice channel.
+        /// </summary>
+        MuteMembers			= 0x00_40_00_00,
+        /// <summary>
+        ///     Allows for deafening of members in a voice channel.
+        /// </summary>
+        DeafenMembers		= 0x00_80_00_00,
+        /// <summary>
+        ///     Allows for moving of members between voice channels.
+        /// </summary>
         MoveMembers         = 0x01_00_00_00,
-        UseVAD              = 0x02_00_00_00,
+        /// <summary>
+        ///     Allows for using voice-activity-detection in a voice channel.
+        /// </summary>
+        UseVAD         		= 0x02_00_00_00,
         PrioritySpeaker     = 0x00_00_01_00,
 
         // More General
+        /// <summary>
+        ///     Allows management and editing of roles.
+        /// </summary>
         ManageRoles         = 0x10_00_00_00,
-        ManageWebhooks      = 0x20_00_00_00,
+        /// <summary>
+        ///     Allows management and editing of webhooks.
+        /// </summary>
+        ManageWebhooks		= 0x20_00_00_00,
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs b/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
index ea56734ff..7bef3251a 100644
--- a/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/ChannelPermissions.cs
@@ -7,19 +7,21 @@ namespace Discord
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public struct ChannelPermissions
     {
-        /// <summary> Gets a blank ChannelPermissions that grants no permissions. </summary>
+        /// <summary> Gets a blank <see cref="ChannelPermissions"/> that grants no permissions. </summary>
+        /// <returns> A <see cref="ChannelPermissions"/> structure that does not contain any set permissions. </returns>
         public static readonly ChannelPermissions None = new ChannelPermissions();
-        /// <summary> Gets a ChannelPermissions that grants all permissions for text channels. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for text channels. </summary>
         public static readonly ChannelPermissions Text = new ChannelPermissions(0b01100_0000000_1111111110001_010001);
-        /// <summary> Gets a ChannelPermissions that grants all permissions for voice channels. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for voice channels. </summary>
         public static readonly ChannelPermissions Voice = new ChannelPermissions(0b00100_1111110_0000000010100_010001);
-        /// <summary> Gets a ChannelPermissions that grants all permissions for category channels. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for category channels. </summary>
         public static readonly ChannelPermissions Category = new ChannelPermissions(0b01100_1111110_1111111110001_010001);
-        /// <summary> Gets a ChannelPermissions that grants all permissions for direct message channels. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for direct message channels. </summary>
         public static readonly ChannelPermissions DM = new ChannelPermissions(0b00000_1000110_1011100110000_000000);
-        /// <summary> Gets a ChannelPermissions that grants all permissions for group channels. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for group channels. </summary>
         public static readonly ChannelPermissions Group = new ChannelPermissions(0b00000_1000110_0001101100000_000000);
-        /// <summary> Gets a ChannelPermissions that grants all permissions for a given channelType. </summary>
+        /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for a given channel type. </summary>
+        /// <exception cref="ArgumentException">Unknown channel type.</exception>
         public static ChannelPermissions All(IChannel channel)
         {
             switch (channel)
@@ -29,64 +31,64 @@ namespace Discord
                 case ICategoryChannel _: return Category;
                 case IDMChannel _: return DM;
                 case IGroupChannel _: return Group;
-                default: throw new ArgumentException(message: "Unknown channel type", paramName: nameof(channel));
+                default: throw new ArgumentException(message: "Unknown channel type.", paramName: nameof(channel));
             }
         }
 
-        /// <summary> Gets a packed value representing all the permissions in this ChannelPermissions. </summary>
+        /// <summary> Gets a packed value representing all the permissions in this <see cref="ChannelPermissions"/>. </summary>
         public ulong RawValue { get; }
 
-        /// <summary> If True, a user may create invites. </summary>
+        /// <summary> If <c>true</c>, a user may create invites. </summary>
         public bool CreateInstantInvite => Permissions.GetValue(RawValue, ChannelPermission.CreateInstantInvite);
-        /// <summary> If True, a user may create, delete and modify this channel. </summary>
+        /// <summary> If <c>true</c>, a user may create, delete and modify this channel. </summary>
         public bool ManageChannel => Permissions.GetValue(RawValue, ChannelPermission.ManageChannels);
 
-        /// <summary> If true, a user may add reactions. </summary>
+        /// <summary> If <c>true</c>, a user may add reactions. </summary>
         public bool AddReactions => Permissions.GetValue(RawValue, ChannelPermission.AddReactions);
-        /// <summary> If True, a user may join channels. </summary>
+        /// <summary> If <c>true</c>, a user may join channels. </summary>
         [Obsolete("Use ViewChannel instead.")]
         public bool ReadMessages => ViewChannel;
-        /// <summary> If True, a user may view channels. </summary>
+        /// <summary> If <c>true</c>, a user may view channels. </summary>
         public bool ViewChannel => Permissions.GetValue(RawValue, ChannelPermission.ViewChannel);
 
-        /// <summary> If True, a user may send messages. </summary>
+        /// <summary> If <c>true</c>, a user may send messages. </summary>
         public bool SendMessages => Permissions.GetValue(RawValue, ChannelPermission.SendMessages);
-        /// <summary> If True, a user may send text-to-speech messages. </summary>
+        /// <summary> If <c>true</c>, a user may send text-to-speech messages. </summary>
         public bool SendTTSMessages => Permissions.GetValue(RawValue, ChannelPermission.SendTTSMessages);
-        /// <summary> If True, a user may delete messages. </summary>
+        /// <summary> If <c>true</c>, a user may delete messages. </summary>
         public bool ManageMessages => Permissions.GetValue(RawValue, ChannelPermission.ManageMessages);
-        /// <summary> If True, Discord will auto-embed links sent by this user. </summary>
+        /// <summary> If <c>true</c>, Discord will auto-embed links sent by this user. </summary>
         public bool EmbedLinks => Permissions.GetValue(RawValue, ChannelPermission.EmbedLinks);
-        /// <summary> If True, a user may send files. </summary>
+        /// <summary> If <c>true</c>, a user may send files. </summary>
         public bool AttachFiles => Permissions.GetValue(RawValue, ChannelPermission.AttachFiles);
-        /// <summary> If True, a user may read previous messages. </summary>
+        /// <summary> If <c>true</c>, a user may read previous messages. </summary>
         public bool ReadMessageHistory => Permissions.GetValue(RawValue, ChannelPermission.ReadMessageHistory);
-        /// <summary> If True, a user may mention @everyone. </summary>
+        /// <summary> If <c>true</c>, a user may mention @everyone. </summary>
         public bool MentionEveryone => Permissions.GetValue(RawValue, ChannelPermission.MentionEveryone);
-        /// <summary> If True, a user may use custom emoji from other guilds. </summary>
+        /// <summary> If <c>true</c>, a user may use custom emoji from other guilds. </summary>
         public bool UseExternalEmojis => Permissions.GetValue(RawValue, ChannelPermission.UseExternalEmojis);
 
-        /// <summary> If True, a user may connect to a voice channel. </summary>
+        /// <summary> If <c>true</c>, a user may connect to a voice channel. </summary>
         public bool Connect => Permissions.GetValue(RawValue, ChannelPermission.Connect);
-        /// <summary> If True, a user may speak in a voice channel. </summary>
+        /// <summary> If <c>true</c>, a user may speak in a voice channel. </summary>
         public bool Speak => Permissions.GetValue(RawValue, ChannelPermission.Speak);
-        /// <summary> If True, a user may mute users. </summary>
+        /// <summary> If <c>true</c>, a user may mute users. </summary>
         public bool MuteMembers => Permissions.GetValue(RawValue, ChannelPermission.MuteMembers);
-        /// <summary> If True, a user may deafen users. </summary>
+        /// <summary> If <c>true</c>, a user may deafen users. </summary>
         public bool DeafenMembers => Permissions.GetValue(RawValue, ChannelPermission.DeafenMembers);
-        /// <summary> If True, a user may move other users between voice channels. </summary>
+        /// <summary> If <c>true</c>, a user may move other users between voice channels. </summary>
         public bool MoveMembers => Permissions.GetValue(RawValue, ChannelPermission.MoveMembers);
-        /// <summary> If True, a user may use voice-activity-detection rather than push-to-talk. </summary>
+        /// <summary> If <c>true</c>, a user may use voice-activity-detection rather than push-to-talk. </summary>
         public bool UseVAD => Permissions.GetValue(RawValue, ChannelPermission.UseVAD);
-        /// <summary> If True, a user may use priority speaker in a voice channel. </summary>
+        /// <summary> If <c>true</c>, a user may use priority speaker in a voice channel. </summary>
         public bool PrioritySpeaker => Permissions.GetValue(RawValue, ChannelPermission.PrioritySpeaker);
 
-        /// <summary> If True, a user may adjust role permissions. This also implictly grants all other permissions. </summary>
+        /// <summary> If <c>true</c>, a user may adjust role permissions. This also implictly grants all other permissions. </summary>
         public bool ManageRoles => Permissions.GetValue(RawValue, ChannelPermission.ManageRoles);
-        /// <summary> If True, a user may edit the webhooks for this channel. </summary>
+        /// <summary> If <c>true</c>, a user may edit the webhooks for this channel. </summary>
         public bool ManageWebhooks => Permissions.GetValue(RawValue, ChannelPermission.ManageWebhooks);
 
-        /// <summary> Creates a new ChannelPermissions with the provided packed value. </summary>
+        /// <summary> Creates a new <see cref="ChannelPermissions"/> with the provided packed value. </summary>
         public ChannelPermissions(ulong rawValue) { RawValue = rawValue; }
 
         private ChannelPermissions(ulong initialValue,
@@ -139,7 +141,7 @@ namespace Discord
             RawValue = value;
         }
 
-        /// <summary> Creates a new ChannelPermissions with the provided permissions. </summary>
+        /// <summary> Creates a new <see cref="ChannelPermissions"/> with the provided permissions. </summary>
         public ChannelPermissions(
             bool createInstantInvite = false,
             bool manageChannel = false,
@@ -167,7 +169,7 @@ namespace Discord
                 speak, muteMembers, deafenMembers, moveMembers, useVoiceActivation, prioritySpeaker, manageRoles, manageWebhooks)
         { }
 
-        /// <summary> Creates a new ChannelPermissions from this one, changing the provided non-null permissions. </summary>
+        /// <summary> Creates a new <see cref="ChannelPermissions"/> from this one, changing the provided non-null permissions. </summary>
         public ChannelPermissions Modify(
             bool? createInstantInvite = null,
             bool? manageChannel = null,
diff --git a/src/Discord.Net.Core/Entities/Permissions/GuildPermission.cs b/src/Discord.Net.Core/Entities/Permissions/GuildPermission.cs
index 13a9e32b1..c010d90b1 100644
--- a/src/Discord.Net.Core/Entities/Permissions/GuildPermission.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/GuildPermission.cs
@@ -2,46 +2,163 @@ using System;
 
 namespace Discord
 {
-    [FlagsAttribute]
+    /// <summary> Defines the available permissions for a channel. </summary>
+    [Flags]
     public enum GuildPermission : ulong
     {
         // General
+        /// <summary>
+        ///     Allows creation of instant invites.
+        /// </summary>
         CreateInstantInvite = 0x00_00_00_01,
-        KickMembers         = 0x00_00_00_02,
-        BanMembers          = 0x00_00_00_04,
+        /// <summary>
+        ///     Allows kicking members.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
+        KickMembers			= 0x00_00_00_02,
+        /// <summary>
+        ///     Allows banning members.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
+        BanMembers			= 0x00_00_00_04,
+        /// <summary>
+        ///     Allows all permissions and bypasses channel permission overwrites.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         Administrator       = 0x00_00_00_08,
+        /// <summary>
+        ///     Allows management and editing of channels.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageChannels      = 0x00_00_00_10,
+        /// <summary>
+        ///     Allows management and editing of the guild.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageGuild         = 0x00_00_00_20,
 
         // Text
+		/// <summary>
+		///     Allows for the addition of reactions to messages.
+		/// </summary>
         AddReactions        = 0x00_00_00_40,
+		/// <summary>
+		///		Allows for viewing of audit logs.
+		/// </summary>
         ViewAuditLog        = 0x00_00_00_80,
         [Obsolete("Use ViewChannel instead.")]
         ReadMessages        = ViewChannel,
         ViewChannel         = 0x00_00_04_00,
         SendMessages        = 0x00_00_08_00,
+		/// <summary>
+		///     Allows for sending of text-to-speech messages.
+		/// </summary>
         SendTTSMessages     = 0x00_00_10_00,
+        /// <summary>
+        ///     Allows for deletion of other users messages.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageMessages      = 0x00_00_20_00,
-        EmbedLinks          = 0x00_00_40_00,
-        AttachFiles         = 0x00_00_80_00,
-        ReadMessageHistory  = 0x00_01_00_00,
-        MentionEveryone     = 0x00_02_00_00,
-        UseExternalEmojis   = 0x00_04_00_00,
+        /// <summary>
+        ///     Allows links sent by users with this permission will be auto-embedded.
+        /// </summary>
+        EmbedLinks			= 0x00_00_40_00,
+        /// <summary>
+        ///     Allows for uploading images and files.
+        /// </summary>
+        AttachFiles			= 0x00_00_80_00,
+        /// <summary>
+        ///     Allows for reading of message history.
+        /// </summary>
+        ReadMessageHistory	= 0x00_01_00_00,
+        /// <summary>
+        ///     Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all
+        ///     online users in a channel.
+        /// </summary>
+        MentionEveryone		= 0x00_02_00_00,
+        /// <summary>
+        ///     Allows the usage of custom emojis from other servers.
+        /// </summary>
+        UseExternalEmojis	= 0x00_04_00_00,
+
 
         // Voice
+        /// <summary>
+        ///     Allows for joining of a voice channel.
+        /// </summary>
         Connect             = 0x00_10_00_00,
+        /// <summary>
+        ///     Allows for speaking in a voice channel.
+        /// </summary>
         Speak               = 0x00_20_00_00,
+        /// <summary>
+        ///     Allows for muting members in a voice channel.
+        /// </summary>
         MuteMembers         = 0x00_40_00_00,
+        /// <summary>
+        ///     Allows for deafening of members in a voice channel.
+        /// </summary>
         DeafenMembers       = 0x00_80_00_00,
+        /// <summary>
+        ///     Allows for moving of members between voice channels.
+        /// </summary>
         MoveMembers         = 0x01_00_00_00,
+        /// <summary>
+        ///     Allows for using voice-activity-detection in a voice channel.
+        /// </summary>
         UseVAD              = 0x02_00_00_00,
         PrioritySpeaker     = 0x00_00_01_00,
 
         // General 2
-        ChangeNickname      = 0x04_00_00_00,
+        /// <summary>
+        ///     Allows for modification of own nickname.
+        /// </summary>
+        ChangeNickname		= 0x04_00_00_00,
+        /// <summary>
+        ///     Allows for modification of other users nicknames.
+        /// </summary>
         ManageNicknames     = 0x08_00_00_00,
+        /// <summary>
+        ///     Allows management and editing of roles.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageRoles         = 0x10_00_00_00,
+        /// <summary>
+        ///     Allows management and editing of webhooks.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageWebhooks      = 0x20_00_00_00,
+        /// <summary>
+        ///     Allows management and editing of emojis.
+        /// </summary>
+        /// <remarks>
+        ///     This permission requires the owner account to use two-factor
+        ///     authentication when used on a guild that has server-wide 2FA enabled.
+        /// </remarks>
         ManageEmojis        = 0x40_00_00_00
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Permissions/GuildPermissions.cs b/src/Discord.Net.Core/Entities/Permissions/GuildPermissions.cs
index c9cb90ec8..2d2a9e56a 100644
--- a/src/Discord.Net.Core/Entities/Permissions/GuildPermissions.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/GuildPermissions.cs
@@ -7,32 +7,32 @@ namespace Discord
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct GuildPermissions
     {
-        /// <summary> Gets a blank GuildPermissions that grants no permissions. </summary>
+        /// <summary> Gets a blank <see cref="GuildPermissions"/> that grants no permissions. </summary>
         public static readonly GuildPermissions None = new GuildPermissions();
-        /// <summary> Gets a GuildPermissions that grants all guild permissions for webhook users. </summary>
+        /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions for webhook users. </summary>
         public static readonly GuildPermissions Webhook = new GuildPermissions(0b00000_0000000_0001101100000_000000);
-        /// <summary> Gets a GuildPermissions that grants all guild permissions. </summary>
+        /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions. </summary>
         public static readonly GuildPermissions All = new GuildPermissions(0b11111_1111110_1111111110111_111111);
 
-        /// <summary> Gets a packed value representing all the permissions in this GuildPermissions. </summary>
+        /// <summary> Gets a packed value representing all the permissions in this <see cref="GuildPermissions"/>. </summary>
         public ulong RawValue { get; }
 
-        /// <summary> If True, a user may create invites. </summary>
+        /// <summary> If <c>true</c>, a user may create invites. </summary>
         public bool CreateInstantInvite => Permissions.GetValue(RawValue, GuildPermission.CreateInstantInvite);
-        /// <summary> If True, a user may ban users from the guild. </summary>
+        /// <summary> If <c>true</c>, a user may ban users from the guild. </summary>
         public bool BanMembers => Permissions.GetValue(RawValue, GuildPermission.BanMembers);
-        /// <summary> If True, a user may kick users from the guild. </summary>
+        /// <summary> If <c>true</c>, a user may kick users from the guild. </summary>
         public bool KickMembers => Permissions.GetValue(RawValue, GuildPermission.KickMembers);
-        /// <summary> If True, a user is granted all permissions, and cannot have them revoked via channel permissions. </summary>
+        /// <summary> If <c>true</c>, a user is granted all permissions, and cannot have them revoked via channel permissions. </summary>
         public bool Administrator => Permissions.GetValue(RawValue, GuildPermission.Administrator);
-        /// <summary> If True, a user may create, delete and modify channels. </summary>
+        /// <summary> If <c>true</c>, a user may create, delete and modify channels. </summary>
         public bool ManageChannels => Permissions.GetValue(RawValue, GuildPermission.ManageChannels);
-        /// <summary> If True, a user may adjust guild properties. </summary>
+        /// <summary> If <c>true</c>, a user may adjust guild properties. </summary>
         public bool ManageGuild => Permissions.GetValue(RawValue, GuildPermission.ManageGuild);
 
-        /// <summary> If true, a user may add reactions. </summary>
+        /// <summary> If <c>true</c>, a user may add reactions. </summary>
         public bool AddReactions => Permissions.GetValue(RawValue, GuildPermission.AddReactions);
-        /// <summary> If true, a user may view the audit log. </summary>
+        /// <summary> If <c>true</c>, a user may view the audit log. </summary>
         public bool ViewAuditLog => Permissions.GetValue(RawValue, GuildPermission.ViewAuditLog);
 
         /// <summary> If True, a user may join channels. </summary>
@@ -42,48 +42,48 @@ namespace Discord
         public bool ViewChannel => Permissions.GetValue(RawValue, GuildPermission.ViewChannel);
         /// <summary> If True, a user may send messages. </summary>
         public bool SendMessages => Permissions.GetValue(RawValue, GuildPermission.SendMessages);
-        /// <summary> If True, a user may send text-to-speech messages. </summary>
+        /// <summary> If <c>true</c>, a user may send text-to-speech messages. </summary>
         public bool SendTTSMessages => Permissions.GetValue(RawValue, GuildPermission.SendTTSMessages);
-        /// <summary> If True, a user may delete messages. </summary>
+        /// <summary> If <c>true</c>, a user may delete messages. </summary>
         public bool ManageMessages => Permissions.GetValue(RawValue, GuildPermission.ManageMessages);
-        /// <summary> If True, Discord will auto-embed links sent by this user. </summary>
+        /// <summary> If <c>true</c>, Discord will auto-embed links sent by this user. </summary>
         public bool EmbedLinks => Permissions.GetValue(RawValue, GuildPermission.EmbedLinks);
-        /// <summary> If True, a user may send files. </summary>
+        /// <summary> If <c>true</c>, a user may send files. </summary>
         public bool AttachFiles => Permissions.GetValue(RawValue, GuildPermission.AttachFiles);
-        /// <summary> If True, a user may read previous messages. </summary>
+        /// <summary> If <c>true</c>, a user may read previous messages. </summary>
         public bool ReadMessageHistory => Permissions.GetValue(RawValue, GuildPermission.ReadMessageHistory);
-        /// <summary> If True, a user may mention @everyone. </summary>
+        /// <summary> If <c>true</c>, a user may mention @everyone. </summary>
         public bool MentionEveryone => Permissions.GetValue(RawValue, GuildPermission.MentionEveryone);
-        /// <summary> If True, a user may use custom emoji from other guilds. </summary>
+        /// <summary> If <c>true</c>, a user may use custom emoji from other guilds. </summary>
         public bool UseExternalEmojis => Permissions.GetValue(RawValue, GuildPermission.UseExternalEmojis);
 
-        /// <summary> If True, a user may connect to a voice channel. </summary>
+        /// <summary> If <c>true</c>, a user may connect to a voice channel. </summary>
         public bool Connect => Permissions.GetValue(RawValue, GuildPermission.Connect);
-        /// <summary> If True, a user may speak in a voice channel. </summary>
+        /// <summary> If <c>true</c>, a user may speak in a voice channel. </summary>
         public bool Speak => Permissions.GetValue(RawValue, GuildPermission.Speak);
-        /// <summary> If True, a user may mute users. </summary>
+        /// <summary> If <c>true</c>, a user may mute users. </summary>
         public bool MuteMembers => Permissions.GetValue(RawValue, GuildPermission.MuteMembers);
-        /// <summary> If True, a user may deafen users. </summary>
+        /// <summary> If <c>true</c>, a user may deafen users. </summary>
         public bool DeafenMembers => Permissions.GetValue(RawValue, GuildPermission.DeafenMembers);
-        /// <summary> If True, a user may move other users between voice channels. </summary>
+        /// <summary> If <c>true</c>, a user may move other users between voice channels. </summary>
         public bool MoveMembers => Permissions.GetValue(RawValue, GuildPermission.MoveMembers);
-        /// <summary> If True, a user may use voice-activity-detection rather than push-to-talk. </summary>
+        /// <summary> If <c>true</c>, a user may use voice-activity-detection rather than push-to-talk. </summary>
         public bool UseVAD => Permissions.GetValue(RawValue, GuildPermission.UseVAD);
         /// <summary> If True, a user may use priority speaker in a voice channel. </summary>
         public bool PrioritySpeaker => Permissions.GetValue(RawValue, ChannelPermission.PrioritySpeaker);
 
-        /// <summary> If True, a user may change their own nickname. </summary>
+        /// <summary> If <c>true</c>, a user may change their own nickname. </summary>
         public bool ChangeNickname => Permissions.GetValue(RawValue, GuildPermission.ChangeNickname);
-        /// <summary> If True, a user may change the nickname of other users. </summary>
+        /// <summary> If <c>true</c>, a user may change the nickname of other users. </summary>
         public bool ManageNicknames => Permissions.GetValue(RawValue, GuildPermission.ManageNicknames);
-        /// <summary> If True, a user may adjust roles. </summary>
+        /// <summary> If <c>true</c>, a user may adjust roles. </summary>
         public bool ManageRoles => Permissions.GetValue(RawValue, GuildPermission.ManageRoles);
-        /// <summary> If True, a user may edit the webhooks for this guild. </summary>
+        /// <summary> If <c>true</c>, a user may edit the webhooks for this guild. </summary>
         public bool ManageWebhooks => Permissions.GetValue(RawValue, GuildPermission.ManageWebhooks);
-        /// <summary> If True, a user may edit the emojis for this guild. </summary>
+        /// <summary> If <c>true</c>, a user may edit the emojis for this guild. </summary>
         public bool ManageEmojis => Permissions.GetValue(RawValue, GuildPermission.ManageEmojis);
 
-        /// <summary> Creates a new GuildPermissions with the provided packed value. </summary>
+        /// <summary> Creates a new <see cref="GuildPermissions"/> with the provided packed value. </summary>
         public GuildPermissions(ulong rawValue) { RawValue = rawValue; }
 
         private GuildPermissions(ulong initialValue,
@@ -152,7 +152,7 @@ namespace Discord
             RawValue = value;
         }
 
-        /// <summary> Creates a new GuildPermissions with the provided permissions. </summary>
+        /// <summary> Creates a new <see cref="GuildPermissions"/> structure with the provided permissions. </summary>
         public GuildPermissions(
             bool createInstantInvite = false,
             bool kickMembers = false,
@@ -215,7 +215,7 @@ namespace Discord
                 manageEmojis: manageEmojis)
         { }
 
-        /// <summary> Creates a new GuildPermissions from this one, changing the provided non-null permissions. </summary>
+        /// <summary> Creates a new <see cref="GuildPermissions"/> from this one, changing the provided non-null permissions. </summary>
         public GuildPermissions Modify(
             bool? createInstantInvite = null,
             bool? kickMembers = null,
@@ -251,8 +251,19 @@ namespace Discord
                 readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, moveMembers,
                 useVoiceActivation, prioritySpeaker, changeNickname, manageNicknames, manageRoles, manageWebhooks, manageEmojis);
 
+        /// <summary>
+        ///     Returns a value that indicates if a specific <see cref="GuildPermission"/> is enabled
+        ///     in these permissions.
+        /// </summary>
+        /// <param name="permission">The permission value to check for.</param>
+        /// <returns><c>true</c> if the permission is enabled, <c>false</c> otherwise.</returns>
         public bool Has(GuildPermission permission) => Permissions.GetValue(RawValue, permission);
 
+        /// <summary>
+        ///     Returns a <see cref="List{T}"/> containing all of the <see cref="GuildPermission"/>
+        ///     flags that are enabled.
+        /// </summary>
+        /// <returns>A <see cref="List{T}"/> containing <see cref="GuildPermission"/> flags. Empty if none are enabled.</returns>
         public List<GuildPermission> ToList()
         {
             var perms = new List<GuildPermission>();
diff --git a/src/Discord.Net.Core/Entities/Permissions/Overwrite.cs b/src/Discord.Net.Core/Entities/Permissions/Overwrite.cs
index bda67a870..f8f3fff44 100644
--- a/src/Discord.Net.Core/Entities/Permissions/Overwrite.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/Overwrite.cs
@@ -1,15 +1,26 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represent a permission object.
+    /// </summary>
     public struct Overwrite
     {
-        /// <summary> Gets the unique identifier for the object this overwrite is targeting. </summary>
+        /// <summary>
+        ///     Gets the unique identifier for the object this overwrite is targeting.
+        /// </summary>
         public ulong TargetId { get; }
-        /// <summary> Gets the type of object this overwrite is targeting. </summary>
+        /// <summary>
+        ///     Gets the type of object this overwrite is targeting.
+        /// </summary>
         public PermissionTarget TargetType { get; }
-        /// <summary> Gets the permissions associated with this overwrite entry. </summary>
+        /// <summary>
+        ///     Gets the permissions associated with this overwrite entry.
+        /// </summary>
         public OverwritePermissions Permissions { get; }
 
-        /// <summary> Creates a new Overwrite with provided target information and modified permissions. </summary>
+        /// <summary>
+        ///     Initializes a new <see cref="Overwrite"/> with provided target information and modified permissions.
+        /// </summary>
         public Overwrite(ulong targetId, PermissionTarget targetType, OverwritePermissions permissions)
         {
             TargetId = targetId;
diff --git a/src/Discord.Net.Core/Entities/Permissions/OverwritePermissions.cs b/src/Discord.Net.Core/Entities/Permissions/OverwritePermissions.cs
index b8b4b83e2..04bb2f668 100644
--- a/src/Discord.Net.Core/Entities/Permissions/OverwritePermissions.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/OverwritePermissions.cs
@@ -4,21 +4,36 @@ using System.Diagnostics;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a container for a series of overwrite permissions.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct OverwritePermissions
     {
-        /// <summary> Gets a blank OverwritePermissions that inherits all permissions. </summary>
+        /// <summary>
+        ///     Gets a blank <see cref="OverwritePermissions" /> that inherits all permissions.
+        /// </summary>
         public static OverwritePermissions InheritAll { get; } = new OverwritePermissions();
-        /// <summary> Gets a OverwritePermissions that grants all permissions for a given channelType. </summary>
+        /// <summary>
+        ///     Gets a <see cref="OverwritePermissions" /> that grants all permissions for the given channel.
+        /// </summary>
+        /// <exception cref="ArgumentException">Unknown channel type.</exception>
         public static OverwritePermissions AllowAll(IChannel channel) 
             => new OverwritePermissions(ChannelPermissions.All(channel).RawValue, 0);
-        /// <summary> Gets a OverwritePermissions that denies all permissions for a given channelType. </summary>
+        /// <summary>
+        ///     Gets a <see cref="OverwritePermissions" /> that denies all permissions for the given channel.
+        /// </summary>
+        /// <exception cref="ArgumentException">Unknown channel type.</exception>
         public static OverwritePermissions DenyAll(IChannel channel)
             => new OverwritePermissions(0, ChannelPermissions.All(channel).RawValue);
 
-        /// <summary> Gets a packed value representing all the allowed permissions in this OverwritePermissions. </summary>
+        /// <summary>
+        ///     Gets a packed value representing all the allowed permissions in this <see cref="OverwritePermissions"/>.
+        /// </summary>
         public ulong AllowValue { get; }
-        /// <summary> Gets a packed value representing all the denied permissions in this OverwritePermissions. </summary>
+        /// <summary>
+        ///     Gets a packed value representing all the denied permissions in this <see cref="OverwritePermissions"/>.
+        /// </summary>
         public ulong DenyValue { get; }
 
         /// <summary> If Allowed, a user may create invites. </summary>
@@ -62,7 +77,7 @@ namespace Discord
         /// <summary> If Allowed, a user may use voice-activity-detection rather than push-to-talk. </summary>
         public PermValue UseVAD => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.UseVAD);
 
-        /// <summary> If Allowed, a user may adjust role permissions. This also implictly grants all other permissions. </summary>
+        /// <summary> If Allowed, a user may adjust role permissions. This also implicitly grants all other permissions. </summary>
         public PermValue ManageRoles => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.ManageRoles);
         /// <summary> If True, a user may edit the webhooks for this channel. </summary>
         public PermValue ManageWebhooks => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.ManageWebhooks);
@@ -121,7 +136,9 @@ namespace Discord
             DenyValue = denyValue;
         }
 
-        /// <summary> Creates a new ChannelPermissions with the provided permissions. </summary>
+        /// <summary>
+        ///     Initializes a new <see cref="ChannelPermissions"/> struct with the provided permissions.
+        /// </summary>
         public OverwritePermissions(
             PermValue createInstantInvite = PermValue.Inherit,
             PermValue manageChannel = PermValue.Inherit,
@@ -147,7 +164,10 @@ namespace Discord
                   embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, 
                   moveMembers, useVoiceActivation, manageRoles, manageWebhooks) { }
 
-        /// <summary> Creates a new OverwritePermissions from this one, changing the provided non-null permissions. </summary>
+        /// <summary>
+        ///     Initializes a new <see cref="OverwritePermissions" /> from the current one, changing the provided
+        ///     non-null permissions.
+        /// </summary>
         public OverwritePermissions Modify(
             PermValue? createInstantInvite = null,
             PermValue? manageChannel = null,
@@ -173,6 +193,10 @@ namespace Discord
                 embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, 
                 moveMembers, useVoiceActivation, manageRoles, manageWebhooks);
 
+        /// <summary>
+        ///     Creates a <see cref="List{T}"/> of all the <see cref="ChannelPermission"/> values that are allowed.
+        /// </summary>
+        /// <returns>A <see cref="List{T}"/> of all allowed <see cref="ChannelPermission"/> flags. If none, the list will be empty.</returns>
         public List<ChannelPermission> ToAllowList()
         {
             var perms = new List<ChannelPermission>();
@@ -185,6 +209,11 @@ namespace Discord
             }
             return perms;
         }
+
+        /// <summary>
+        ///     Creates a <see cref="List{T}"/> of all the <see cref="ChannelPermission"/> values that are denied.
+        /// </summary>
+        /// <returns>A <see cref="List{T}"/> of all denied <see cref="ChannelPermission"/> flags. If none, the list will be empty.</returns>
         public List<ChannelPermission> ToDenyList()
         {
             var perms = new List<ChannelPermission>();
diff --git a/src/Discord.Net.Core/Entities/Permissions/PermValue.cs b/src/Discord.Net.Core/Entities/Permissions/PermValue.cs
index fe048b016..6cea8270d 100644
--- a/src/Discord.Net.Core/Entities/Permissions/PermValue.cs
+++ b/src/Discord.Net.Core/Entities/Permissions/PermValue.cs
@@ -1,9 +1,13 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Specifies the permission value. </summary>
     public enum PermValue
     {
+        /// <summary> Allows this permission. </summary>
         Allow,
+        /// <summary> Denies this permission. </summary>
         Deny,
+        /// <summary> Inherits the permission settings. </summary>
         Inherit
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Roles/Color.cs b/src/Discord.Net.Core/Entities/Roles/Color.cs
index 727049dcc..10bed840d 100644
--- a/src/Discord.Net.Core/Entities/Roles/Color.cs
+++ b/src/Discord.Net.Core/Entities/Roles/Color.cs
@@ -6,53 +6,79 @@ using StandardColor = System.Drawing.Color;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a color used in Discord.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct Color
     {
         /// <summary> Gets the default user color value. </summary>
         public static readonly Color Default = new Color(0);
-        /// <summary> Gets the teal color value </summary>
+        /// <summary> Gets the teal color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/1ABC9C">1ABC9C</see>.</returns>
         public static readonly Color Teal = new Color(0x1ABC9C);
-        /// <summary> Gets the dark teal color value </summary>
+        /// <summary> Gets the dark teal color value. </summary>
         public static readonly Color DarkTeal = new Color(0x11806A);
-        /// <summary> Gets the green color value </summary>
+        /// <summary> Gets the green color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/11806A">11806A</see>.</returns>
         public static readonly Color Green = new Color(0x2ECC71);
-        /// <summary> Gets the dark green color value </summary>
+        /// <summary> Gets the dark green color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/2ECC71">2ECC71</see>.</returns>
         public static readonly Color DarkGreen = new Color(0x1F8B4C);
-        /// <summary> Gets the blue color value </summary>
+        /// <summary> Gets the blue color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/1F8B4C">1F8B4C</see>.</returns>
         public static readonly Color Blue = new Color(0x3498DB);
-        /// <summary> Gets the dark blue color value </summary>
+        /// <summary> Gets the dark blue color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/3498DB">3498DB</see>.</returns>
         public static readonly Color DarkBlue = new Color(0x206694);
-        /// <summary> Gets the purple color value </summary>
+        /// <summary> Gets the purple color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/206694">206694</see>.</returns>
         public static readonly Color Purple = new Color(0x9B59B6);
-        /// <summary> Gets the dark purple color value </summary>
+        /// <summary> Gets the dark purple color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/9B59B6">9B59B6</see>.</returns>
         public static readonly Color DarkPurple = new Color(0x71368A);
-        /// <summary> Gets the magenta color value </summary>
+        /// <summary> Gets the magenta color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/71368A">71368A</see>.</returns>
         public static readonly Color Magenta = new Color(0xE91E63);
-        /// <summary> Gets the dark magenta color value </summary>
+        /// <summary> Gets the dark magenta color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/E91E63">E91E63</see>.</returns>
         public static readonly Color DarkMagenta = new Color(0xAD1457);
-        /// <summary> Gets the gold color value </summary>
+        /// <summary> Gets the gold color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/AD1457">AD1457</see>.</returns>
         public static readonly Color Gold = new Color(0xF1C40F);
-        /// <summary> Gets the light orange color value </summary>
+        /// <summary> Gets the light orange color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/F1C40F">F1C40F</see>.</returns>
         public static readonly Color LightOrange = new Color(0xC27C0E);
-        /// <summary> Gets the orange color value </summary>
+        /// <summary> Gets the orange color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/C27C0E">C27C0E</see>.</returns>
         public static readonly Color Orange = new Color(0xE67E22);
-        /// <summary> Gets the dark orange color value </summary>
+        /// <summary> Gets the dark orange color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/E67E22">E67E22</see>.</returns>
         public static readonly Color DarkOrange = new Color(0xA84300);
-        /// <summary> Gets the red color value </summary>
+        /// <summary> Gets the red color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/A84300">A84300</see>.</returns>
         public static readonly Color Red = new Color(0xE74C3C);
-        /// <summary> Gets the dark red color value </summary>
+        /// <summary> Gets the dark red color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/E74C3C">E74C3C</see>.</returns>
         public static readonly Color DarkRed = new Color(0x992D22); 
-        /// <summary> Gets the light grey color value </summary>
+        /// <summary> Gets the light grey color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/992D22">992D22</see>.</returns>
         public static readonly Color LightGrey = new Color(0x979C9F);
-        /// <summary> Gets the lighter grey color value </summary>
+        /// <summary> Gets the lighter grey color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/979C9F">979C9F</see>.</returns>
         public static readonly Color LighterGrey = new Color(0x95A5A6);
-        /// <summary> Gets the dark grey color value </summary>
+        /// <summary> Gets the dark grey color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/95A5A6">95A5A6</see>.</returns>
         public static readonly Color DarkGrey = new Color(0x607D8B);
-        /// <summary> Gets the darker grey color value </summary>
+        /// <summary> Gets the darker grey color value. </summary>
+        /// <returns> A color struct with the hex value of <see href="http://www.color-hex.com/color/607D8B">607D8B</see>.</returns>
         public static readonly Color DarkerGrey = new Color(0x546E7A);
 
         /// <summary> Gets the encoded value for this color. </summary>
+        /// <remarks>
+        ///     This value is encoded as an unsigned integer value. The most-significant 8 bits contain the red value,
+        ///     the middle 8 bits contain the green value, and the least-significant 8 bits contain the blue value.
+        /// </remarks>
         public uint RawValue { get; }
 
         /// <summary> Gets the red component for this color. </summary>
@@ -62,10 +88,34 @@ namespace Discord
         /// <summary> Gets the blue component for this color. </summary>
         public byte B => (byte)(RawValue);
 
+        /// <summary>
+        ///     Initializes a <see cref="Color"/> struct with the given raw value.
+        /// </summary>
+        /// <example>
+        ///     The following will create a color that has a hex value of 
+        ///     <see href="http://www.color-hex.com/color/607d8b">#607D8B</see>.
+        ///     <code language="cs">
+        ///     Color darkGrey = new Color(0x607D8B);
+        ///     </code>
+        /// </example>
+        /// <param name="rawValue">The raw value of the color (e.g. <c>0x607D8B</c>).</param>
         public Color(uint rawValue)
         {
             RawValue = rawValue;
         }
+        /// <summary>
+        ///     Initializes a <see cref="Color" /> struct with the given RGB bytes.
+        /// </summary>
+        /// <example>
+        ///     The following will create a color that has a value of 
+        ///     <see href="http://www.color-hex.com/color/607d8b">#607D8B</see>.
+        ///     <code language="cs">
+        ///     Color darkGrey = new Color((byte)0b_01100000, (byte)0b_01111101, (byte)0b_10001011);
+        ///     </code>
+        /// </example>
+        /// <param name="r">The byte that represents the red color.</param>
+        /// <param name="g">The byte that represents the green color.</param>
+        /// <param name="b">The byte that represents the blue color.</param>
         public Color(byte r, byte g, byte b)
         {
             RawValue =
@@ -73,27 +123,56 @@ namespace Discord
                 ((uint)g << 8) |
                 (uint)b;
         }
+
+        /// <summary>
+        ///     Initializes a <see cref="Color"/> struct with the given RGB value.
+        /// </summary>
+        /// <example>
+        ///     The following will create a color that has a value of 
+        ///     <see href="http://www.color-hex.com/color/607d8b">#607D8B</see>.
+        ///     <code language="cs">
+        ///     Color darkGrey = new Color(96, 125, 139);
+        ///     </code>
+        /// </example>
+        /// <param name="r">The value that represents the red color. Must be within 0~255.</param>
+        /// <param name="g">The value that represents the green color. Must be within 0~255.</param>
+        /// <param name="b">The value that represents the blue color. Must be within 0~255.</param>
+        /// <exception cref="ArgumentOutOfRangeException">The argument value is not between 0 to 255.</exception>
         public Color(int r, int g, int b)
         {
             if (r < 0 || r > 255)
-                throw new ArgumentOutOfRangeException(nameof(r), "Value must be within [0,255]");
+                throw new ArgumentOutOfRangeException(nameof(r), "Value must be within [0,255].");
             if (g < 0 || g > 255)
-                throw new ArgumentOutOfRangeException(nameof(g), "Value must be within [0,255]");
+                throw new ArgumentOutOfRangeException(nameof(g), "Value must be within [0,255].");
             if (b < 0 || b > 255)
-                throw new ArgumentOutOfRangeException(nameof(b), "Value must be within [0,255]");
+                throw new ArgumentOutOfRangeException(nameof(b), "Value must be within [0,255].");
             RawValue =
                 ((uint)r << 16) |
                 ((uint)g << 8) |
                 (uint)b;
         }
+        /// <summary>
+        ///     Initializes a <see cref="Color"/> struct with the given RGB float value.
+        /// </summary>
+        /// <example>
+        ///     The following will create a color that has a value of 
+        ///     <see href="http://www.color-hex.com/color/607c8c">#607c8c</see>.
+        ///     <code language="cs">
+        ///     Color darkGrey = new Color(0.38f, 0.49f, 0.55f);
+        ///     </code>
+        /// </example>
+        /// <param name="r">The value that represents the red color. Must be within 0~1.</param>
+        /// <param name="g">The value that represents the green color. Must be within 0~1.</param>
+        /// <param name="b">The value that represents the blue color. Must be within 0~1.</param>
+        /// <exception cref="ArgumentOutOfRangeException">The argument value is not between 0 to 1.</exception>
         public Color(float r, float g, float b)
         {
             if (r < 0.0f || r > 1.0f)
-                throw new ArgumentOutOfRangeException(nameof(r), "Value must be within [0,1]");
+                throw new ArgumentOutOfRangeException(nameof(r), "Value must be within [0,1].");
             if (g < 0.0f || g > 1.0f)
-                throw new ArgumentOutOfRangeException(nameof(g), "Value must be within [0,1]");
+                throw new ArgumentOutOfRangeException(nameof(g), "Value must be within [0,1].");
             if (b < 0.0f || b > 1.0f)
-                throw new ArgumentOutOfRangeException(nameof(b), "Value must be within [0,1]");
+                throw new ArgumentOutOfRangeException(nameof(b), "Value must be within [0,1].");
             RawValue =
                 ((uint)(r * 255.0f) << 16) |
                 ((uint)(g * 255.0f) << 8) |
@@ -118,6 +197,12 @@ namespace Discord
             new Color((uint)color.ToArgb() << 8 >> 8);
 #endif
 
+        /// <summary>
+        ///     Gets the hexadecimal representation of the color (e.g. <c>#000ccc</c>).
+        /// </summary>
+        /// <returns>
+        ///     A hexadecimal string of the color.
+        /// </returns>
         public override string ToString() =>
             $"#{Convert.ToString(RawValue, 16)}";
         private string DebuggerDisplay =>
diff --git a/src/Discord.Net.Core/Entities/Roles/IRole.cs b/src/Discord.Net.Core/Entities/Roles/IRole.cs
index c40e0d716..dcfc89cc6 100644
--- a/src/Discord.Net.Core/Entities/Roles/IRole.cs
+++ b/src/Discord.Net.Core/Entities/Roles/IRole.cs
@@ -1,29 +1,89 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic role object to be given to a guild user.
+    /// </summary>
     public interface IRole : ISnowflakeEntity, IDeletable, IMentionable, IComparable<IRole>
     {
-        /// <summary> Gets the guild owning this role.</summary>
+        /// <summary>
+        ///     Gets the guild that owns this role.
+        /// </summary>
+        /// <returns>
+        ///     A guild representing the parent guild of this role.
+        /// </returns>
         IGuild Guild { get; }
 
-        /// <summary> Gets the color given to users of this role. </summary>
+        /// <summary>
+        ///     Gets the color given to users of this role.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="Color"/> struct representing the color of this role.
+        /// </returns>
         Color Color { get; }
-        /// <summary> Returns true if users of this role are separated in the user list. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the role can be separated in the user list.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if users of this role are separated in the user list; otherwise <c>false</c>.
+        /// </returns>
         bool IsHoisted { get; }
-        /// <summary> Returns true if this role is automatically managed by Discord. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the role is managed by Discord.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this role is automatically managed by Discord; otherwise <c>false</c>.
+        /// </returns>
         bool IsManaged { get; }
-        /// <summary> Returns true if this role may be mentioned in messages. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether the role is mentionable.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this role may be mentioned in messages; otherwise <c>false</c>.
+        /// </returns>
         bool IsMentionable { get; }
-        /// <summary> Gets the name of this role. </summary>
+        /// <summary>
+        ///     Gets the name of this role.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this role.
+        /// </returns>
         string Name { get; }
-        /// <summary> Gets the permissions granted to members of this role. </summary>
+        /// <summary>
+        ///     Gets the permissions granted to members of this role.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="GuildPermissions"/> struct that this role possesses.
+        /// </returns>
         GuildPermissions Permissions { get; }
-        /// <summary> Gets this role's position relative to other roles in the same guild. </summary>
+        /// <summary>
+        ///     Gets this role's position relative to other roles in the same guild.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the position of the role in the role list of the guild.
+        /// </returns>
         int Position { get; }
 
-        ///// <summary> Modifies this role. </summary>
+        /// <summary>
+        ///     Modifies this role.
+        /// </summary>
+        /// <example>
+        ///     <code language="cs">
+        ///     await role.ModifyAsync(x =&gt;
+        ///     {
+        ///         x.Name = "Sonic";
+        ///         x.Color = new Color(0x1A50BC);
+        ///         x.Mentionable = true;
+        ///     });
+        ///     </code>
+        /// </example>
+        /// <param name="func">A delegate containing the properties to modify the role with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
         Task ModifyAsync(Action<RoleProperties> func, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Roles/ReorderRoleProperties.cs b/src/Discord.Net.Core/Entities/Roles/ReorderRoleProperties.cs
index 0c8afa24c..0074c0a3b 100644
--- a/src/Discord.Net.Core/Entities/Roles/ReorderRoleProperties.cs
+++ b/src/Discord.Net.Core/Entities/Roles/ReorderRoleProperties.cs
@@ -1,12 +1,30 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Properties that are used to reorder an <see cref="IRole"/>.
+    /// </summary>
     public class ReorderRoleProperties
     {
-        /// <summary>The id of the role to be edited</summary>
+        /// <summary>
+        ///     Gets the identifier of the role to be edited.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the role to be modified.
+        /// </returns>
         public ulong Id { get; }
-        /// <summary>The new zero-based position of the role.</summary>
+        /// <summary>
+        ///     Gets the new zero-based position of the role.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the new zero-based position of the role.
+        /// </returns>
         public int Position { get; }
 
+        /// <summary>
+        ///     Initializes a <see cref="ReorderRoleProperties" /> with the given role ID and position.
+        /// </summary>
+        /// <param name="id">The ID of the role to be edited.</param>
+        /// <param name="pos">The new zero-based position of the role.</param>
         public ReorderRoleProperties(ulong id, int pos)
         {
             Id = id;
diff --git a/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs b/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
index 8950a2634..df23cf7b1 100644
--- a/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
+++ b/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
@@ -1,57 +1,48 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify an IRole with the specified parameters
+    ///     Properties that are used to modify an <see cref="IRole" /> with the specified changes.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await role.ModifyAsync(x =>
-    /// {
-    ///     x.Color = new Color(180, 15, 40);
-    ///     x.Hoist = true;
-    /// });
-    /// </code>
-    /// </example>
-    /// <seealso cref="IRole"/>
+    /// <seealso cref="IRole.ModifyAsync" />
     public class RoleProperties
     {
         /// <summary>
-        /// The name of the role
+        ///     Gets or sets the name of the role.
         /// </summary>
         /// <remarks>
-        /// If this role is the EveryoneRole, this value may not be set.
+        ///     This value may not be set if the role is an @everyone role.
         /// </remarks>
         public Optional<string> Name { get; set; }
         /// <summary>
-        /// The role's GuildPermissions
+        ///     Gets or sets the role's <see cref="GuildPermission"/>.
         /// </summary>
         public Optional<GuildPermissions> Permissions { get; set; }
         /// <summary>
-        /// The position of the role. This is 0-based!
+        ///     Gets or sets the position of the role. This is 0-based!
         /// </summary>
         /// <remarks>
-        /// If this role is the EveryoneRole, this value may not be set.
+        ///     This value may not be set if the role is an @everyone role.
         /// </remarks>
         public Optional<int> Position { get; set; }
         /// <summary>
-        /// The color of the Role.
+        ///     Gets or sets the color of the role.
         /// </summary>
         /// <remarks>
-        /// If this role is the EveryoneRole, this value may not be set.
+        ///     This value may not be set if the role is an @everyone role.
         /// </remarks>
         public Optional<Color> Color { get; set; }
         /// <summary>
-        /// Whether or not this role should be displayed independently in the userlist.
+        ///     Gets or sets whether or not this role should be displayed independently in the user list.
         /// </summary>
         /// <remarks>
-        /// If this role is the EveryoneRole, this value may not be set.
+        ///     This value may not be set if the role is an @everyone role.
         /// </remarks>
         public Optional<bool> Hoist { get; set; }
         /// <summary>
-        /// Whether or not this role can be mentioned.
+        ///     Gets or sets whether or not this role can be mentioned.
         /// </summary>
         /// <remarks>
-        /// If this role is the EveryoneRole, this value may not be set.
+        ///     This value may not be set if the role is an @everyone role.
         /// </remarks>
         public Optional<bool> Mentionable { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Users/GuildUserProperties.cs b/src/Discord.Net.Core/Entities/Users/GuildUserProperties.cs
index 1c5e5482c..bea26e656 100644
--- a/src/Discord.Net.Core/Entities/Users/GuildUserProperties.cs
+++ b/src/Discord.Net.Core/Entities/Users/GuildUserProperties.cs
@@ -1,70 +1,75 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord
 {
     /// <summary>
-    /// Modify an IGuildUser with the following parameters.
+    ///     Properties that are used to modify an <see cref="IGuildUser" /> with the following parameters.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await (Context.User as IGuildUser)?.ModifyAsync(x =>
-    /// {
-    ///     x.Nickname = $"festive {Context.User.Username}";
-    /// });
-    /// </code>
-    /// </example>
-    /// <seealso cref="IGuildUser"/>
+    /// <seealso cref="IGuildUser.ModifyAsync" />
     public class GuildUserProperties
     {
         /// <summary>
-        /// Should the user be guild-muted in a voice channel?
+        ///     Gets or sets whether the user should be muted in a voice channel.
         /// </summary>
         /// <remarks>
-        /// If this value is set to true, no user will be able to hear this user speak in the guild.
+        ///     If this value is set to <c>true</c>, no user will be able to hear this user speak in the guild.
         /// </remarks>
         public Optional<bool> Mute { get; set; }
         /// <summary>
-        /// Should the user be guild-deafened in a voice channel?
+        ///     Gets or sets whether the user should be deafened in a voice channel.
         /// </summary>
         /// <remarks>
-        /// If this value is set to true, this user will not be able to hear anyone speak in the guild.
+        ///     If this value is set to <c>true</c>, this user will not be able to hear anyone speak in the guild.
         /// </remarks>
         public Optional<bool> Deaf { get; set; }
         /// <summary>
-        /// Should the user have a nickname set? 
+        ///     Gets or sets the user's nickname.
         /// </summary>
         /// <remarks>
-        /// To clear the user's nickname, this value can be set to <see langword="null" /> or <see cref="string.Empty" />.
+        ///     To clear the user's nickname, this value can be set to <c>null</c> or
+        ///     <see cref="string.Empty"/>.
         /// </remarks>
         public Optional<string> Nickname { get; set; }
         /// <summary>
-        /// What roles should the user have?
+        ///     Gets or sets the roles the user should have.
         /// </summary>
         /// <remarks>
-        /// To add a role to a user: <see cref="IGuildUser.AddRolesAsync(IEnumerable&lt;IRole&gt;, RequestOptions)"/>
-        /// To remove a role from a user: <see cref="IGuildUser.RemoveRolesAsync(IEnumerable&lt;IRole&gt;, RequestOptions)"/>
+        ///     <para>
+        ///         To add a role to a user:
+        ///         <see cref="IGuildUser.AddRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        ///     <para>
+        ///         To remove a role from a user:
+        ///         <see cref="IGuildUser.RemoveRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
         /// </remarks>
         public Optional<IEnumerable<IRole>> Roles { get; set; }
         /// <summary>
-        /// What roles should the user have?
+        ///     Gets or sets the roles the user should have.
         /// </summary>
         /// <remarks>
-        /// To add a role to a user: <see cref="IGuildUser.AddRolesAsync(IEnumerable&lt;IRole&gt;, RequestOptions)"/>
-        /// To remove a role from a user: <see cref="IGuildUser.RemoveRolesAsync(IEnumerable&lt;IRole&gt;, RequestOptions)"/>
+        ///     <para>
+        ///         To add a role to a user:
+        ///         <see cref="IGuildUser.AddRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        ///     <para>
+        ///         To remove a role from a user:
+        ///         <see cref="IGuildUser.RemoveRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
         /// </remarks>
         public Optional<IEnumerable<ulong>> RoleIds { get; set; }
         /// <summary>
-        /// Move a user to a voice channel.
+        ///     Moves a user to a voice channel.
         /// </summary>
         /// <remarks>
-        /// This user MUST already be in a Voice Channel for this to work.
+        ///     This user MUST already be in a <see cref="IVoiceChannel"/> for this to work.
         /// </remarks>
         public Optional<IVoiceChannel> Channel { get; set; }
         /// <summary>
-        /// Move a user to a voice channel.
+        ///     Moves a user to a voice channel.
         /// </summary>
         /// <remarks>
-        /// This user MUST already be in a Voice Channel for this to work.
+        ///     This user MUST already be in a <see cref="IVoiceChannel"/> for this to work.
         /// </remarks>
         public Optional<ulong> ChannelId { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Users/IConnection.cs b/src/Discord.Net.Core/Entities/Users/IConnection.cs
index cc981ccf0..1e65d971f 100644
--- a/src/Discord.Net.Core/Entities/Users/IConnection.cs
+++ b/src/Discord.Net.Core/Entities/Users/IConnection.cs
@@ -1,14 +1,27 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord
 {
     public interface IConnection
     {
+        /// <summary> Gets the ID of the connection account. </summary>
+        /// <returns> A <see cref="string"/> representing the unique identifier value of this connection. </returns>
         string Id { get; }
+        /// <summary> Gets the service of the connection (twitch, youtube). </summary>
+        /// <returns> A string containing the name of this type of connection. </returns>
         string Type { get; }
+        /// <summary> Gets the username of the connection account. </summary>
+        /// <returns> A string containing the name of this connection. </returns>
         string Name { get; }
+        /// <summary> Gets whether the connection is revoked. </summary>
+        /// <returns> A value which if true indicates that this connection has been revoked, otherwise false. </returns>
         bool IsRevoked { get; }
 
+        /// <summary> Gets a <see cref="IReadOnlyCollection{T}"/> of integration IDs. </summary>
+        /// <returns>
+        ///     An <see cref="IReadOnlyCollection{T}"/> containing <see cref="ulong"/>
+        ///     representations of unique identifier values of integrations.
+        /// </returns>
         IReadOnlyCollection<ulong> IntegrationIds { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Users/IGroupUser.cs b/src/Discord.Net.Core/Entities/Users/IGroupUser.cs
index dd046a5a8..ecf01f721 100644
--- a/src/Discord.Net.Core/Entities/Users/IGroupUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/IGroupUser.cs
@@ -1,5 +1,8 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a Discord user that is in a group.
+    /// </summary>
     public interface IGroupUser : IUser, IVoiceState
     {
         ///// <summary> Kicks this user from this group. </summary>
diff --git a/src/Discord.Net.Core/Entities/Users/IGuildUser.cs b/src/Discord.Net.Core/Entities/Users/IGuildUser.cs
index 57cad1333..633056733 100644
--- a/src/Discord.Net.Core/Entities/Users/IGuildUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/IGuildUser.cs
@@ -1,41 +1,126 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 
 namespace Discord
 {
-    /// <summary> A Guild-User pairing. </summary>
+    /// <summary>
+    ///     Represents a generic guild user.
+    /// </summary>
     public interface IGuildUser : IUser, IVoiceState
     {
-        /// <summary> Gets when this user joined this guild. </summary>
+        /// <summary>
+        ///     Gets when this user joined the guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset"/> representing the time of which the user has joined the guild; 
+        ///     <c>null</c> when it cannot be obtained.
+        /// </returns>
         DateTimeOffset? JoinedAt { get; }
-        /// <summary> Gets the nickname for this user. </summary>
+        /// <summary>
+        ///     Gets the nickname for this user.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the nickname of the user; <c>null</c> if none is set.
+        /// </returns>
         string Nickname { get; }
-        /// <summary> Gets the guild-level permissions for this user. </summary>
+        /// <summary>
+        ///     Gets the guild-level permissions for this user.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="Discord.GuildPermissions"/> structure for this user, representing what
+        ///     permissions this user has in the guild.
+        /// </returns>
         GuildPermissions GuildPermissions { get; }
 
-        /// <summary> Gets the guild for this user. </summary>
+        /// <summary>
+        ///     Gets the guild for this user.
+        /// </summary>
+        /// <returns>
+        ///     A guild object that this user belongs to.
+        /// </returns>
         IGuild Guild { get; }
-        /// <summary> Gets the id of the guild for this user. </summary>
+        /// <summary>
+        ///     Gets the ID of the guild for this user.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="ulong"/> representing the snowflake identifier of the guild that this user belongs to.
+        /// </returns>
         ulong GuildId { get; }
-        /// <summary> Returns a collection of the ids of the roles this user is a member of in this guild, including the guild's @everyone role. </summary>
+        /// <summary>
+        ///     Gets a collection of IDs for the roles that this user currently possesses in the guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of <see cref="ulong"/>, each representing a snowflake identifier for a role that
+        ///     this user posesses.
+        /// </returns>
         IReadOnlyCollection<ulong> RoleIds { get; }
 
-        /// <summary> Gets the level permissions granted to this user to a given channel. </summary>
+        /// <summary>
+        ///     Gets the level permissions granted to this user to a given channel.
+        /// </summary>
+        /// <param name="channel">The channel to get the permission from.</param>
+        /// <returns>
+        ///     A <see cref="Discord.ChannelPermissions"/> structure representing the permissions that a user has in the
+        ///     specified channel.
+        /// </returns>
         ChannelPermissions GetPermissions(IGuildChannel channel);
 
-        /// <summary> Kicks this user from this guild. </summary>
+        /// <summary>
+        ///     Kicks this user from this guild.
+        /// </summary>
+        /// <param name="reason">The reason for the kick which will be recorded in the audit log.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous kick operation.
+        /// </returns>
         Task KickAsync(string reason = null, RequestOptions options = null);
-        /// <summary> Modifies this user's properties in this guild. </summary>
+        /// <summary>
+        ///     Modifies this user's properties in this guild.
+        /// </summary>
+        /// <param name="func">The delegate containing the properties to modify the user with.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous modification operation.
+        /// </returns>
+        /// <seealso cref="Discord.GuildUserProperties"/>
         Task ModifyAsync(Action<GuildUserProperties> func, RequestOptions options = null);
 
-        /// <summary> Adds a role to this user in this guild. </summary>
+        /// <summary>
+        ///     Adds the specified <paramref name="role"/> to this user in this guild.
+        /// </summary>
+        /// <param name="role">The role to be added to the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous role addition operation.
+        /// </returns>
         Task AddRoleAsync(IRole role, RequestOptions options = null);
-        /// <summary> Adds roles to this user in this guild. </summary>
+        /// <summary>
+        ///     Adds the specified <paramref name="roles"/> to this user in this guild.
+        /// </summary>
+        /// <param name="roles">The roles to be added to the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous role addition operation.
+        /// </returns>
         Task AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null);
-        /// <summary> Removes a role from this user in this guild. </summary>
+        /// <summary>
+        ///     Removes the specified <paramref name="role"/> from this user in this guild.
+        /// </summary>
+        /// <param name="role">The role to be removed from the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous role removal operation.
+        /// </returns>
         Task RemoveRoleAsync(IRole role, RequestOptions options = null);
-        /// <summary> Removes roles from this user in this guild. </summary>
+        /// <summary>
+        ///     Removes the specified <paramref name="roles"/> from this user in this guild.
+        /// </summary>
+        /// <param name="roles">The roles to be removed from the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous role removal operation.
+        /// </returns>
         Task RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Users/IPresence.cs b/src/Discord.Net.Core/Entities/Users/IPresence.cs
index 25adcc9c4..b300115f8 100644
--- a/src/Discord.Net.Core/Entities/Users/IPresence.cs
+++ b/src/Discord.Net.Core/Entities/Users/IPresence.cs
@@ -1,10 +1,17 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents the user's presence status. This may include their online status and their activity.
+    /// </summary>
     public interface IPresence
     {
-        /// <summary> Gets the activity this user is currently doing. </summary>
+        /// <summary>
+        ///     Gets the activity this user is currently doing.
+        /// </summary>
         IActivity Activity { get; }
-        /// <summary> Gets the current status of this user. </summary>
+        /// <summary>
+        ///     Gets the current status of this user.
+        /// </summary>
         UserStatus Status { get; }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Users/ISelfUser.cs b/src/Discord.Net.Core/Entities/Users/ISelfUser.cs
index 7b91d4e3a..c1d7874eb 100644
--- a/src/Discord.Net.Core/Entities/Users/ISelfUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/ISelfUser.cs
@@ -3,15 +3,33 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents the logged-in Discord user.
+    /// </summary>
     public interface ISelfUser : IUser
     {
-        /// <summary> Gets the email associated with this user. </summary>
+        /// <summary>
+        ///     Gets the email associated with this user.
+        /// </summary>
         string Email { get; }
-        /// <summary> Returns true if this user's email has been verified. </summary>
+        /// <summary>
+        ///     Indicates whether or not this user has their email verified.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this user's email has been verified; <c>false</c> if not.
+        /// </returns>
         bool IsVerified { get; }
-        /// <summary> Returns true if this user has enabled MFA on their account. </summary>
+        /// <summary>
+        ///     Indicates whether or not this user has MFA enabled on their account.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this user has enabled multi-factor authentication on their account; <c>false</c> if not.
+        /// </returns>
         bool IsMfaEnabled { get; }
 
+        /// <summary>
+        ///     Modifies the user's properties.
+        /// </summary>
         Task ModifyAsync(Action<SelfUserProperties> func, RequestOptions options = null);
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Entities/Users/IUser.cs b/src/Discord.Net.Core/Entities/Users/IUser.cs
index c5cce7a25..ca9f092e0 100644
--- a/src/Discord.Net.Core/Entities/Users/IUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/IUser.cs
@@ -2,26 +2,62 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic user.
+    /// </summary>
     public interface IUser : ISnowflakeEntity, IMentionable, IPresence
     {
-        /// <summary> Gets the id of this user's avatar. </summary>
+        /// <summary>
+        ///     Gets the ID of this user's avatar.
+        /// </summary>
         string AvatarId { get; }
-        /// <summary> Gets the url to this user's avatar. </summary>
+        /// <summary>
+        ///     Returns a URL to this user's avatar.
+        /// </summary>
+        /// <param name="format">The format to return.</param>
+        /// <param name="size">The size of the image to return in. This can be any power of two between 16 and 2048.</param>
+        /// <returns>
+        ///     User's avatar URL.
+        /// </returns>
         string GetAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128);
-        /// <summary> Gets the url to this user's default avatar. </summary>
+        /// <summary>
+        ///     Returns the URL to this user's default avatar.
+        /// </summary>
         string GetDefaultAvatarUrl();
-        /// <summary> Gets the per-username unique id for this user. </summary>
+        /// <summary>
+        ///     Gets the per-username unique ID for this user.
+        /// </summary>
         string Discriminator { get; }
-        /// <summary> Gets the per-username unique id for this user. </summary>
+        /// <summary>
+        ///     Gets the per-username unique ID for this user.
+        /// </summary>
         ushort DiscriminatorValue { get; }
-        /// <summary> Returns true if this user is a bot user. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this user is a bot user.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the user is a bot; otherwise <c>false</c>.
+        /// </returns>
         bool IsBot { get; }
-        /// <summary> Returns true if this user is a webhook user. </summary>
+        /// <summary>
+        ///     Gets a value that indicates whether this user is a webhook user.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the user is a webhook; otherwise <c>false</c>.
+        /// </returns>
         bool IsWebhook { get; }
-        /// <summary> Gets the username for this user. </summary>
+        /// <summary>
+        ///     Gets the username for this user.
+        /// </summary>
         string Username { get; }
 
-        /// <summary> Returns a private message channel to this user, creating one if it does not already exist. </summary>
+        /// <summary>
+        ///     Returns a direct message channel to this user, or create one if it does not already exist.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for getting or creating a DM channel.
+        /// </returns>
         Task<IDMChannel> GetOrCreateDMChannelAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Users/IVoiceState.cs b/src/Discord.Net.Core/Entities/Users/IVoiceState.cs
index 428601f2a..abe06c3b3 100644
--- a/src/Discord.Net.Core/Entities/Users/IVoiceState.cs
+++ b/src/Discord.Net.Core/Entities/Users/IVoiceState.cs
@@ -1,20 +1,37 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Represents a user's voice connection status.
+    /// </summary>
     public interface IVoiceState
     {
-        /// <summary> Returns true if the guild has deafened this user. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if the guild has deafened this user.
+        /// </summary>
         bool IsDeafened { get; }
-        /// <summary> Returns true if the guild has muted this user. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if the guild has muted this user.
+        /// </summary>
         bool IsMuted { get; }
-        /// <summary> Returns true if this user has marked themselves as deafened. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if this user has marked themselves as deafened.
+        /// </summary>
         bool IsSelfDeafened { get; }
-        /// <summary> Returns true if this user has marked themselves as muted. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if this user has marked themselves as muted.
+        /// </summary>
         bool IsSelfMuted { get; }
-        /// <summary> Returns true if the guild is temporarily blocking audio to/from this user. </summary>
+        /// <summary>
+        ///     Returns <c>true</c> if the guild is temporarily blocking audio to/from this user.
+        /// </summary>
         bool IsSuppressed { get; }
-        /// <summary> Gets the voice channel this user is currently in, if any. </summary>
+        /// <summary>
+        ///     Gets the voice channel this user is currently in, or <c>null</c> if none.
+        /// </summary>
         IVoiceChannel VoiceChannel { get; }
-        /// <summary> Gets the unique identifier for this user's voice session. </summary>
+        /// <summary>
+        ///     Gets the unique identifier for this user's voice session.
+        /// </summary>
         string VoiceSessionId { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Users/IWebhookUser.cs b/src/Discord.Net.Core/Entities/Users/IWebhookUser.cs
index be769b944..7a10c6b6b 100644
--- a/src/Discord.Net.Core/Entities/Users/IWebhookUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/IWebhookUser.cs
@@ -1,7 +1,9 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Represents a Webhook Discord user. </summary>
     public interface IWebhookUser : IGuildUser
     {
+        /// <summary> Gets the ID of a webhook. </summary>
         ulong WebhookId { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Users/SelfUserProperties.cs b/src/Discord.Net.Core/Entities/Users/SelfUserProperties.cs
index 9c4162780..e2ae12ba4 100644
--- a/src/Discord.Net.Core/Entities/Users/SelfUserProperties.cs
+++ b/src/Discord.Net.Core/Entities/Users/SelfUserProperties.cs
@@ -1,25 +1,17 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify the current user with the specified arguments
+    ///     Properties that are used to modify the <see cref="ISelfUser" /> with the specified changes.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await Context.Client.CurrentUser.ModifyAsync(x =>
-    /// {
-    ///     x.Avatar = new Image(File.OpenRead("avatar.jpg"));
-    /// });
-    /// </code>
-    /// </example>
-    /// <seealso cref="ISelfUser"/>
+    /// <seealso cref="ISelfUser.ModifyAsync" />
     public class SelfUserProperties
     {
         /// <summary>
-        /// Your username
+        ///     Gets or sets the username.
         /// </summary>
         public Optional<string> Username { get; set; }
         /// <summary>
-        /// Your avatar
+        ///     Gets or sets the avatar.
         /// </summary>
         public Optional<Image?> Avatar { get; set; }
     }
diff --git a/src/Discord.Net.Core/Entities/Users/UserStatus.cs b/src/Discord.Net.Core/Entities/Users/UserStatus.cs
index 74a52a0fa..09033261e 100644
--- a/src/Discord.Net.Core/Entities/Users/UserStatus.cs
+++ b/src/Discord.Net.Core/Entities/Users/UserStatus.cs
@@ -1,12 +1,33 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Defines the available Discord user status.
+    /// </summary>
     public enum UserStatus
     {
+        /// <summary>
+        ///     The user is offline.
+        /// </summary>
         Offline,
+        /// <summary>
+        ///     The user is online.
+        /// </summary>
         Online,
+        /// <summary>
+        ///     The user is idle.
+        /// </summary>
         Idle,
+        /// <summary>
+        ///     The user is AFK.
+        /// </summary>
         AFK,
+        /// <summary>
+        ///     The user is busy.
+        /// </summary>
         DoNotDisturb,
+        /// <summary>
+        ///     The user is invisible.
+        /// </summary>
         Invisible,
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Webhooks/IWebhook.cs b/src/Discord.Net.Core/Entities/Webhooks/IWebhook.cs
index ef56f72b9..b2d017316 100644
--- a/src/Discord.Net.Core/Entities/Webhooks/IWebhook.cs
+++ b/src/Discord.Net.Core/Entities/Webhooks/IWebhook.cs
@@ -3,32 +3,55 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a webhook object on Discord.
+    /// </summary>
     public interface IWebhook : IDeletable, ISnowflakeEntity
     {
-        /// <summary> Gets the token of this webhook. </summary>
+        /// <summary>
+        ///     Gets the token of this webhook.
+        /// </summary>
         string Token { get; }
 
-        /// <summary> Gets the default name of this webhook. </summary>
+        /// <summary>
+        ///     Gets the default name of this webhook.
+        /// </summary>
         string Name { get; }
-        /// <summary> Gets the id of this webhook's default avatar. </summary>
+        /// <summary>
+        ///     Gets the ID of this webhook's default avatar.
+        /// </summary>
         string AvatarId { get; }
-        /// <summary> Gets the url to this webhook's default avatar. </summary>
+        /// <summary>
+        ///     Gets the URL to this webhook's default avatar.
+        /// </summary>
         string GetAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128);
 
-        /// <summary> Gets the channel for this webhook. </summary>
+        /// <summary>
+        ///     Gets the channel for this webhook.
+        /// </summary>
         ITextChannel Channel { get; }
-        /// <summary> Gets the id of the channel for this webhook. </summary>
+        /// <summary>
+        ///     Gets the ID of the channel for this webhook.
+        /// </summary>
         ulong ChannelId { get; }
 
-        /// <summary> Gets the guild owning this webhook. </summary>
+        /// <summary>
+        ///     Gets the guild owning this webhook.
+        /// </summary>
         IGuild Guild { get; }
-        /// <summary> Gets the id of the guild owning this webhook. </summary>
+        /// <summary>
+        ///     Gets the ID of the guild owning this webhook.
+        /// </summary>
         ulong? GuildId { get; }
 
-        /// <summary> Gets the user that created this webhook. </summary>
+        /// <summary>
+        ///     Gets the user that created this webhook.
+        /// </summary>
         IUser Creator { get; }
 
-        /// <summary> Modifies this webhook. </summary>
+        /// <summary>
+        ///     Modifies this webhook.
+        /// </summary>
         Task ModifyAsync(Action<WebhookProperties> func, RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Webhooks/WebhookProperties.cs b/src/Discord.Net.Core/Entities/Webhooks/WebhookProperties.cs
index 8759a1729..e5ee4d6aa 100644
--- a/src/Discord.Net.Core/Entities/Webhooks/WebhookProperties.cs
+++ b/src/Discord.Net.Core/Entities/Webhooks/WebhookProperties.cs
@@ -1,40 +1,31 @@
-namespace Discord
+namespace Discord
 {
     /// <summary>
-    /// Modify an <see cref="IWebhook"/> with the specified parameters.
+    ///     Properties used to modify an <see cref="IWebhook" /> with the specified changes.
     /// </summary>
-    /// <example>
-    /// <code language="c#">
-    /// await webhook.ModifyAsync(x =>
-    /// {
-    ///     x.Name = "Bob";
-    ///     x.Avatar = new Image("avatar.jpg");
-    /// });
-    /// </code>
-    /// </example>
-    /// <seealso cref="IWebhook"/>
+    /// <seealso cref="IWebhook.ModifyAsync"/>
     public class WebhookProperties
     {
         /// <summary>
-        /// The default name of the webhook.
+        ///     Gets or sets the default name of the webhook.
         /// </summary>
         public Optional<string> Name { get; set; }
         /// <summary>
-        /// The default avatar of the webhook.
+        ///     Gets or sets the default avatar of the webhook.
         /// </summary>
         public Optional<Image?> Image { get; set; }
         /// <summary>
-        /// The channel for this webhook.
+        ///     Gets or sets the channel for this webhook.
         /// </summary>
         /// <remarks>
-        /// This field is not used when authenticated with <see cref="TokenType.Webhook"/>.
+        ///     This field is not used when authenticated with <see cref="Discord.TokenType.Webhook"/>.
         /// </remarks>
         public Optional<ITextChannel> Channel { get; set; }
         /// <summary>
-        /// The channel id for this webhook.
+        ///     Gets or sets the channel ID for this webhook.
         /// </summary>
         /// <remarks>
-        /// This field is not used when authenticated with <see cref="TokenType.Webhook"/>.
+        ///     This field is not used when authenticated with <see cref="Discord.TokenType.Webhook"/>.
         /// </remarks>
         public Optional<ulong> ChannelId { get; set; }
     }
diff --git a/src/Discord.Net.Core/Extensions/AsyncEnumerableExtensions.cs b/src/Discord.Net.Core/Extensions/AsyncEnumerableExtensions.cs
index dd16d2943..56ed68cfe 100644
--- a/src/Discord.Net.Core/Extensions/AsyncEnumerableExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/AsyncEnumerableExtensions.cs
@@ -4,19 +4,15 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary> An extension class for squashing <see cref="IAsyncEnumerable{T}"/>. </summary>
     public static class AsyncEnumerableExtensions
     {
-        /// <summary>
-        /// Flattens the specified pages into one <see cref="IEnumerable{T}"/> asynchronously
-        /// </summary>
-        /// <typeparam name="T"></typeparam>
-        /// <param name="source"></param>
-        /// <returns></returns>
+        /// <summary> Flattens the specified pages into one <see cref="IEnumerable{T}"/> asynchronously. </summary>
         public static async Task<IEnumerable<T>> FlattenAsync<T>(this IAsyncEnumerable<IEnumerable<T>> source)
         {
             return await source.Flatten().ToArray().ConfigureAwait(false);
         }
-
+        /// <summary> Flattens the specified pages into one <see cref="IAsyncEnumerable{T}"/>. </summary>
         public static IAsyncEnumerable<T> Flatten<T>(this IAsyncEnumerable<IEnumerable<T>> source)
         {
             return source.SelectMany(enumerable => enumerable.ToAsyncEnumerable());
diff --git a/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs b/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
index 81cd10b49..6ebdbac6e 100644
--- a/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/DiscordClientExtensions.cs
@@ -1,24 +1,31 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary> An extension class for the Discord client. </summary>
     public static class DiscordClientExtensions
     {
+        /// <summary> Gets the private channel with the provided ID. </summary>
         public static async Task<IPrivateChannel> GetPrivateChannelAsync(this IDiscordClient client, ulong id)
             => await client.GetChannelAsync(id).ConfigureAwait(false) as IPrivateChannel;
 
+        /// <summary> Gets the DM channel with the provided ID. </summary>
         public static async Task<IDMChannel> GetDMChannelAsync(this IDiscordClient client, ulong id)
             => await client.GetPrivateChannelAsync(id).ConfigureAwait(false) as IDMChannel;
+        /// <summary> Gets all available DM channels for the client. </summary>
         public static async Task<IEnumerable<IDMChannel>> GetDMChannelsAsync(this IDiscordClient client)
             => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).OfType<IDMChannel>();
 
+        /// <summary> Gets the group channel with the provided ID. </summary>
         public static async Task<IGroupChannel> GetGroupChannelAsync(this IDiscordClient client, ulong id)
             => await client.GetPrivateChannelAsync(id).ConfigureAwait(false) as IGroupChannel;
+        /// <summary> Gets all available group channels for the client. </summary>
         public static async Task<IEnumerable<IGroupChannel>> GetGroupChannelsAsync(this IDiscordClient client)
             => (await client.GetPrivateChannelsAsync().ConfigureAwait(false)).OfType<IGroupChannel>();
 
+        /// <summary> Gets the most optimal voice region for the client. </summary>
         public static async Task<IVoiceRegion> GetOptimalVoiceRegionAsync(this IDiscordClient discord)
         {
             var regions = await discord.GetVoiceRegionsAsync().ConfigureAwait(false);
diff --git a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
index 2eb4ed473..2d72dc985 100644
--- a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
@@ -2,26 +2,37 @@ using System;
 
 namespace Discord
 {
+    /// <summary> An extension class for building an embed. </summary>
     public static class EmbedBuilderExtensions
     {
+        /// <summary> Adds embed color based on the provided raw value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, uint rawValue) =>
             builder.WithColor(new Color(rawValue));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="byte"/> value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, byte r, byte g, byte b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="int"/> value. </summary>
+        /// <exception cref="ArgumentOutOfRangeException">The argument value is not between 0 to 255.</exception>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, int r, int g, int b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="float"/> value. </summary>
+        /// <exception cref="ArgumentOutOfRangeException">The argument value is not between 0 to 1.</exception>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, float r, float g, float b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Fills the embed author field with the provided user's full username and avatar URL. </summary>
         public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IUser user) =>
             builder.WithAuthor($"{user.Username}#{user.Discriminator}", user.GetAvatarUrl());
 
+        /// <summary> Fills the embed author field with the provided user's nickname and avatar URL; username is used if nickname is not set. </summary>
         public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IGuildUser user) =>
             builder.WithAuthor($"{user.Nickname ?? user.Username}#{user.Discriminator}", user.GetAvatarUrl());
 
+        /// <summary> Converts a <see cref="EmbedType.Rich"/> <see cref="IEmbed"/> object to a <see cref="EmbedBuilder"/>. </summary>
+        /// <exception cref="InvalidOperationException">The embed type is not <see cref="EmbedType.Rich"/>.</exception>
         public static EmbedBuilder ToEmbedBuilder(this IEmbed embed)
         {
             if (embed.Type != EmbedType.Rich)
diff --git a/src/Discord.Net.Core/Extensions/MessageExtensions.cs b/src/Discord.Net.Core/Extensions/MessageExtensions.cs
index c53ef9053..90185cb6d 100644
--- a/src/Discord.Net.Core/Extensions/MessageExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/MessageExtensions.cs
@@ -1,7 +1,17 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Provides extension methods for <see cref="IMessage" />.
+    /// </summary>
     public static class MessageExtensions
     {
+        /// <summary>
+        ///     Gets a URL that jumps to the message.
+        /// </summary>
+        /// <param name="msg">The message to jump to.</param>
+        /// <returns>
+        ///     A string that contains a URL for jumping to the message in chat.
+        /// </returns>
         public static string GetJumpUrl(this IMessage msg)
         {
             var channel = msg.Channel;
diff --git a/src/Discord.Net.Core/Extensions/UserExtensions.cs b/src/Discord.Net.Core/Extensions/UserExtensions.cs
index 951e8ca4b..f98bf7227 100644
--- a/src/Discord.Net.Core/Extensions/UserExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/UserExtensions.cs
@@ -1,13 +1,36 @@
+using System;
 using System.Threading.Tasks;
 using System.IO;
 
 namespace Discord
 {
+    /// <summary> An extension class for various Discord user objects. </summary>
     public static class UserExtensions
     {
         /// <summary>
-        /// Sends a message to the user via DM.
+        ///     Sends a message via DM.
         /// </summary>
+        /// <remarks>
+        ///     This method attempts to send a direct-message to the user.
+        ///     <note type="warning">
+        ///         <para>
+        ///         Please note that this method <strong>will</strong> throw an <see cref="Discord.Net.HttpException"/>
+        ///         if the user cannot receive DMs due to privacy reasons or if the user has the sender blocked.
+        ///         </para>
+        ///         <para>
+        ///         You may want to consider catching for <see cref="Discord.Net.HttpException.DiscordCode"/> 
+        ///         <c>50007</c> when using this method.
+        ///         </para>
+        ///     </note>
+        /// </remarks>
+        /// <param name="user">The user to send the DM to.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous send operation. The task result contains the sent message.
+        /// </returns>
         public static async Task<IUserMessage> SendMessageAsync(this IUser user,
             string text = null,
             bool isTTS = false,
@@ -18,8 +41,45 @@ namespace Discord
         }
 
         /// <summary>
-        /// Sends a file to the user via DM.
+        ///     Sends a file to this message channel with an optional caption.
         /// </summary>
+        /// <example>
+        ///     The following example uploads a streamed image that will be called <c>b1nzy.jpg</c> embedded inside a
+        ///     rich embed to the channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync(b1nzyStream, "b1nzy.jpg",
+        ///         embed: new EmbedBuilder {ImageUrl = "attachment://b1nzy.jpg"}.Build());
+        ///     </code>
+        /// </example>
+        /// <remarks>
+        ///     This method attempts to send an attachment as a direct-message to the user.
+        ///     <note type="warning">
+        ///         <para>
+        ///         Please note that this method <strong>will</strong> throw an <see cref="Discord.Net.HttpException"/>
+        ///         if the user cannot receive DMs due to privacy reasons or if the user has the sender blocked.
+        ///         </para>
+        ///         <para>
+        ///         You may want to consider catching for <see cref="Discord.Net.HttpException.DiscordCode"/> 
+        ///         <c>50007</c> when using this method.
+        ///         </para>
+        ///     </note>
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/> embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>. See the example section for its usage.
+        ///     </note>
+        /// </remarks>
+        /// <param name="user">The user to send the DM to.</param>
+        /// <param name="stream">The <see cref="Stream"/> of the file to be sent.</param>
+        /// <param name="filename">The name of the attachment.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         public static async Task<IUserMessage> SendFileAsync(this IUser user,
             Stream stream,
             string filename,
@@ -33,8 +93,50 @@ namespace Discord
         }
 
         /// <summary>
-        /// Sends a file to the user via DM.
+        ///     Sends a file via DM with an optional caption.
         /// </summary>
+        /// <example>
+        ///     The following example uploads a local file called <c>wumpus.txt</c> along with the text 
+        ///     <c>good discord boi</c> to the channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync("wumpus.txt", "good discord boi");
+        ///     </code>
+        /// 
+        ///     The following example uploads a local image called <c>b1nzy.jpg</c> embedded inside a rich embed to the
+        ///     channel.
+        ///     <code language="cs">
+        ///     await channel.SendFileAsync("b1nzy.jpg",
+        ///         embed: new EmbedBuilder {ImageUrl = "attachment://b1nzy.jpg"}.Build());
+        ///     </code>
+        /// </example>
+        /// <remarks>
+        ///     This method attempts to send an attachment as a direct-message to the user.
+        ///     <note type="warning">
+        ///         <para>
+        ///         Please note that this method <strong>will</strong> throw an <see cref="Discord.Net.HttpException"/>
+        ///         if the user cannot receive DMs due to privacy reasons or if the user has the sender blocked.
+        ///         </para>
+        ///         <para>
+        ///         You may want to consider catching for <see cref="Discord.Net.HttpException.DiscordCode"/> 
+        ///         <c>50007</c> when using this method.
+        ///         </para>
+        ///     </note>
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/> embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>. See the example section for its usage.
+        ///     </note>
+        /// </remarks>
+        /// <param name="user">The user to send the DM to.</param>
+        /// <param name="filePath">The file path of the file.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         public static async Task<IUserMessage> SendFileAsync(this IUser user,
             string filePath,
             string text = null,
@@ -45,6 +147,17 @@ namespace Discord
             return await (await user.GetOrCreateDMChannelAsync().ConfigureAwait(false)).SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
         }
 
+        /// <summary>
+        ///     Bans the user from the guild and optionally prunes their recent messages.
+        /// </summary>
+        /// <param name="user">The user to ban.</param>
+        /// <param name="pruneDays">The number of days to remove messages from this <paramref name="user"/> for - must be between [0, 7]</param>
+        /// <param name="reason">The reason of the ban to be written in the audit log.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentException"><paramref name="pruneDays" /> is not between 0 to 7.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for banning a user.
+        /// </returns>
         public static Task BanAsync(this IGuildUser user, int pruneDays = 0, string reason = null, RequestOptions options = null)
             => user.Guild.AddBanAsync(user, pruneDays, reason, options);
     }
diff --git a/src/Discord.Net.Core/Format.cs b/src/Discord.Net.Core/Format.cs
index 414e00a29..0b16daeb1 100644
--- a/src/Discord.Net.Core/Format.cs
+++ b/src/Discord.Net.Core/Format.cs
@@ -1,5 +1,6 @@
 namespace Discord
 {
+    /// <summary> A helper class for formatting characters. </summary>
     public static class Format
     {
         // Characters which need escaping
diff --git a/src/Discord.Net.Core/IDiscordClient.cs b/src/Discord.Net.Core/IDiscordClient.cs
index a383c37da..d6a863556 100644
--- a/src/Discord.Net.Core/IDiscordClient.cs
+++ b/src/Discord.Net.Core/IDiscordClient.cs
@@ -5,38 +5,274 @@ using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a generic Discord client.
+    /// </summary>
     public interface IDiscordClient : IDisposable
     {
+        /// <summary>
+        ///     Gets the current state of connection.
+        /// </summary>
         ConnectionState ConnectionState { get; }
+        /// <summary>
+        ///     Gets the currently logged-in user.
+        /// </summary>
         ISelfUser CurrentUser { get; }
+        /// <summary>
+        ///     Gets the token type of the logged-in user.
+        /// </summary>
         TokenType TokenType { get; }
 
+        /// <summary>
+        ///     Starts the connection between Discord and the client..
+        /// </summary>
+        /// <remarks>
+        ///     This method will initialize the connection between the client and Discord.
+        ///     <note type="important">
+        ///         This method will immediately return after it is called, as it will initialize the connection on
+        ///         another thread.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A task that represents the asynchronous start operation.
+        /// </returns>
         Task StartAsync();
+        /// <summary>
+        ///     Stops the connection between Discord and the client.
+        /// </summary>
+        /// <returns>
+        ///     A task that represents the asynchronous stop operation.
+        /// </returns>
         Task StopAsync();
 
+        /// <summary>
+        ///     Gets a Discord application information for the logged-in user.
+        /// </summary>
+        /// <remarks>
+        ///     This method reflects your application information you submitted when creating a Discord application via
+        ///     the Developer Portal.
+        /// </remarks>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the application
+        ///     information.
+        /// </returns>
         Task<IApplication> GetApplicationInfoAsync(RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a generic channel.
+        /// </summary>
+        /// <example>
+        ///     <code lang="cs" title="Example method">
+        ///     var channel = await _client.GetChannelAsync(381889909113225237);
+        ///     if (channel != null &amp;&amp; channel is IMessageChannel msgChannel)
+        ///     {
+        ///         await msgChannel.SendMessageAsync($"{msgChannel} is created at {msgChannel.CreatedAt}");
+        ///     }
+        ///     </code>
+        /// </example>
+        /// <param name="id">The snowflake identifier of the channel (e.g. `381889909113225237`).</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the channel associated
+        ///     with the snowflake identifier; <c>null</c> when the channel cannot be found.
+        /// </returns>
         Task<IChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of private channels opened in this session.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <remarks>
+        ///     This method will retrieve all private channels (including direct-message, group channel and such) that
+        ///     are currently opened in this session.
+        ///     <note type="warning">
+        ///         This method will not return previously opened private channels outside of the current session! If
+        ///         you have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of private channels that the user currently partakes in.
+        /// </returns>
         Task<IReadOnlyCollection<IPrivateChannel>> GetPrivateChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of direct message channels opened in this session.
+        /// </summary>
+        /// <remarks>
+        ///     This method returns a collection of currently opened direct message channels.
+        ///     <note type="warning">
+        ///         This method will not return previously opened DM channels outside of the current session! If you
+        ///         have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of direct-message channels that the user currently partakes in.
+        /// </returns>
         Task<IReadOnlyCollection<IDMChannel>> GetDMChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of group channels opened in this session.
+        /// </summary>
+        /// <remarks>
+        ///     This method returns a collection of currently opened group channels.
+        ///     <note type="warning">
+        ///         This method will not return previously opened group channels outside of the current session! If you
+        ///         have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of group channels that the user currently partakes in.
+        /// </returns>
         Task<IReadOnlyCollection<IGroupChannel>> GetGroupChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets the connections that the user has set up.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of connections.
+        /// </returns>
         Task<IReadOnlyCollection<IConnection>> GetConnectionsAsync(RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a guild.
+        /// </summary>
+        /// <param name="id">The guild snowflake identifier.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the guild associated
+        ///     with the snowflake identifier; <c>null</c> when the guild cannot be found.
+        /// </returns>
         Task<IGuild> GetGuildAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of guilds that the user is currently in.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of guilds that the current user is in.
+        /// </returns>
         Task<IReadOnlyCollection<IGuild>> GetGuildsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Creates a guild for the logged-in user who is in less than 10 active guilds.
+        /// </summary>
+        /// <remarks>
+        ///     This method creates a new guild on behalf of the logged-in user.
+        ///     <note type="warning">
+        ///         Due to Discord's limitation, this method will only work for users that are in less than 10 guilds.
+        ///     </note>
+        /// </remarks>
+        /// <param name="name">The name of the new guild.</param>
+        /// <param name="region">The voice region to create the guild with.</param>
+        /// <param name="jpegIcon">The icon of the guild.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the created guild.
+        /// </returns>
         Task<IGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null);
-        
+
+        /// <summary>
+        ///     Gets an invite.
+        /// </summary>
+        /// <param name="inviteId">The invitation identifier.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the invite information.
+        /// </returns>
         Task<IInvite> GetInviteAsync(string inviteId, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a user.
+        /// </summary>
+        /// <example>
+        ///     <code lang="cs" title="Example method">
+        ///     var user = await _client.GetUserAsync(168693960628371456);
+        ///     if (user != null)
+        ///         Console.WriteLine($"{user} is created at {user.CreatedAt}.";
+        ///     </code>
+        /// </example>
+        /// <param name="id">The snowflake identifier of the user (e.g. `168693960628371456`).</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the user associated with
+        ///     the snowflake identifier; <c>null</c> if the user is not found.
+        /// </returns>
         Task<IUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a user.
+        /// </summary>
+        /// <example>
+        ///     <code lang="cs" title="Example method">
+        ///    var user = await _client.GetUserAsync("Still", "2876");
+        ///    if (user != null)
+        ///        Console.WriteLine($"{user} is created at {user.CreatedAt}.";
+        ///    </code>
+        /// </example>
+        /// <param name="username">The name of the user (e.g. `Still`).</param>
+        /// <param name="discriminator">The discriminator value of the user (e.g. `2876`).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the user associated with
+        ///     the name and the discriminator; <c>null</c> if the user is not found.
+        /// </returns>
         Task<IUser> GetUserAsync(string username, string discriminator, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a collection of the available voice regions.
+        /// </summary>
+        /// <example>
+        ///     The following example gets the most optimal voice region from the collection.
+        ///     <code lang="cs">
+        ///         var regions = await client.GetVoiceRegionsAsync();
+        ///         var optimalRegion = regions.FirstOrDefault(x =&gt; x.IsOptimal);
+        ///     </code>
+        /// </example>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     with all of the available voice regions in this session.
+        /// </returns>
         Task<IReadOnlyCollection<IVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null);
+        /// <summary>
+        ///     Gets a voice region.
+        /// </summary>
+        /// <param name="id">The identifier of the voice region (e.g. <c>eu-central</c> ).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the voice region
+        ///     associated with the identifier; <c>null</c> if the voice region is not found.
+        /// </returns>
         Task<IVoiceRegion> GetVoiceRegionAsync(string id, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a webhook available.
+        /// </summary>
+        /// <param name="id">The identifier of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a webhook associated
+        ///     with the identifier; <c>null</c> if the webhook is not found.
+        /// </returns>
         Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets the recommended shard count as suggested by Discord.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains an <see cref="Int32"/>
+        ///     that represents the number of shards that should be used with this account.
+        /// </returns>
         Task<int> GetRecommendedShardCountAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Core/Logging/LogManager.cs b/src/Discord.Net.Core/Logging/LogManager.cs
index a69519fa2..a99c45b39 100644
--- a/src/Discord.Net.Core/Logging/LogManager.cs
+++ b/src/Discord.Net.Core/Logging/LogManager.cs
@@ -24,7 +24,10 @@ namespace Discord.Logging
                 if (severity <= Level)
                     await _messageEvent.InvokeAsync(new LogMessage(severity, source, null, ex)).ConfigureAwait(false);
             }
-            catch { }
+            catch
+            {
+                // ignored
+            }
         }
         public async Task LogAsync(LogSeverity severity, string source, string message, Exception ex = null)
         {
@@ -33,7 +36,10 @@ namespace Discord.Logging
                 if (severity <= Level)
                 await _messageEvent.InvokeAsync(new LogMessage(severity, source, message, ex)).ConfigureAwait(false);
             }
-            catch { }
+            catch
+            {
+                // ignored
+            }
         }
 
         public async Task LogAsync(LogSeverity severity, string source, FormattableString message, Exception ex = null)
diff --git a/src/Discord.Net.Core/Logging/LogMessage.cs b/src/Discord.Net.Core/Logging/LogMessage.cs
index d1b3782be..715cac677 100644
--- a/src/Discord.Net.Core/Logging/LogMessage.cs
+++ b/src/Discord.Net.Core/Logging/LogMessage.cs
@@ -1,15 +1,50 @@
-using System;
+using System;
 using System.Text;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Provides a message object used for logging purposes.
+    /// </summary>
     public struct LogMessage
     {
+        /// <summary>
+        ///     Gets the severity of the log entry.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="LogSeverity"/> enum to indicate the severeness of the incident or event.
+        /// </returns>
         public LogSeverity Severity { get; }
+        /// <summary>
+        ///     Gets the source of the log entry.
+        /// </summary>
+        /// <returns>
+        ///     A string representing the source of the log entry.
+        /// </returns>
         public string Source { get; }
+        /// <summary>
+        ///     Gets the message of this log entry.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the message of this log entry.
+        /// </returns>
         public string Message { get; }
+        /// <summary>
+        ///     Gets the exception of this log entry.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="Discord.LogMessage.Exception" /> object associated with an incident; otherwise <c>null</c>.
+        /// </returns>
         public Exception Exception { get; }
 
+        /// <summary>
+        ///     Initializes a new <see cref="LogMessage"/> struct with the severity, source, message of the event, and
+        ///     optionally, an exception.
+        /// </summary>
+        /// <param name="severity">The severity of the event.</param>
+        /// <param name="source">The source of the event.</param>
+        /// <param name="message">The message of the event.</param>
+        /// <param name="exception">The exception of the event.</param>
         public LogMessage(LogSeverity severity, string source, string message, Exception exception = null)
         {
             Severity = severity;
@@ -17,8 +52,8 @@ namespace Discord
             Message = message;
             Exception = exception;
         }
-
-        public override string ToString() => ToString(null);
+        
+        public override string ToString() => ToString();
         public string ToString(StringBuilder builder = null, bool fullException = true, bool prependTimestamp = true, DateTimeKind timestampKind = DateTimeKind.Local, int? padSource = 11)
         {
             string sourceName = Source;
diff --git a/src/Discord.Net.Core/Logging/LogSeverity.cs b/src/Discord.Net.Core/Logging/LogSeverity.cs
index 785b0ef46..f9b518c17 100644
--- a/src/Discord.Net.Core/Logging/LogSeverity.cs
+++ b/src/Discord.Net.Core/Logging/LogSeverity.cs
@@ -1,12 +1,34 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary>
+    ///     Specifies the severity of the log message.
+    /// </summary>
     public enum LogSeverity
     {
+        /// <summary>
+        ///     Logs that contain the most severe level of error. This type of error indicate that immediate attention
+        ///     may be required.
+        /// </summary>
         Critical = 0,
+        /// <summary>
+        ///     Logs that highlight when the flow of execution is stopped due to a failure.
+        /// </summary>
         Error = 1,
+        /// <summary>
+        ///     Logs that highlight an abnormal activity in the flow of execution.
+        /// </summary>
         Warning = 2,
+        /// <summary>
+        ///     Logs that track the general flow of the application.
+        /// </summary>
         Info = 3,
+        /// <summary>
+        ///     Logs that are used for interactive investigation during development.
+        /// </summary>
         Verbose = 4,
+        /// <summary>
+        ///     Logs that contain the most detailed messages.
+        /// </summary>
         Debug = 5
     }
 }
diff --git a/src/Discord.Net.Core/LoginState.cs b/src/Discord.Net.Core/LoginState.cs
index 42b6ecac9..49f86c9fa 100644
--- a/src/Discord.Net.Core/LoginState.cs
+++ b/src/Discord.Net.Core/LoginState.cs
@@ -1,10 +1,15 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> Specifies the state of the client's login status. </summary>
     public enum LoginState : byte
     {
+        /// <summary> The client is currently logged out. </summary>
         LoggedOut,
+        /// <summary> The client is currently logging in. </summary>
         LoggingIn,
+        /// <summary> The client is currently logged in. </summary>
         LoggedIn,
+        /// <summary> The client is currently logging out. </summary>
         LoggingOut
     }
 }
diff --git a/src/Discord.Net.Core/Net/HttpException.cs b/src/Discord.Net.Core/Net/HttpException.cs
index d0ee65b23..d36bd66f9 100644
--- a/src/Discord.Net.Core/Net/HttpException.cs
+++ b/src/Discord.Net.Core/Net/HttpException.cs
@@ -3,13 +3,45 @@ using System.Net;
 
 namespace Discord.Net
 {
+    /// <summary>
+    ///     The exception that is thrown if an error occurs while processing an Discord HTTP request.
+    /// </summary>
     public class HttpException : Exception
     {
+        /// <summary>
+        ///     Gets the HTTP status code returned by Discord.
+        /// </summary>
+        /// <returns>
+        ///     An 
+        ///     <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#http">HTTP status code</see>
+        ///     from Discord.
+        /// </returns>
         public HttpStatusCode HttpCode { get; }
+        /// <summary>
+        ///     Gets the JSON error code returned by Discord.
+        /// </summary>
+        /// <returns>
+        ///     A 
+        ///     <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#json">JSON error code</see>
+        ///     from Discord, or <c>null</c> if none.
+        /// </returns>
         public int? DiscordCode { get; }
+        /// <summary>
+        ///     Gets the reason of the exception.
+        /// </summary>
         public string Reason { get; }
+        /// <summary>
+        ///     Gets the request object used to send the request.
+        /// </summary>
         public IRequest Request { get; }
 
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="HttpException" /> class.
+        /// </summary>
+        /// <param name="httpCode">The HTTP status code returned.</param>
+        /// <param name="request">The request that was sent prior to the exception.</param>
+        /// <param name="discordCode">The Discord status code returned.</param>
+        /// <param name="reason">The reason behind the exception.</param>
         public HttpException(HttpStatusCode httpCode, IRequest request, int? discordCode = null, string reason = null)
             : base(CreateMessage(httpCode, discordCode, reason))
         {
diff --git a/src/Discord.Net.Core/Net/IRequest.cs b/src/Discord.Net.Core/Net/IRequest.cs
index d3c708dd5..1f23e65cd 100644
--- a/src/Discord.Net.Core/Net/IRequest.cs
+++ b/src/Discord.Net.Core/Net/IRequest.cs
@@ -2,6 +2,9 @@ using System;
 
 namespace Discord.Net
 {
+    /// <summary>
+    ///     Represents a generic request to be sent to Discord.
+    /// </summary>
     public interface IRequest
     {
         DateTimeOffset? TimeoutAt { get; }
diff --git a/src/Discord.Net.Core/Net/RateLimitedException.cs b/src/Discord.Net.Core/Net/RateLimitedException.cs
index 2d34d7bc2..c19487fad 100644
--- a/src/Discord.Net.Core/Net/RateLimitedException.cs
+++ b/src/Discord.Net.Core/Net/RateLimitedException.cs
@@ -2,10 +2,20 @@ using System;
 
 namespace Discord.Net
 {
+    /// <summary>
+    ///     The exception that is thrown when the user is being rate limited by Discord.
+    /// </summary>
     public class RateLimitedException : TimeoutException
     {
+        /// <summary>
+        ///     Gets the request object used to send the request.
+        /// </summary>
         public IRequest Request { get; }
 
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="RateLimitedException" /> class using the
+        ///     <paramref name="request"/> sent.
+        /// </summary>
         public RateLimitedException(IRequest request)
             : base("You are being rate limited.")
         {
diff --git a/src/Discord.Net.Core/Net/Rest/IRestClient.cs b/src/Discord.Net.Core/Net/Rest/IRestClient.cs
index addfa9061..2e30d2ef4 100644
--- a/src/Discord.Net.Core/Net/Rest/IRestClient.cs
+++ b/src/Discord.Net.Core/Net/Rest/IRestClient.cs
@@ -4,11 +4,32 @@ using System.Threading.Tasks;
 
 namespace Discord.Net.Rest
 {
+    /// <summary>
+    ///     Represents a generic REST-based client.
+    /// </summary>
     public interface IRestClient
     {
+        /// <summary>
+        ///     Sets the HTTP header of this client for all requests.
+        /// </summary>
+        /// <param name="key">The field name of the header.</param>
+        /// <param name="value">The value of the header.</param>
         void SetHeader(string key, string value);
+        /// <summary>
+        ///     Sets the cancellation token for this client.
+        /// </summary>
+        /// <param name="cancelToken">The cancellation token.</param>
         void SetCancelToken(CancellationToken cancelToken);
 
+        /// <summary>
+        /// Sends a REST request.
+        /// </summary>
+        /// <param name="method">The method used to send this request (i.e. HTTP verb such as <c>GET</c>, <c>POST</c>).</param>
+        /// <param name="endpoint">The endpoint to send this request to.</param>
+        /// <param name="cancelToken">The cancellation token used to cancel the task.</param>
+        /// <param name="headerOnly">Indicates whether to send the header only.</param>
+        /// <param name="reason">The audit log reason.</param>
+        /// <returns></returns>
         Task<RestResponse> SendAsync(string method, string endpoint, CancellationToken cancelToken, bool headerOnly = false, string reason = null);
         Task<RestResponse> SendAsync(string method, string endpoint, string json, CancellationToken cancelToken, bool headerOnly = false, string reason = null);
         Task<RestResponse> SendAsync(string method, string endpoint, IReadOnlyDictionary<string, object> multipartParams, CancellationToken cancelToken, bool headerOnly = false, string reason = null);
diff --git a/src/Discord.Net.Core/Net/WebSocketClosedException.cs b/src/Discord.Net.Core/Net/WebSocketClosedException.cs
index d647b6c8c..6e2564f6e 100644
--- a/src/Discord.Net.Core/Net/WebSocketClosedException.cs
+++ b/src/Discord.Net.Core/Net/WebSocketClosedException.cs
@@ -1,11 +1,29 @@
-using System;
+using System;
 namespace Discord.Net
 {
+    /// <summary>
+    ///     The exception that is thrown when the WebSocket session is closed by Discord.
+    /// </summary>
     public class WebSocketClosedException : Exception
     {
+        /// <summary>
+        ///     Gets the close code sent by Discord.
+        /// </summary>
+        /// <returns>
+        ///     A 
+        ///     <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-close-event-codes">close code</see>
+        ///     from Discord.
+        /// </returns>
         public int CloseCode { get; }
+        /// <summary>
+        ///     Gets the reason of the interruption.
+        /// </summary>
         public string Reason { get; }
 
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="WebSocketClosedException" /> using a Discord close code
+        ///     and an optional reason.
+        /// </summary>
         public WebSocketClosedException(int closeCode, string reason = null)
             : base($"The server sent close {closeCode}{(reason != null ? $": \"{reason}\"" : "")}")
         {
diff --git a/src/Discord.Net.Core/RequestOptions.cs b/src/Discord.Net.Core/RequestOptions.cs
index 40f0ebaa4..3af3ded6f 100644
--- a/src/Discord.Net.Core/RequestOptions.cs
+++ b/src/Discord.Net.Core/RequestOptions.cs
@@ -2,21 +2,47 @@ using System.Threading;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents options that should be used when sending a request.
+    /// </summary>
     public class RequestOptions
     {
+        /// <summary>
+        ///     Creates a new <see cref="RequestOptions" /> class with its default settings.
+        /// </summary>
         public static RequestOptions Default => new RequestOptions();
 
-        /// <summary> 
-        /// The max time, in milliseconds, to wait for this request to complete. If null, a request will not time out. 
-        /// If a rate limit has been triggered for this request's bucket and will not be unpaused in time, this request will fail immediately. 
+        /// <summary>
+        ///     Gets or sets the maximum time to wait for for this request to complete.
         /// </summary>
+        /// <remarks>
+        ///     Gets or set the max time, in milliseconds, to wait for for this request to complete. If 
+        ///     <c>null</c>, a request will not time out. If a rate limit has been triggered for this request's bucket
+        ///     and will not be unpaused in time, this request will fail immediately.
+        /// </remarks>
+        /// <returns>
+        ///     A <see cref="int"/> in milliseconds for when the request times out.
+        /// </returns>
         public int? Timeout { get; set; }
+        /// <summary>
+        ///     Gets or sets the cancellation token for this request.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="CancellationToken"/> for this request.
+        /// </returns>
         public CancellationToken CancelToken { get; set; } = CancellationToken.None;
+        /// <summary>
+        ///     Gets or sets the retry behavior when the request fails.
+        /// </summary>
         public RetryMode? RetryMode { get; set; }
         public bool HeaderOnly { get; internal set; }
         /// <summary>
-        /// The reason for this action in the guild's audit log
+        ///     Gets or sets the reason for this action in the guild's audit log.
         /// </summary>
+        /// <remarks>
+        ///     Gets or sets the reason that will be written to the guild's audit log if applicable. This may not apply
+        ///     to all actions.
+        /// </remarks>
         public string AuditLogReason { get; set; }
 
         internal bool IgnoreState { get; set; }
@@ -32,11 +58,15 @@ namespace Discord
                 return options.Clone();
         }
 
+        /// <summary>
+        ///     Initializes a new <see cref="RequestOptions" /> class with the default request timeout set in
+        ///     <see cref="DiscordConfig"/>.
+        /// </summary>
         public RequestOptions()
         {
             Timeout = DiscordConfig.DefaultRequestTimeout;
         }
-
+        
         public RequestOptions Clone() => MemberwiseClone() as RequestOptions;
     }
 }
diff --git a/src/Discord.Net.Core/RetryMode.cs b/src/Discord.Net.Core/RetryMode.cs
index 65ae75fc3..1e09f4dd1 100644
--- a/src/Discord.Net.Core/RetryMode.cs
+++ b/src/Discord.Net.Core/RetryMode.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 
 namespace Discord
 {
@@ -12,7 +12,7 @@ namespace Discord
         RetryTimeouts = 0x1,
         // /// <summary> Retry if a request failed due to a network error. </summary>
         //RetryErrors = 0x2,
-        /// <summary> Retry if a request failed due to a ratelimit. </summary>
+        /// <summary> Retry if a request failed due to a rate-limit. </summary>
         RetryRatelimit = 0x4,
         /// <summary> Retry if a request failed due to an HTTP error 502. </summary>
         Retry502 = 0x8,
diff --git a/src/Discord.Net.Core/TokenType.cs b/src/Discord.Net.Core/TokenType.cs
index 62181420a..8ca3f031c 100644
--- a/src/Discord.Net.Core/TokenType.cs
+++ b/src/Discord.Net.Core/TokenType.cs
@@ -2,12 +2,22 @@ using System;
 
 namespace Discord
 {
+    /// <summary> Specifies the type of token to use with the client. </summary>
     public enum TokenType
     {
         [Obsolete("User logins are deprecated and may result in a ToS strike against your account - please see https://github.com/RogueException/Discord.Net/issues/827", error: true)]
         User,
+        /// <summary>
+        ///     An OAuth2 token type.
+        /// </summary>
         Bearer,
+        /// <summary>
+        ///     A bot token type.
+        /// </summary>
         Bot,
+        /// <summary>
+        ///     A webhook token type.
+        /// </summary>
         Webhook
     }
 }
diff --git a/src/Discord.Net.Core/Utils/Cacheable.cs b/src/Discord.Net.Core/Utils/Cacheable.cs
index f17aa8699..1857ae7a0 100644
--- a/src/Discord.Net.Core/Utils/Cacheable.cs
+++ b/src/Discord.Net.Core/Utils/Cacheable.cs
@@ -1,30 +1,31 @@
-using System;
+using System;
 using System.Threading.Tasks;
 
 namespace Discord
 {
     /// <summary>
-    /// Contains an entity that may be cached.
+    ///     Represents a cached entity.
     /// </summary>
-    /// <typeparam name="TEntity">The type of entity that is cached</typeparam>
-    /// <typeparam name="TId">The type of this entity's ID</typeparam>
+    /// <typeparam name="TEntity">The type of entity that is cached.</typeparam>
+    /// <typeparam name="TId">The type of this entity's ID.</typeparam>
     public struct Cacheable<TEntity, TId>
         where TEntity : IEntity<TId>
         where TId : IEquatable<TId>
     {
         /// <summary>
-        /// Is this entity cached?
+        ///     Gets whether this entity is cached.
         /// </summary>
         public bool HasValue { get; }
         /// <summary>
-        /// The ID of this entity.
+        ///     Gets the ID of this entity.
         /// </summary>
         public TId Id { get; }
         /// <summary>
-        /// The entity, if it could be pulled from cache.
+        ///     Gets the entity if it could be pulled from cache.
         /// </summary>
         /// <remarks>
-        /// This value is not guaranteed to be set; in cases where the entity cannot be pulled from cache, it is null.
+        ///     This value is not guaranteed to be set; in cases where the entity cannot be pulled from cache, it is
+        ///     <c>null</c>.
         /// </remarks>
         public TEntity Value { get; }
         private Func<Task<TEntity>> DownloadFunc { get; }
@@ -38,22 +39,28 @@ namespace Discord
         }
 
         /// <summary>
-        /// Downloads this entity to cache.
+        ///     Downloads this entity to cache.
         /// </summary>
-        /// <returns>An awaitable Task containing the downloaded entity.</returns>
         /// <exception cref="Discord.Net.HttpException">Thrown when used from a user account.</exception>
         /// <exception cref="NullReferenceException">Thrown when the message is deleted.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous download operation. The task result contains the downloaded
+        ///     entity.
+        /// </returns>
         public async Task<TEntity> DownloadAsync()
         {
-            return await DownloadFunc();
+            return await DownloadFunc().ConfigureAwait(false);
         }
 
         /// <summary>
-        /// Returns the cached entity if it exists; otherwise downloads it.
+        ///     Returns the cached entity if it exists; otherwise downloads it.
         /// </summary>
-        /// <returns>An awaitable Task containing a cached or downloaded entity.</returns>
         /// <exception cref="Discord.Net.HttpException">Thrown when used from a user account.</exception>
         /// <exception cref="NullReferenceException">Thrown when the message is deleted and is not in cache.</exception>
-        public async Task<TEntity> GetOrDownloadAsync() => HasValue ? Value : await DownloadAsync();
+        /// <returns>
+        ///     A task that represents the asynchronous operation that attempts to get the message via cache or to
+        ///     download the message. The task result contains the downloaded entity.
+        /// </returns>
+        public async Task<TEntity> GetOrDownloadAsync() => HasValue ? Value : await DownloadAsync().ConfigureAwait(false);
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.Core/Utils/Comparers.cs b/src/Discord.Net.Core/Utils/Comparers.cs
index d7641e897..40500ffe3 100644
--- a/src/Discord.Net.Core/Utils/Comparers.cs
+++ b/src/Discord.Net.Core/Utils/Comparers.cs
@@ -3,13 +3,31 @@ using System.Collections.Generic;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a collection of <see cref="IEqualityComparer{T}"/> for various Discord objects.
+    /// </summary>
     public static class DiscordComparers
     {
         // TODO: simplify with '??=' slated for C# 8.0
+        /// <summary>
+        ///     Gets an <see cref="IEqualityComparer{T}"/> to be used to compare users.
+        /// </summary>
         public static IEqualityComparer<IUser> UserComparer => _userComparer ?? (_userComparer = new EntityEqualityComparer<IUser, ulong>());
+        /// <summary>
+        ///     Gets an <see cref="IEqualityComparer{T}"/> to be used to compare guilds.
+        /// </summary>
         public static IEqualityComparer<IGuild> GuildComparer => _guildComparer ?? (_guildComparer = new EntityEqualityComparer<IGuild, ulong>());
+        /// <summary>
+        ///     Gets an <see cref="IEqualityComparer{T}"/> to be used to compare channels.
+        /// </summary>
         public static IEqualityComparer<IChannel> ChannelComparer => _channelComparer ?? (_channelComparer = new EntityEqualityComparer<IChannel, ulong>());
+        /// <summary>
+        ///     Gets an <see cref="IEqualityComparer{T}"/> to be used to compare roles.
+        /// </summary>
         public static IEqualityComparer<IRole> RoleComparer => _roleComparer ?? (_roleComparer = new EntityEqualityComparer<IRole, ulong>());
+        /// <summary>
+        ///     Gets an <see cref="IEqualityComparer{T}"/> to be used to compare messages.
+        /// </summary>
         public static IEqualityComparer<IMessage> MessageComparer => _messageComparer ?? (_messageComparer = new EntityEqualityComparer<IMessage, ulong>());
 
         private static IEqualityComparer<IUser> _userComparer;
diff --git a/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs b/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
index e9edfb772..308f08460 100644
--- a/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
+++ b/src/Discord.Net.Core/Utils/ConcurrentHashSet.cs
@@ -157,12 +157,16 @@ namespace Discord
             : this(collection, EqualityComparer<T>.Default) { }
         public ConcurrentHashSet(IEqualityComparer<T> comparer) 
             : this(DefaultConcurrencyLevel, DefaultCapacity, true, comparer) { }
+        /// <exception cref="ArgumentNullException"><paramref name="collection"/> is <c>null</c></exception>
         public ConcurrentHashSet(IEnumerable<T> collection, IEqualityComparer<T> comparer) 
             : this(comparer)
         {
             if (collection == null) throw new ArgumentNullException(paramName: nameof(collection));
             InitializeFromCollection(collection);
         }
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="collection" /> or <paramref name="comparer" /> is <c>null</c>
+        /// </exception>
         public ConcurrentHashSet(int concurrencyLevel, IEnumerable<T> collection, IEqualityComparer<T> comparer)
             : this(concurrencyLevel, DefaultCapacity, false, comparer)
         {
@@ -206,7 +210,7 @@ namespace Discord
             if (_budget == 0)
                 _budget = _tables._buckets.Length / _tables._locks.Length;
         }
-        
+        /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception>
         public bool ContainsKey(T value)
         {
             if (value == null) throw new ArgumentNullException(paramName: "key");
@@ -230,6 +234,7 @@ namespace Discord
             return false;
         }
 
+        /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception>
         public bool TryAdd(T value)
         {
             if (value == null) throw new ArgumentNullException(paramName: "key");
@@ -279,6 +284,7 @@ namespace Discord
             }
         }
 
+        /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception>
         public bool TryRemove(T value)
         {
             if (value == null) throw new ArgumentNullException(paramName: "key");
diff --git a/src/Discord.Net.Core/Utils/DateTimeUtils.cs b/src/Discord.Net.Core/Utils/DateTimeUtils.cs
index e2a8faa75..608476889 100644
--- a/src/Discord.Net.Core/Utils/DateTimeUtils.cs
+++ b/src/Discord.Net.Core/Utils/DateTimeUtils.cs
@@ -2,13 +2,12 @@ using System;
 
 namespace Discord
 {
-    //Source: https://github.com/dotnet/coreclr/blob/master/src/mscorlib/src/System/DateTimeOffset.cs
+    /// <see href="https://github.com/dotnet/coreclr/blob/master/src/mscorlib/src/System/DateTimeOffset.cs"/>
     internal static class DateTimeUtils
     {
         public static DateTimeOffset FromTicks(long ticks)
             => new DateTimeOffset(ticks, TimeSpan.Zero);
         public static DateTimeOffset? FromTicks(long? ticks)
             => ticks != null ? new DateTimeOffset(ticks.Value, TimeSpan.Zero) : (DateTimeOffset?)null;
-       
     }
 }
diff --git a/src/Discord.Net.Core/Utils/MentionUtils.cs b/src/Discord.Net.Core/Utils/MentionUtils.cs
index a081b5a5a..6ffb7eee6 100644
--- a/src/Discord.Net.Core/Utils/MentionUtils.cs
+++ b/src/Discord.Net.Core/Utils/MentionUtils.cs
@@ -4,26 +4,52 @@ using System.Text;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Provides a series of helper methods for parsing mentions.
+    /// </summary>
     public static class MentionUtils
     {
         private const char SanitizeChar = '\x200b';
 
         //If the system can't be positive a user doesn't have a nickname, assume useNickname = true (source: Jake)
         internal static string MentionUser(string id, bool useNickname = true) => useNickname ? $"<@!{id}>" : $"<@{id}>";
+        /// <summary>
+        ///     Returns a mention string based on the user ID.
+        /// </summary>
+        /// <returns>
+        ///     A user mention string (e.g. &lt;@80351110224678912&gt;).
+        /// </returns>
         public static string MentionUser(ulong id) => MentionUser(id.ToString(), true);
         internal static string MentionChannel(string id) => $"<#{id}>";
+        /// <summary>
+        ///     Returns a mention string based on the channel ID.
+        /// </summary>
+        /// <returns>
+        ///     A channel mention string (e.g. &lt;#103735883630395392&gt;).
+        /// </returns>
         public static string MentionChannel(ulong id) => MentionChannel(id.ToString());
-        internal static string MentionRole(string id) => $"<@&{id}>";        
+        internal static string MentionRole(string id) => $"<@&{id}>";
+        /// <summary>
+        ///     Returns a mention string based on the role ID.
+        /// </summary>
+        /// <returns>
+        ///     A role mention string (e.g. &lt;@&amp;165511591545143296&gt;).
+        /// </returns>
         public static string MentionRole(ulong id) => MentionRole(id.ToString());
 
-        /// <summary> Parses a provided user mention string. </summary>
+        /// <summary>
+        ///     Parses a provided user mention string.
+        /// </summary>
+        /// <exception cref="ArgumentException">Invalid mention format.</exception>
         public static ulong ParseUser(string text)
         {
             if (TryParseUser(text, out ulong id))
                 return id;
-            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
+            throw new ArgumentException(message: "Invalid mention format.", paramName: nameof(text));
         }
-        /// <summary> Tries to parse a provided user mention string. </summary>
+        /// <summary>
+        ///     Tries to parse a provided user mention string.
+        /// </summary>
         public static bool TryParseUser(string text, out ulong userId)
         {
             if (text.Length >= 3 && text[0] == '<' && text[1] == '@' && text[text.Length - 1] == '>')
@@ -40,14 +66,19 @@ namespace Discord
             return false;
         }
 
-        /// <summary> Parses a provided channel mention string. </summary>
+        /// <summary>
+        ///     Parses a provided channel mention string.
+        /// </summary>
+        /// <exception cref="ArgumentException">Invalid mention format.</exception>
         public static ulong ParseChannel(string text)
         {
             if (TryParseChannel(text, out ulong id))
                 return id;
-            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
+            throw new ArgumentException(message: "Invalid mention format.", paramName: nameof(text));
         }
-        /// <summary>Tries to parse a provided channel mention string. </summary>
+        /// <summary>
+        ///     Tries to parse a provided channel mention string.
+        /// </summary>
         public static bool TryParseChannel(string text, out ulong channelId)
         {
             if (text.Length >= 3 && text[0] == '<' && text[1] == '#' && text[text.Length - 1] == '>')
@@ -61,14 +92,19 @@ namespace Discord
             return false;
         }
 
-        /// <summary> Parses a provided role mention string. </summary>
+        /// <summary>
+        ///     Parses a provided role mention string.
+        /// </summary>
+        /// <exception cref="ArgumentException">Invalid mention format.</exception>
         public static ulong ParseRole(string text)
         {
             if (TryParseRole(text, out ulong id))
                 return id;
-            throw new ArgumentException(message: "Invalid mention format", paramName: nameof(text));
+            throw new ArgumentException(message: "Invalid mention format.", paramName: nameof(text));
         }
-        /// <summary>Tries to parse a provided role mention string. </summary>
+        /// <summary>
+        ///     Tries to parse a provided role mention string.
+        /// </summary>
         public static bool TryParseRole(string text, out ulong roleId)
         {
             if (text.Length >= 4 && text[0] == '<' && text[1] == '@' && text[2] == '&' && text[text.Length - 1] == '>')
diff --git a/src/Discord.Net.Core/Utils/Optional.cs b/src/Discord.Net.Core/Utils/Optional.cs
index eb3cbdca2..348179699 100644
--- a/src/Discord.Net.Core/Utils/Optional.cs
+++ b/src/Discord.Net.Core/Utils/Optional.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 
 namespace Discord
@@ -11,6 +11,7 @@ namespace Discord
         private readonly T _value;
 
         /// <summary> Gets the value for this parameter. </summary>
+        /// <exception cref="InvalidOperationException" accessor="get">This property has no value set.</exception>
         public T Value
         {
             get
diff --git a/src/Discord.Net.Core/Utils/Permissions.cs b/src/Discord.Net.Core/Utils/Permissions.cs
index 6e7125ab7..fd0fe091a 100644
--- a/src/Discord.Net.Core/Utils/Permissions.cs
+++ b/src/Discord.Net.Core/Utils/Permissions.cs
@@ -165,7 +165,7 @@ namespace Discord
                         resolvedPermissions &= ~(ulong)ChannelPermission.AttachFiles;
                     }
                 }
-                resolvedPermissions &= mask; //Ensure we didnt get any permissions this channel doesnt support (from guildPerms, for example)
+                resolvedPermissions &= mask; //Ensure we didn't get any permissions this channel doesn't support (from guildPerms, for example)
             }
 
             return resolvedPermissions;
diff --git a/src/Discord.Net.Core/Utils/Preconditions.cs b/src/Discord.Net.Core/Utils/Preconditions.cs
index 6cbf4a173..d04d3be50 100644
--- a/src/Discord.Net.Core/Utils/Preconditions.cs
+++ b/src/Discord.Net.Core/Utils/Preconditions.cs
@@ -165,6 +165,7 @@ namespace Discord
             => new ArgumentException(message: msg ?? $"Value must be less than {value}", paramName: name);
 
         // Bulk Delete
+        /// <exception cref="ArgumentOutOfRangeException">Messages are younger than 2 weeks.</exception>
         public static void YoungerThanTwoWeeks(ulong[] collection, string name)
         {
             var minimum = SnowflakeUtils.ToSnowflake(DateTimeOffset.UtcNow.Subtract(TimeSpan.FromDays(14)));
@@ -175,6 +176,7 @@ namespace Discord
                     throw new ArgumentOutOfRangeException(name, "Messages must be younger than two weeks old.");
             }
         }
+        /// <exception cref="ArgumentException">The everyone role cannot be assigned to a user.</exception>
         public static void NotEveryoneRole(ulong[] roles, ulong guildId, string name)
         {
             for (var i = 0; i < roles.Length; i++)
diff --git a/src/Discord.Net.Core/Utils/SnowflakeUtils.cs b/src/Discord.Net.Core/Utils/SnowflakeUtils.cs
index eecebfb24..dd8f8ca66 100644
--- a/src/Discord.Net.Core/Utils/SnowflakeUtils.cs
+++ b/src/Discord.Net.Core/Utils/SnowflakeUtils.cs
@@ -2,10 +2,27 @@ using System;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Provides a series of helper methods for handling snowflake identifiers.
+    /// </summary>
     public static class SnowflakeUtils
     {
+        /// <summary>
+        ///     Resolves the time of which the snowflake is generated.
+        /// </summary>
+        /// <param name="value">The snowflake identifier to resolve.</param>
+        /// <returns>
+        ///     A <see cref="DateTimeOffset" /> representing the time for when the object is geenrated.
+        /// </returns>
         public static DateTimeOffset FromSnowflake(ulong value)
             => DateTimeOffset.FromUnixTimeMilliseconds((long)((value >> 22) + 1420070400000UL));
+        /// <summary>
+        ///     Generates a pseudo-snowflake identifier with a <see cref="DateTimeOffset"/>.
+        /// </summary>
+        /// <param name="value">The time to be used in the new snowflake.</param>
+        /// <returns>
+        ///     A <see cref="UInt64" /> representing the newly generated snowflake identifier.
+        /// </returns>
         public static ulong ToSnowflake(DateTimeOffset value)
             => ((ulong)value.ToUnixTimeMilliseconds() - 1420070400000UL) << 22;
     }
diff --git a/src/Discord.Net.Core/Utils/TokenUtils.cs b/src/Discord.Net.Core/Utils/TokenUtils.cs
index 6decdc52f..bfc915252 100644
--- a/src/Discord.Net.Core/Utils/TokenUtils.cs
+++ b/src/Discord.Net.Core/Utils/TokenUtils.cs
@@ -1,11 +1,10 @@
 using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Provides a series of helper methods for handling Discord login tokens.
+    /// </summary>
     public static class TokenUtils
     {
         /// <summary>
@@ -13,8 +12,8 @@ namespace Discord
         /// </summary>
         /// <param name="tokenType"> The type of token to validate. </param>
         /// <param name="token"> The token value to validate. </param>
-        /// <exception cref="ArgumentNullException"> Thrown when the supplied token string is null, empty, or contains only whitespace.</exception>
-        /// <exception cref="ArgumentException"> Thrown when the supplied TokenType or token value is invalid. </exception>
+        /// <exception cref="ArgumentNullException"> Thrown when the supplied token string is <c>null</c>, empty, or contains only whitespace.</exception>
+        /// <exception cref="ArgumentException"> Thrown when the supplied <see cref="TokenType"/> or token value is invalid. </exception>
         public static void ValidateToken(TokenType tokenType, string token)
         {
             // A Null or WhiteSpace token of any type is invalid.
diff --git a/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs b/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
index 1894a8906..afc01f87a 100644
--- a/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
+++ b/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
@@ -1,4 +1,4 @@
-using Discord.Net.WebSockets;
+using Discord.Net.WebSockets;
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -151,7 +151,7 @@ namespace Discord.Net.Providers.WS4Net
         }
         private void OnBinaryMessage(object sender, DataReceivedEventArgs e)
         {
-            BinaryMessage(e.Data, 0, e.Data.Count()).GetAwaiter().GetResult();
+            BinaryMessage(e.Data, 0, e.Data.Length).GetAwaiter().GetResult();
         }
         private void OnConnected(object sender, object e)
         {
diff --git a/src/Discord.Net.Rest/API/Common/EmbedAuthor.cs b/src/Discord.Net.Rest/API/Common/EmbedAuthor.cs
index 4381a9da3..d7f3ae68d 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedAuthor.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedAuthor.cs
@@ -1,4 +1,3 @@
-using System;
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Common/EmbedFooter.cs b/src/Discord.Net.Rest/API/Common/EmbedFooter.cs
index 3dd7020d9..cd08e7e26 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedFooter.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedFooter.cs
@@ -1,4 +1,3 @@
-using System;
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Common/EmbedImage.cs b/src/Discord.Net.Rest/API/Common/EmbedImage.cs
index c6b3562a3..e650d99f4 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedImage.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedImage.cs
@@ -1,5 +1,4 @@
-#pragma warning disable CS1591
-using System;
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Common/EmbedProvider.cs b/src/Discord.Net.Rest/API/Common/EmbedProvider.cs
index 1658eda1a..e01261483 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedProvider.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedProvider.cs
@@ -1,5 +1,4 @@
-#pragma warning disable CS1591
-using System;
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Common/EmbedThumbnail.cs b/src/Discord.Net.Rest/API/Common/EmbedThumbnail.cs
index 993beb72b..9c87ca46b 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedThumbnail.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedThumbnail.cs
@@ -1,5 +1,4 @@
-#pragma warning disable CS1591
-using System;
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Common/EmbedVideo.cs b/src/Discord.Net.Rest/API/Common/EmbedVideo.cs
index 610cf58a8..3a034d244 100644
--- a/src/Discord.Net.Rest/API/Common/EmbedVideo.cs
+++ b/src/Discord.Net.Rest/API/Common/EmbedVideo.cs
@@ -1,5 +1,4 @@
-#pragma warning disable CS1591
-using System;
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Rest/UploadFileParams.cs b/src/Discord.Net.Rest/API/Rest/UploadFileParams.cs
index 9e909b50c..ae15aa5df 100644
--- a/src/Discord.Net.Rest/API/Rest/UploadFileParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/UploadFileParams.cs
@@ -3,7 +3,6 @@ using Discord.Net.Converters;
 using Discord.Net.Rest;
 using Newtonsoft.Json;
 using System.Collections.Generic;
-using System.Globalization;
 using System.IO;
 using System.Text;
 
diff --git a/src/Discord.Net.Rest/BaseDiscordClient.cs b/src/Discord.Net.Rest/BaseDiscordClient.cs
index 8a3db3e6a..b584f5764 100644
--- a/src/Discord.Net.Rest/BaseDiscordClient.cs
+++ b/src/Discord.Net.Rest/BaseDiscordClient.cs
@@ -24,11 +24,18 @@ namespace Discord.Rest
 
         internal API.DiscordRestApiClient ApiClient { get; }
         internal LogManager LogManager { get; }
+        /// <summary>
+        ///     Gets the login state of the client.
+        /// </summary>
         public LoginState LoginState { get; private set; }
+        /// <summary>
+        ///     Gets the logged-in user.
+        /// </summary>
         public ISelfUser CurrentUser { get; protected set; }
+        /// <inheritdoc />
         public TokenType TokenType => ApiClient.AuthTokenType;
         
-        /// <summary> Creates a new REST-only discord client. </summary>
+        /// <summary> Creates a new REST-only Discord client. </summary>
         internal BaseDiscordClient(DiscordRestConfig config, API.DiscordRestApiClient client)
         {
             ApiClient = client;
@@ -49,7 +56,6 @@ namespace Discord.Rest
             ApiClient.SentRequest += async (method, endpoint, millis) => await _restLogger.VerboseAsync($"{method} {endpoint}: {millis} ms").ConfigureAwait(false);
         }
 
-        /// <inheritdoc />
         public async Task LoginAsync(TokenType tokenType, string token, bool validateToken = true)
         {
             await _stateLock.WaitAsync().ConfigureAwait(false);
@@ -84,7 +90,7 @@ namespace Discord.Rest
                     catch (ArgumentException ex)
                     {
                         // log these ArgumentExceptions and allow for the client to attempt to log in anyways
-                        await LogManager.WarningAsync("Discord", "A supplied token was invalid", ex).ConfigureAwait(false);
+                        await LogManager.WarningAsync("Discord", "A supplied token was invalid.", ex).ConfigureAwait(false);
                     }
                 }
 
@@ -102,8 +108,7 @@ namespace Discord.Rest
         }
         internal virtual Task OnLoginAsync(TokenType tokenType, string token) 
             => Task.Delay(0);
-
-        /// <inheritdoc />
+        
         public async Task LogoutAsync()
         {
             await _stateLock.WaitAsync().ConfigureAwait(false);
@@ -145,49 +150,69 @@ namespace Discord.Rest
             => ClientHelper.GetRecommendShardCountAsync(this, options);
 
         //IDiscordClient
+        /// <inheritdoc />
         ConnectionState IDiscordClient.ConnectionState => ConnectionState.Disconnected;
+        /// <inheritdoc />
         ISelfUser IDiscordClient.CurrentUser => CurrentUser;
 
+        /// <inheritdoc />
         Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options) 
             => throw new NotSupportedException();
 
+        /// <inheritdoc />
         Task<IChannel> IDiscordClient.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IChannel>(null);
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IPrivateChannel>> IDiscordClient.GetPrivateChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IPrivateChannel>>(ImmutableArray.Create<IPrivateChannel>());
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IDMChannel>> IDiscordClient.GetDMChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IDMChannel>>(ImmutableArray.Create<IDMChannel>());
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGroupChannel>> IDiscordClient.GetGroupChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGroupChannel>>(ImmutableArray.Create<IGroupChannel>());
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IConnection>> IDiscordClient.GetConnectionsAsync(RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IConnection>>(ImmutableArray.Create<IConnection>());
 
+        /// <inheritdoc />
         Task<IInvite> IDiscordClient.GetInviteAsync(string inviteId, RequestOptions options)
             => Task.FromResult<IInvite>(null);
 
+        /// <inheritdoc />
         Task<IGuild> IDiscordClient.GetGuildAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuild>(null);
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuild>> IDiscordClient.GetGuildsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuild>>(ImmutableArray.Create<IGuild>());
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Creating a guild is not supported with the base client.</exception>
         Task<IGuild> IDiscordClient.CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon, RequestOptions options)
             => throw new NotSupportedException();
 
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(null);
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(string username, string discriminator, RequestOptions options)
             => Task.FromResult<IUser>(null);
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IVoiceRegion>> IDiscordClient.GetVoiceRegionsAsync(RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IVoiceRegion>>(ImmutableArray.Create<IVoiceRegion>());
+        /// <inheritdoc />
         Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => Task.FromResult<IVoiceRegion>(null);
 
+        /// <inheritdoc />
         Task<IWebhook> IDiscordClient.GetWebhookAsync(ulong id, RequestOptions options)
             => Task.FromResult<IWebhook>(null);
 
+        /// <inheritdoc />
         Task IDiscordClient.StartAsync()
             => Task.Delay(0);
+        /// <inheritdoc />
         Task IDiscordClient.StopAsync()
             => Task.Delay(0);
     }
diff --git a/src/Discord.Net.Rest/ClientHelper.cs b/src/Discord.Net.Rest/ClientHelper.cs
index aa99fe005..a8f6b58ef 100644
--- a/src/Discord.Net.Rest/ClientHelper.cs
+++ b/src/Discord.Net.Rest/ClientHelper.cs
@@ -1,3 +1,4 @@
+using System;
 using Discord.API.Rest;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -24,6 +25,7 @@ namespace Discord.Rest
                 return RestChannel.Create(client, model);
             return null;
         }
+        /// <exception cref="InvalidOperationException">Unexpected channel type.</exception>
         public static async Task<IReadOnlyCollection<IRestPrivateChannel>> GetPrivateChannelsAsync(BaseDiscordClient client, RequestOptions options)
         {
             var models = await client.ApiClient.GetMyPrivateChannelsAsync(options).ConfigureAwait(false);
@@ -151,7 +153,7 @@ namespace Discord.Rest
 
         public static async Task<RestWebhook> GetWebhookAsync(BaseDiscordClient client, ulong id, RequestOptions options)
         {
-            var model = await client.ApiClient.GetWebhookAsync(id);
+            var model = await client.ApiClient.GetWebhookAsync(id).ConfigureAwait(false);
             if (model != null)
                 return RestWebhook.Create(client, (IGuild)null, model);
             return null;
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 1679579b2..36406bfea 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -47,6 +47,7 @@ namespace Discord.API
 
         internal JsonSerializer Serializer => _serializer;
 
+        /// <exception cref="ArgumentException">Unknown OAuth token type.</exception>
         public DiscordRestApiClient(RestClientProvider restClientProvider, string userAgent, RetryMode defaultRetryMode = RetryMode.AlwaysRetry,
             JsonSerializer serializer = null)
         {
@@ -60,6 +61,8 @@ namespace Discord.API
 
             SetBaseUrl(DiscordConfig.APIUrl);
         }
+
+        /// <exception cref="ArgumentException">Unknown OAuth token type.</exception>
         internal void SetBaseUrl(string baseUrl)
         {
             RestClient = _restClientProvider(baseUrl);
@@ -67,6 +70,7 @@ namespace Discord.API
             RestClient.SetHeader("user-agent", UserAgent);
             RestClient.SetHeader("authorization", GetPrefixedToken(AuthTokenType, AuthToken));
         }
+        /// <exception cref="ArgumentException">Unknown OAuth token type.</exception>
         internal static string GetPrefixedToken(TokenType tokenType, string token)
         {
             switch (tokenType)
@@ -78,7 +82,7 @@ namespace Discord.API
                 case TokenType.Bearer:
                     return $"Bearer {token}";
                 default:
-                    throw new ArgumentException(message: "Unknown OAuth token type", paramName: nameof(tokenType));
+                    throw new ArgumentException(message: "Unknown OAuth token type.", paramName: nameof(tokenType));
             }
         }
         internal virtual void Dispose(bool disposing)
@@ -166,7 +170,7 @@ namespace Discord.API
         //Core
         internal Task SendAsync(string method, Expression<Func<string>> endpointExpr, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
-            => SendAsync(method, GetEndpoint(endpointExpr), GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
+            => SendAsync(method, GetEndpoint(endpointExpr), GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
         public async Task SendAsync(string method, string endpoint,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
@@ -180,7 +184,7 @@ namespace Discord.API
 
         internal Task SendJsonAsync(string method, Expression<Func<string>> endpointExpr, object payload, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
-            => SendJsonAsync(method, GetEndpoint(endpointExpr), payload, GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
+            => SendJsonAsync(method, GetEndpoint(endpointExpr), payload, GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
         public async Task SendJsonAsync(string method, string endpoint, object payload,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
@@ -195,7 +199,7 @@ namespace Discord.API
 
         internal Task SendMultipartAsync(string method, Expression<Func<string>> endpointExpr, IReadOnlyDictionary<string, object> multipartArgs, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
-            => SendMultipartAsync(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
+            => SendMultipartAsync(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
         public async Task SendMultipartAsync(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
@@ -209,7 +213,7 @@ namespace Discord.API
 
         internal Task<TResponse> SendAsync<TResponse>(string method, Expression<Func<string>> endpointExpr, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null) where TResponse : class
-            => SendAsync<TResponse>(method, GetEndpoint(endpointExpr), GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
+            => SendAsync<TResponse>(method, GetEndpoint(endpointExpr), GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
         public async Task<TResponse> SendAsync<TResponse>(string method, string endpoint,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null) where TResponse : class
         {
@@ -222,7 +226,7 @@ namespace Discord.API
 
         internal Task<TResponse> SendJsonAsync<TResponse>(string method, Expression<Func<string>> endpointExpr, object payload, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null) where TResponse : class
-            => SendJsonAsync<TResponse>(method, GetEndpoint(endpointExpr), payload, GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
+            => SendJsonAsync<TResponse>(method, GetEndpoint(endpointExpr), payload, GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
         public async Task<TResponse> SendJsonAsync<TResponse>(string method, string endpoint, object payload,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null) where TResponse : class
         {
@@ -236,8 +240,8 @@ namespace Discord.API
 
         internal Task<TResponse> SendMultipartAsync<TResponse>(string method, Expression<Func<string>> endpointExpr, IReadOnlyDictionary<string, object> multipartArgs, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
-            => SendMultipartAsync<TResponse>(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, AuthTokenType, funcName), clientBucket, options);
-        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs,
+            => SendMultipartAsync<TResponse>(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
+        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs, 
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
             options = options ?? new RequestOptions();
@@ -405,7 +409,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            await SendAsync("PUT", () => $"guilds/{guildId}/members/{userId}/roles/{roleId}", ids, options: options);
+            await SendAsync("PUT", () => $"guilds/{guildId}/members/{userId}/roles/{roleId}", ids, options: options).ConfigureAwait(false);
         }
         public async Task RemoveRoleAsync(ulong guildId, ulong userId, ulong roleId, RequestOptions options = null)
         {
@@ -416,7 +420,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            await SendAsync("DELETE", () => $"guilds/{guildId}/members/{userId}/roles/{roleId}", ids, options: options);
+            await SendAsync("DELETE", () => $"guilds/{guildId}/members/{userId}/roles/{roleId}", ids, options: options).ConfigureAwait(false);
         }
 
         //Channel Messages
@@ -467,6 +471,7 @@ namespace Discord.API
                 endpoint = () => $"channels/{channelId}/messages?limit={limit}";
             return await SendAsync<IReadOnlyCollection<Message>>("GET", endpoint, ids, options: options).ConfigureAwait(false);
         }
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public async Task<Message> CreateMessageAsync(ulong channelId, CreateMessageParams args, RequestOptions options = null)
         {
             Preconditions.NotNull(args, nameof(args));
@@ -481,6 +486,8 @@ namespace Discord.API
             var ids = new BucketIds(channelId: channelId);
             return await SendJsonAsync<Message>("POST", () => $"channels/{channelId}/messages", args, ids, clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
         }
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
+        /// <exception cref="InvalidOperationException">This operation may only be called with a <see cref="TokenType.Webhook"/> token.</exception>
         public async Task<Message> CreateWebhookMessageAsync(ulong webhookId, CreateWebhookMessageParams args, RequestOptions options = null)
         {
             if (AuthTokenType != TokenType.Webhook)
@@ -497,6 +504,7 @@ namespace Discord.API
 
             return await SendJsonAsync<Message>("POST", () => $"webhooks/{webhookId}/{AuthToken}?wait=true", args, new BucketIds(), clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
         }
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public async Task<Message> UploadFileAsync(ulong channelId, UploadFileParams args, RequestOptions options = null)
         {
             Preconditions.NotNull(args, nameof(args));
@@ -511,6 +519,9 @@ namespace Discord.API
             var ids = new BucketIds(channelId: channelId);
             return await SendMultipartAsync<Message>("POST", () => $"channels/{channelId}/messages", args.ToDictionary(), ids, clientBucket: ClientBucketType.SendEdit, options: options).ConfigureAwait(false);
         }
+
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
+        /// <exception cref="InvalidOperationException">This operation may only be called with a <see cref="TokenType.Webhook"/> token.</exception>
         public async Task<Message> UploadWebhookFileAsync(ulong webhookId, UploadWebhookFileParams args, RequestOptions options = null)
         {
             if (AuthTokenType != TokenType.Webhook)
@@ -563,6 +574,7 @@ namespace Discord.API
                     break;
             }
         }
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public async Task<Message> ModifyMessageAsync(ulong channelId, ulong messageId, Rest.ModifyMessageParams args, RequestOptions options = null)
         {
             Preconditions.NotEqual(channelId, 0, nameof(channelId));
@@ -1098,7 +1110,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            return await SendAsync<Emoji>("GET", () => $"guilds/{guildId}/emojis/{emoteId}", ids, options: options);
+            return await SendAsync<Emoji>("GET", () => $"guilds/{guildId}/emojis/{emoteId}", ids, options: options).ConfigureAwait(false);
         }
 
         public async Task<Emoji> CreateGuildEmoteAsync(ulong guildId, Rest.CreateGuildEmoteParams args, RequestOptions options = null)
@@ -1110,7 +1122,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            return await SendJsonAsync<Emoji>("POST", () => $"guilds/{guildId}/emojis", args, ids, options: options);
+            return await SendJsonAsync<Emoji>("POST", () => $"guilds/{guildId}/emojis", args, ids, options: options).ConfigureAwait(false);
         }
 
         public async Task<Emoji> ModifyGuildEmoteAsync(ulong guildId, ulong emoteId, ModifyGuildEmoteParams args, RequestOptions options = null)
@@ -1121,7 +1133,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            return await SendJsonAsync<Emoji>("PATCH", () => $"guilds/{guildId}/emojis/{emoteId}", args, ids, options: options);
+            return await SendJsonAsync<Emoji>("PATCH", () => $"guilds/{guildId}/emojis/{emoteId}", args, ids, options: options).ConfigureAwait(false);
         }
 
         public async Task DeleteGuildEmoteAsync(ulong guildId, ulong emoteId, RequestOptions options = null)
@@ -1131,7 +1143,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(guildId: guildId);
-            await SendAsync("DELETE", () => $"guilds/{guildId}/emojis/{emoteId}", ids, options: options);
+            await SendAsync("DELETE", () => $"guilds/{guildId}/emojis/{emoteId}", ids, options: options).ConfigureAwait(false);
         }
 
         //Users
@@ -1251,7 +1263,7 @@ namespace Discord.API
             options = RequestOptions.CreateOrClone(options);
             var ids = new BucketIds(channelId: channelId);
 
-            return await SendJsonAsync<Webhook>("POST", () => $"channels/{channelId}/webhooks", args, ids, options: options);
+            return await SendJsonAsync<Webhook>("POST", () => $"channels/{channelId}/webhooks", args, ids, options: options).ConfigureAwait(false);
         }
         public async Task<Webhook> GetWebhookAsync(ulong webhookId, RequestOptions options = null)
         {
@@ -1307,6 +1319,7 @@ namespace Discord.API
         }
 
         //Helpers
+        /// <exception cref="InvalidOperationException">Client is not logged in.</exception>
         protected void CheckState()
         {
             if (LoginState != LoginState.LoggedIn)
@@ -1357,7 +1370,7 @@ namespace Discord.API
         {
             return endpointExpr.Compile()();
         }
-        private static string GetBucketId(BucketIds ids, Expression<Func<string>> endpointExpr, TokenType tokenType, string callingMethod)
+        private static string GetBucketId(BucketIds ids, Expression<Func<string>> endpointExpr, string callingMethod)
         {
             return _bucketIdGenerators.GetOrAdd(callingMethod, x => CreateBucketId(endpointExpr))(ids);
         }
@@ -1419,7 +1432,7 @@ namespace Discord.API
             }
             catch (Exception ex)
             {
-                throw new InvalidOperationException("Failed to generate the bucket id for this operation", ex);
+                throw new InvalidOperationException("Failed to generate the bucket id for this operation.", ex);
             }
         }
 
diff --git a/src/Discord.Net.Rest/DiscordRestClient.cs b/src/Discord.Net.Rest/DiscordRestClient.cs
index d4dee9f0a..e36353855 100644
--- a/src/Discord.Net.Rest/DiscordRestClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestClient.cs
@@ -5,13 +5,24 @@ using System.Threading.Tasks;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Provides a client to send REST-based requests to Discord.
+    /// </summary>
     public class DiscordRestClient : BaseDiscordClient, IDiscordClient
     {
         private RestApplication _applicationInfo;
 
+        /// <summary>
+        ///     Gets the logged-in user.
+        /// </summary>
         public new RestSelfUser CurrentUser => base.CurrentUser as RestSelfUser;
 
+        /// <inheritdoc />
         public DiscordRestClient() : this(new DiscordRestConfig()) { }
+        /// <summary>
+        ///     Initializes a new <see cref="DiscordRestClient"/> with the provided configuration.
+        /// </summary>
+        /// <param name="config">The configuration to be used with the client.</param>
         public DiscordRestClient(DiscordRestConfig config) : base(config, CreateApiClient(config)) { }
 
         private static API.DiscordRestApiClient CreateApiClient(DiscordRestConfig config)
@@ -22,83 +33,71 @@ namespace Discord.Rest
                 ApiClient.Dispose();
         }
 
+        /// <inheritdoc />
         internal override async Task OnLoginAsync(TokenType tokenType, string token)
         {
             var user = await ApiClient.GetMyUserAsync(new RequestOptions { RetryMode = RetryMode.AlwaysRetry }).ConfigureAwait(false);
             ApiClient.CurrentUserId = user.Id;
             base.CurrentUser = RestSelfUser.Create(this, user);
         }
+        /// <inheritdoc />
         internal override Task OnLogoutAsync()
         {
             _applicationInfo = null;
             return Task.Delay(0);
         }
-
-        /// <inheritdoc />
+        
         public async Task<RestApplication> GetApplicationInfoAsync(RequestOptions options = null)
         {
-            return _applicationInfo ?? (_applicationInfo = await ClientHelper.GetApplicationInfoAsync(this, options));
+            return _applicationInfo ?? (_applicationInfo = await ClientHelper.GetApplicationInfoAsync(this, options).ConfigureAwait(false));
         }
         
-        /// <inheritdoc />
         public Task<RestChannel> GetChannelAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetChannelAsync(this, id, options);
-        /// <inheritdoc />
         public Task<IReadOnlyCollection<IRestPrivateChannel>> GetPrivateChannelsAsync(RequestOptions options = null)
             => ClientHelper.GetPrivateChannelsAsync(this, options);
         public Task<IReadOnlyCollection<RestDMChannel>> GetDMChannelsAsync(RequestOptions options = null)
             => ClientHelper.GetDMChannelsAsync(this, options);
         public Task<IReadOnlyCollection<RestGroupChannel>> GetGroupChannelsAsync(RequestOptions options = null)
             => ClientHelper.GetGroupChannelsAsync(this, options);
-
-        /// <inheritdoc />
+        
         public Task<IReadOnlyCollection<RestConnection>> GetConnectionsAsync(RequestOptions options = null)
             => ClientHelper.GetConnectionsAsync(this, options);
 
-        /// <inheritdoc />
         public Task<RestInviteMetadata> GetInviteAsync(string inviteId, RequestOptions options = null)
             => ClientHelper.GetInviteAsync(this, inviteId, options);
 
-        /// <inheritdoc />
         public Task<RestGuild> GetGuildAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetGuildAsync(this, id, options);
-        /// <inheritdoc />
         public Task<RestGuildEmbed?> GetGuildEmbedAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetGuildEmbedAsync(this, id, options);
-        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(RequestOptions options = null)
             => ClientHelper.GetGuildSummariesAsync(this, null, null, options);
-        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(ulong fromGuildId, int limit, RequestOptions options = null)
             => ClientHelper.GetGuildSummariesAsync(this, fromGuildId, limit, options);
-        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(RequestOptions options = null)
             => ClientHelper.GetGuildsAsync(this, options);
-        /// <inheritdoc />
         public Task<RestGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null)
             => ClientHelper.CreateGuildAsync(this, name, region, jpegIcon, options);
-
-        /// <inheritdoc />
+        
         public Task<RestUser> GetUserAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetUserAsync(this, id, options);
-        /// <inheritdoc />
         public Task<RestGuildUser> GetGuildUserAsync(ulong guildId, ulong id, RequestOptions options = null)
             => ClientHelper.GetGuildUserAsync(this, guildId, id, options);
-
-        /// <inheritdoc />
+        
         public Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
             => ClientHelper.GetVoiceRegionsAsync(this, options);
-        /// <inheritdoc />
         public Task<RestVoiceRegion> GetVoiceRegionAsync(string id, RequestOptions options = null)
             => ClientHelper.GetVoiceRegionAsync(this, id, options);
-        /// <inheritdoc />
         public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetWebhookAsync(this, id, options);
 
         //IDiscordClient
+        /// <inheritdoc />
         async Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options)
             => await GetApplicationInfoAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IChannel> IDiscordClient.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -106,6 +105,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IPrivateChannel>> IDiscordClient.GetPrivateChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -113,6 +113,7 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IPrivateChannel>();
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IDMChannel>> IDiscordClient.GetDMChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -120,6 +121,7 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IDMChannel>();
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGroupChannel>> IDiscordClient.GetGroupChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -128,12 +130,14 @@ namespace Discord.Rest
                 return ImmutableArray.Create<IGroupChannel>();
         }
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IConnection>> IDiscordClient.GetConnectionsAsync(RequestOptions options)
             => await GetConnectionsAsync(options).ConfigureAwait(false);
 
         async Task<IInvite> IDiscordClient.GetInviteAsync(string inviteId, RequestOptions options)
             => await GetInviteAsync(inviteId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IGuild> IDiscordClient.GetGuildAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -141,6 +145,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuild>> IDiscordClient.GetGuildsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -148,9 +153,11 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IGuild>();
         }
+        /// <inheritdoc />
         async Task<IGuild> IDiscordClient.CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon, RequestOptions options)
             => await CreateGuildAsync(name, region, jpegIcon, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IUser> IDiscordClient.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -159,12 +166,15 @@ namespace Discord.Rest
                 return null;
         }
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IVoiceRegion>> IDiscordClient.GetVoiceRegionsAsync(RequestOptions options)
             => await GetVoiceRegionsAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => await GetVoiceRegionAsync(id, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IWebhook> IDiscordClient.GetWebhookAsync(ulong id, RequestOptions options)
-            => await GetWebhookAsync(id, options);
+            => await GetWebhookAsync(id, options).ConfigureAwait(false);
     }
 }
diff --git a/src/Discord.Net.Rest/DiscordRestConfig.cs b/src/Discord.Net.Rest/DiscordRestConfig.cs
index 4a7aae287..7bf7440ce 100644
--- a/src/Discord.Net.Rest/DiscordRestConfig.cs
+++ b/src/Discord.Net.Rest/DiscordRestConfig.cs
@@ -1,7 +1,10 @@
-using Discord.Net.Rest;
+using Discord.Net.Rest;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a configuration class for <see cref="DiscordRestClient"/>.
+    /// </summary>
     public class DiscordRestConfig : DiscordConfig
     {
         /// <summary> Gets or sets the provider used to generate new REST connections. </summary>
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs
index 4b9d5875f..fc807cac0 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a ban.
+    /// </summary>
     public class BanAuditLogData : IAuditLogData
     {
         private BanAuditLogData(IUser user)
@@ -18,6 +21,12 @@ namespace Discord.Rest
             return new BanAuditLogData(RestUser.Create(discord, userInfo));
         }
 
+        /// <summary>
+        ///     Gets the user that was banned.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the banned user.
+        /// </returns>
         public IUser Target { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
index 51e72c414..51a19a0de 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
@@ -1,4 +1,3 @@
-using Newtonsoft.Json.Linq;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -7,6 +6,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a channel creation.
+    /// </summary>
     public class ChannelCreateAuditLogData : IAuditLogData
     {
         private ChannelCreateAuditLogData(ulong id, string name, ChannelType type, IReadOnlyCollection<Overwrite> overwrites)
@@ -42,9 +44,34 @@ namespace Discord.Rest
             return new ChannelCreateAuditLogData(entry.TargetId.Value, name, type, overwrites.ToReadOnlyCollection());
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the created channel.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier for the created channel.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the name of the created channel.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the created channel.
+        /// </returns>
         public string ChannelName { get; }
+        /// <summary>
+        ///     Gets the type of the created channel.
+        /// </summary>
+        /// <returns>
+        ///     The type of channel that was created.
+        /// </returns>
         public ChannelType ChannelType { get; }
+        /// <summary>
+        ///     Gets a collection of permission overwrites that was assigned to the created channel.
+        /// </summary>
+        /// <returns>
+        ///     A collection of permission <see cref="Overwrite"/>, containing the permission overwrites that were
+        ///     assigned to the created channel.
+        /// </returns>
         public IReadOnlyCollection<Overwrite> Overwrites { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
index 7af5ca10c..d09b658cf 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs
@@ -1,14 +1,14 @@
-using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a channel deletion.
+    /// </summary>
     public class ChannelDeleteAuditLogData : IAuditLogData
     {
         private ChannelDeleteAuditLogData(ulong id, string name, ChannelType type, IReadOnlyCollection<Overwrite> overwrites)
@@ -37,9 +37,33 @@ namespace Discord.Rest
             return new ChannelDeleteAuditLogData(id, name, type, overwrites.ToReadOnlyCollection());
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the deleted channel.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier for the deleted channel.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the name of the deleted channel.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the deleted channel.
+        /// </returns>
         public string ChannelName { get; }
+        /// <summary>
+        ///     Gets the type of the deleted channel.
+        /// </summary>
+        /// <returns>
+        ///     The type of channel that was deleted.
+        /// </returns>
         public ChannelType ChannelType { get; }
+        /// <summary>
+        ///     Gets a collection of permission overwrites that was assigned to the deleted channel.
+        /// </summary>
+        /// <returns>
+        ///     A collection of permission <see cref="Overwrite"/>.
+        /// </returns>
         public IReadOnlyCollection<Overwrite> Overwrites { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelInfo.cs
index e2d6064a9..6382e8250 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents information for a channel.
+    /// </summary>
     public struct ChannelInfo
     {
         internal ChannelInfo(string name, string topic, int? bitrate, int? limit)
@@ -10,9 +13,35 @@ namespace Discord.Rest
             UserLimit = limit;
         }
 
+        /// <summary>
+        ///     Gets the name of this channel.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this channel.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the topic of this channel.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the topic of this channel, if any.
+        /// </returns>
         public string Topic { get; }
+        /// <summary>
+        ///     Gets the bit-rate of this channel if applicable.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="System.Int32"/> representing the bit-rate set for the voice channel; <c>null</c> if not
+        ///     applicable.
+        /// </returns>
         public int? Bitrate { get; }
+        /// <summary>
+        ///     Gets the number of users allowed to be in this channel if applicable.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="System.Int32" /> representing the number of users allowed to be in this voice channel; 
+        ///     <c>null</c> if not applicable.
+        /// </returns>
         public int? UserLimit { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
index 36fe82084..f37404906 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a channel update.
+    /// </summary>
     public class ChannelUpdateAuditLogData : IAuditLogData
     {
         private ChannelUpdateAuditLogData(ulong id, ChannelInfo before, ChannelInfo after)
@@ -38,8 +41,26 @@ namespace Discord.Rest
             return new ChannelUpdateAuditLogData(entry.TargetId.Value, before, after);
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the updated channel.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier for the updated channel.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the channel information before the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the original channel information before the changes were made.
+        /// </returns>
         public ChannelInfo Before { get; }
+        /// <summary>
+        ///     Gets the channel information after the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the channel information after the changes were made.
+        /// </returns>
         public ChannelInfo After { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
index dac2d90ef..92e92574f 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs
@@ -1,14 +1,13 @@
-using System;
-using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an emoji creation.
+    /// </summary>
     public class EmoteCreateAuditLogData : IAuditLogData
     {
         private EmoteCreateAuditLogData(ulong id, string name)
@@ -25,7 +24,19 @@ namespace Discord.Rest
             return new EmoteCreateAuditLogData(entry.TargetId.Value, emoteName);
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the created emoji.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="System.UInt64"/> representing the snowflake identifier for the created emoji.
+        /// </returns>
         public ulong EmoteId { get; }
+        /// <summary>
+        ///     Gets the name of the created emoji.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the created emoji.
+        /// </returns>
         public string Name { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
index 73cb31af9..fd307d5a9 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an emoji deletion.
+    /// </summary>
     public class EmoteDeleteAuditLogData : IAuditLogData
     {
         private EmoteDeleteAuditLogData(ulong id, string name)
@@ -22,7 +25,19 @@ namespace Discord.Rest
             return new EmoteDeleteAuditLogData(entry.TargetId.Value, emoteName);
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the deleted emoji.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="System.UInt64"/> representing the snowflake identifier for the deleted emoji.
+        /// </returns>
         public ulong EmoteId { get; }
+        /// <summary>
+        ///     Gets the name of the deleted emoji.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the deleted emoji.
+        /// </returns>
         public string Name { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
index 84898013d..96e791d81 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an emoji update.
+    /// </summary>
     public class EmoteUpdateAuditLogData : IAuditLogData
     {
         private EmoteUpdateAuditLogData(ulong id, string oldName, string newName)
@@ -24,8 +27,26 @@ namespace Discord.Rest
             return new EmoteUpdateAuditLogData(entry.TargetId.Value, oldName, newName);
         }
 
+        /// <summary>
+        ///     Gets the snowflake ID of the updated emoji.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the updated emoji.
+        /// </returns>
         public ulong EmoteId { get; }
+        /// <summary>
+        ///     Gets the new name of the updated emoji.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the new name of the updated emoji.
+        /// </returns>
         public string NewName { get; }
+        /// <summary>
+        ///     Gets the old name of the updated emoji.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the old name of the updated emoji.
+        /// </returns>
         public string OldName { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs
index 90865ef72..df63251d8 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents information for a guild.
+    /// </summary>
     public struct GuildInfo
     {
         internal GuildInfo(int? afkTimeout, DefaultMessageNotifications? defaultNotifs,
@@ -18,14 +21,66 @@ namespace Discord.Rest
             ContentFilterLevel = filter;
         }
 
+        /// <summary>
+        ///     Gets the amount of time (in seconds) a user must be inactive in a voice channel for until they are
+        ///     automatically moved to the AFK voice channel.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the amount of time in seconds for a user to be marked as inactive
+        ///     and moved into the AFK voice channel.
+        /// </returns>
         public int? AfkTimeout { get; }
+        /// <summary>
+        ///     Gets the default message notifications for users who haven't explicitly set their notification settings.
+        /// </summary>
         public DefaultMessageNotifications? DefaultMessageNotifications { get; }
+        /// <summary>
+        ///     Gets the ID of the AFK voice channel for this guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the AFK voice channel; <c>null</c> if
+        ///     none is set.
+        /// </returns>
         public ulong? AfkChannelId { get; }
+        /// <summary>
+        ///     Gets the name of this guild.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this guild.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the ID of the region hosting this guild's voice channels.
+        /// </summary>
         public string RegionId { get; }
+        /// <summary>
+        ///     Gets the ID of this guild's icon.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the identifier for the splash image; <c>null</c> if none is set.
+        /// </returns>
         public string IconHash { get; }
+        /// <summary>
+        ///     Gets the level of requirements a user must fulfill before being allowed to post messages in this guild.
+        /// </summary>
+        /// <returns>
+        ///     The level of requirements.
+        /// </returns>
         public VerificationLevel? VerificationLevel { get; }
+        /// <summary>
+        ///     Gets the owner of this guild.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the owner of this guild.
+        /// </returns>
         public IUser Owner { get; }
+        /// <summary>
+        ///     Gets the level of Multi-Factor Authentication requirements a user must fulfill before being allowed to
+        ///     perform administrative actions in this guild.
+        /// </summary>
+        /// <returns>
+        ///     The level of MFA requirement.
+        /// </returns>
         public MfaLevel? MfaLevel { get; }
         public int? ContentFilterLevel { get; }
     }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
index 09c1eda18..16f027a7d 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a guild update.
+    /// </summary>
     public class GuildUpdateAuditLogData : IAuditLogData
     {
         private GuildUpdateAuditLogData(GuildInfo before, GuildInfo after)
@@ -73,7 +76,19 @@ namespace Discord.Rest
             return new GuildUpdateAuditLogData(before, after);
         }
 
+        /// <summary>
+        ///     Gets the guild information before the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the original guild information before the changes were made.
+        /// </returns>
         public GuildInfo Before { get; }
+        /// <summary>
+        ///     Gets the guild information after the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the guild information after the changes were made.
+        /// </returns>
         public GuildInfo After { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
index 1d7f48e93..215a3c164 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an invite creation.
+    /// </summary>
     public class InviteCreateAuditLogData : IAuditLogData
     {
         private InviteCreateAuditLogData(int maxAge, string code, bool temporary, IUser inviter, ulong channelId, int uses, int maxUses)
@@ -44,12 +47,56 @@ namespace Discord.Rest
             return new InviteCreateAuditLogData(maxAge, code, temporary, inviter, channelId, uses, maxUses);
         }
 
+        /// <summary>
+        ///     Gets the time (in seconds) until the invite expires.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the time in seconds until this invite expires.
+        /// </returns>
         public int MaxAge { get; }
+        /// <summary>
+        ///     Gets the unique identifier for this invite.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the invite code (e.g. <c>FTqNnyS</c>).
+        /// </returns>
         public string Code { get; }
+        /// <summary>
+        ///     Gets a value that determines whether the invite is a temporary one.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if users accepting this invite will be removed from the guild when they log off; otherwise
+        ///     <c>false</c>.
+        /// </returns>
         public bool Temporary { get; }
+        /// <summary>
+        ///     Gets the user that created this invite.
+        /// </summary>
+        /// <returns>
+        ///     A user that created this invite.
+        /// </returns>
         public IUser Creator { get; }
+        /// <summary>
+        ///     Gets the ID of the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the channel snowflake identifier that the invite points to.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the number of times this invite has been used.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of times this invite was used.
+        /// </returns>
         public int Uses { get; }
+        /// <summary>
+        ///     Gets the max number of uses this invite may have.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of uses this invite may be accepted until it is removed
+        ///     from the guild; <c>null</c> if none is set.
+        /// </returns>
         public int MaxUses { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
index 091285532..5e49bb641 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs
@@ -1,10 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an invite removal.
+    /// </summary>
     public class InviteDeleteAuditLogData : IAuditLogData
     {
         private InviteDeleteAuditLogData(int maxAge, string code, bool temporary, IUser inviter, ulong channelId, int uses, int maxUses)
@@ -44,12 +47,56 @@ namespace Discord.Rest
             return new InviteDeleteAuditLogData(maxAge, code, temporary, inviter, channelId, uses, maxUses);
         }
 
+        /// <summary>
+        ///     Gets the time (in seconds) until the invite expires.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the time in seconds until this invite expires.
+        /// </returns>
         public int MaxAge { get; }
+        /// <summary>
+        ///     Gets the unique identifier for this invite.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the invite code (e.g. <c>FTqNnyS</c>).
+        /// </returns>
         public string Code { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether the invite is a temporary one.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if users accepting this invite will be removed from the guild when they log off; otherwise
+        ///     <c>false</c>.
+        /// </returns>
         public bool Temporary { get; }
+        /// <summary>
+        ///     Gets the user that created this invite.
+        /// </summary>
+        /// <returns>
+        ///     A user that created this invite.
+        /// </returns>
         public IUser Creator { get; }
+        /// <summary>
+        ///     Gets the ID of the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the channel snowflake identifier that the invite points to.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the number of times this invite has been used.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of times this invite has been used.
+        /// </returns>
         public int Uses { get; }
+        /// <summary>
+        ///     Gets the max number of uses this invite may have.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of uses this invite may be accepted until it is removed
+        ///     from the guild; <c>null</c> if none is set.
+        /// </returns>
         public int MaxUses { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs
index c9840f6cc..aaad362da 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents information for an invite.
+    /// </summary>
     public struct InviteInfo
     {
         internal InviteInfo(int? maxAge, string code, bool? temporary, ulong? channelId, int? maxUses)
@@ -11,10 +14,44 @@ namespace Discord.Rest
             MaxUses = maxUses;
         }
 
+        /// <summary>
+        ///     Gets the time (in seconds) until the invite expires.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the time in seconds until this invite expires; <c>null</c> if this
+        ///     invite never expires or not specified.
+        /// </returns>
         public int? MaxAge { get; }
+        /// <summary>
+        ///     Gets the unique identifier for this invite.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the invite code (e.g. <c>FTqNnyS</c>).
+        /// </returns>
         public string Code { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether the invite is a temporary one.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if users accepting this invite will be removed from the guild when they log off, 
+        ///     <c>false</c> if not; <c>null</c> if not specified.
+        /// </returns>
         public bool? Temporary { get; }
+        /// <summary>
+        ///     Gets the ID of the channel this invite is linked to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the channel snowflake identifier that the invite points to; 
+        ///     <c>null</c> if not specified.
+        /// </returns>
         public ulong? ChannelId { get; }
+        /// <summary>
+        ///     Gets the max number of uses this invite may have.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of uses this invite may be accepted until it is removed
+        ///     from the guild; <c>null</c> if none is specified.
+        /// </returns>
         public int? MaxUses { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
index 35088be98..95bfb845a 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data relating to an invite update.
+    /// </summary>
     public class InviteUpdateAuditLogData : IAuditLogData
     {
         private InviteUpdateAuditLogData(InviteInfo before, InviteInfo after)
@@ -40,7 +43,19 @@ namespace Discord.Rest
             return new InviteUpdateAuditLogData(before, after);
         }
 
+        /// <summary>
+        ///     Gets the invite information before the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the original invite information before the changes were made.
+        /// </returns>
         public InviteInfo Before { get; }
+        /// <summary>
+        ///     Gets the invite information after the changes.
+        /// </summary>
+        /// <returns>
+        ///     An information object containing the invite information after the changes were made.
+        /// </returns>
         public InviteInfo After { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs
index 41b5526b8..dceb73d0a 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a kick.
+    /// </summary>
     public class KickAuditLogData : IAuditLogData
     {
         private KickAuditLogData(RestUser user)
@@ -18,6 +21,12 @@ namespace Discord.Rest
             return new KickAuditLogData(RestUser.Create(discord, userInfo));
         }
 
+        /// <summary>
+        ///     Gets the user that was kicked.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the kicked user.
+        /// </returns>
         public IUser Target { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
index 48adb1833..763c90c68 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs
@@ -1,4 +1,3 @@
-using System;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -7,6 +6,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a change in a guild member's roles.
+    /// </summary>
     public class MemberRoleAuditLogData : IAuditLogData
     {
         private MemberRoleAuditLogData(IReadOnlyCollection<MemberRoleEditInfo> roles, IUser target)
@@ -30,7 +32,20 @@ namespace Discord.Rest
             return new MemberRoleAuditLogData(roleInfos.ToReadOnlyCollection(), user);
         }
 
+        /// <summary>
+        ///     Gets a collection of role changes that were performed on the member.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of <see cref="MemberRoleEditInfo"/>, containing the roles that were changed on
+        ///     the member.
+        /// </returns>
         public IReadOnlyCollection<MemberRoleEditInfo> Roles { get; }
+        /// <summary>
+        ///     Gets the user that the roles changes were performed on.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the user that the role changes were performed on.
+        /// </returns>
         public IUser Target { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs
index 4838b75c9..b0abf2d95 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     An information object representing a change in one of a guild member's roles.
+    /// </summary>
     public struct MemberRoleEditInfo
     {
         internal MemberRoleEditInfo(string name, ulong roleId, bool added)
@@ -9,8 +12,26 @@ namespace Discord.Rest
             Added = added;
         }
 
+        /// <summary>
+        ///     Gets the name of the role that was changed.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the role that was changed.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the ID of the role that was changed.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the role that was changed.
+        /// </returns>
         public ulong RoleId { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether the role was added to the user.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the role was added to the user; otherwise <c>false</c>.
+        /// </returns>
         public bool Added { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
index 96d34610e..238c79843 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs
@@ -1,11 +1,13 @@
-using System.Linq;
+using System.Linq;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
-using ChangeModel = Discord.API.AuditLogChange;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a change in a guild member.
+    /// </summary>
     public class MemberUpdateAuditLogData : IAuditLogData
     {
         private MemberUpdateAuditLogData(IUser target, MemberInfo before, MemberInfo after)
@@ -42,6 +44,12 @@ namespace Discord.Rest
             return new MemberUpdateAuditLogData(user, before, after);
         }
 
+        /// <summary>
+        ///     Gets the user that the changes were performed on.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the user who the changes were performed on.
+        /// </returns>
         public IUser Target { get; }
         public MemberInfo Before { get; }
         public MemberInfo After { get; }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs
index 3949cdd68..317d47648 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs
@@ -3,6 +3,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to message deletion(s).
+    /// </summary>
     public class MessageDeleteAuditLogData : IAuditLogData
     {
         private MessageDeleteAuditLogData(ulong channelId, int count)
@@ -16,7 +19,20 @@ namespace Discord.Rest
             return new MessageDeleteAuditLogData(entry.Options.MessageDeleteChannelId.Value, entry.Options.MessageDeleteCount.Value);
         }
 
+        /// <summary>
+        ///     Gets the number of messages that were deleted.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of messages that were deleted from the channel.
+        /// </returns>
         public int MessageCount { get; }
+        /// <summary>
+        ///     Gets the ID of the channel that the messages were deleted from.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier for the channel that the messages were
+        ///     deleted from.
+        /// </returns>
         public ulong ChannelId { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
index b13f4b8fd..a9ccd4db3 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data for a permissions overwrite creation.
+    /// </summary>
     public class OverwriteCreateAuditLogData : IAuditLogData
     {
         private OverwriteCreateAuditLogData(Overwrite overwrite)
@@ -30,6 +33,12 @@ namespace Discord.Rest
             return new OverwriteCreateAuditLogData(new Overwrite(id, type, permissions));
         }
 
+        /// <summary>
+        ///     Gets the permission overwrite object that was created.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="Overwrite"/> object representing the overwrite that was created.
+        /// </returns>
         public Overwrite Overwrite { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
index 5d5177d9a..1e51fa5e3 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs
@@ -1,16 +1,13 @@
-using System;
-using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
-using ChangeModel = Discord.API.AuditLogChange;
-using OptionModel = Discord.API.AuditLogOptions;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to the deletion of a permission overwrite.
+    /// </summary>
     public class OverwriteDeleteAuditLogData : IAuditLogData
     {
         private OverwriteDeleteAuditLogData(Overwrite deletedOverwrite)
@@ -35,6 +32,12 @@ namespace Discord.Rest
             return new OverwriteDeleteAuditLogData(new Overwrite(id, type, new OverwritePermissions(allow, deny)));
         }
 
+        /// <summary>
+        ///     Gets the permission overwrite object that was deleted.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="Overwrite"/> object representing the overwrite that was deleted.
+        /// </returns>
         public Overwrite Overwrite { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
index d05e1feff..ac67c85cf 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to the update of a permission overwrite.
+    /// </summary>
     public class OverwriteUpdateAuditLogData : IAuditLogData
     {
         private OverwriteUpdateAuditLogData(OverwritePermissions before, OverwritePermissions after, ulong targetId, PermissionTarget targetType)
@@ -35,10 +38,35 @@ namespace Discord.Rest
             return new OverwriteUpdateAuditLogData(beforePermissions, afterPermissions, entry.Options.OverwriteTargetId.Value, type);
         }
 
+        /// <summary>
+        ///     Gets the overwrite permissions before the changes.
+        /// </summary>
+        /// <returns>
+        ///     An overwrite permissions object representing the overwrite permissions that the overwrite had before
+        ///     the changes were made.
+        /// </returns>
         public OverwritePermissions OldPermissions { get; }
+        /// <summary>
+        ///     Gets the overwrite permissions after the changes.
+        /// </summary>
+        /// <returns>
+        ///     An overwrite permissions object representing the overwrite permissions that the overwrite had after the
+        ///     changes.
+        /// </returns>
         public OverwritePermissions NewPermissions { get; }
-
+        /// <summary>
+        ///     Gets the ID of the overwrite that was updated.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the overwrite that was updated.
+        /// </returns>
         public ulong OverwriteTargetId { get; }
+        /// <summary>
+        ///     Gets the target of the updated permission overwrite.
+        /// </summary>
+        /// <returns>
+        ///     The target of the updated permission overwrite.
+        /// </returns>
         public PermissionTarget OverwriteType { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs
index 0005e304d..c32d12b3f 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs
@@ -3,6 +3,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a guild prune.
+    /// </summary>
     public class PruneAuditLogData : IAuditLogData
     {
         private PruneAuditLogData(int pruneDays, int membersRemoved)
@@ -16,7 +19,22 @@ namespace Discord.Rest
             return new PruneAuditLogData(entry.Options.PruneDeleteMemberDays.Value, entry.Options.PruneMembersRemoved.Value);
         }
 
+        /// <summary>
+        ///     Gets the threshold for a guild member to not be kicked.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the amount of days that a member must have been seen in the server,
+        ///     to avoid being kicked. (i.e. If a user has not been seen for more than <paramref cref="PruneDays"/>, they will be
+        ///     kicked from the server)
+        /// </returns>
         public int PruneDays { get; }
+        /// <summary>
+        ///     Gets the number of members that were kicked during the purge.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> representing the number of members that were removed from this guild for having
+        ///     not been seen within <paramref cref="PruneDays"/>.
+        /// </returns>
         public int MembersRemoved { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
index 69e72fdb0..cee255fb0 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a role creation.
+    /// </summary>
     public class RoleCreateAuditLogData : IAuditLogData
     {
         private RoleCreateAuditLogData(ulong id, RoleEditInfo props)
@@ -41,7 +44,19 @@ namespace Discord.Rest
                 new RoleEditInfo(color, mentionable, hoist, name, permissions));
         }
 
+        /// <summary>
+        ///     Gets the ID of the role that was created.
+        /// </summary>
+        /// <return>
+        ///     A <see cref="ulong"/> representing the snowflake identifier to the role that was created.
+        /// </return>
         public ulong RoleId { get; }
+        /// <summary>
+        ///     Gets the role information that was created.
+        /// </summary>
+        /// <return>
+        ///     An information object representing the properties of the role that was created.
+        /// </return>
         public RoleEditInfo Properties { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
index f812567cb..78b5efc87 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data relating to a role deletion.
+    /// </summary>
     public class RoleDeleteAuditLogData : IAuditLogData
     {
         private RoleDeleteAuditLogData(ulong id, RoleEditInfo props)
@@ -41,7 +44,19 @@ namespace Discord.Rest
                 new RoleEditInfo(color, mentionable, hoist, name, permissions));
         }
 
+        /// <summary>
+        ///     Gets the ID of the role that was deleted.
+        /// </summary>
+        /// <return>
+        ///     A <see cref="ulong"/> representing the snowflake identifier to the role that was deleted.
+        /// </return>
         public ulong RoleId { get; }
+        /// <summary>
+        ///     Gets the role information that was deleted.
+        /// </summary>
+        /// <return>
+        ///     An information object representing the properties of the role that was deleted.
+        /// </return>
         public RoleEditInfo Properties { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs
index 186ea8d11..6f3d8d387 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents information for a role edit.
+    /// </summary>
     public struct RoleEditInfo
     {
         internal RoleEditInfo(Color? color, bool? mentionable, bool? hoist, string name,
@@ -12,10 +15,45 @@ namespace Discord.Rest
             Permissions = permissions;
         }
 
+        /// <summary>
+        ///     Gets the color of this role.
+        /// </summary>
+        /// <returns>
+        ///     A color object representing the color assigned to this role; <c>null</c> if this role does not have a
+        ///     color.
+        /// </returns>
         public Color? Color { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this role is mentionable.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if other members can mention this role in a text channel; otherwise <c>false</c>; 
+        ///     <c>null</c> if this is not mentioned in this entry.
+        /// </returns>
         public bool? Mentionable { get; }
+        /// <summary>
+        ///     Gets a value that indicates whether this role is hoisted (i.e. its members will appear in a separate
+        ///     section on the user list).
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if this role's members will appear in a separate section in the user list; otherwise 
+        ///     <c>false</c>; <c>null</c> if this is not mentioned in this entry.
+        /// </returns>
         public bool? Hoist { get; }
+        /// <summary>
+        ///     Gets the name of this role.
+        /// </summary>
+        /// <returns>
+        ///    A string containing the name of this role.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the permissions assigned to this role.
+        /// </summary>
+        /// <returns>
+        ///     A guild permissions object representing the permissions that have been assigned to this role; <c>null</c>
+        ///     if no permissions have been assigned.
+        /// </returns>
         public GuildPermissions? Permissions { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
index 5cea865f1..f98fc3e23 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a role update.
+    /// </summary>
     public class RoleUpdateAuditLogData : IAuditLogData
     {
         private RoleUpdateAuditLogData(ulong id, RoleEditInfo oldProps, RoleEditInfo newProps)
@@ -55,8 +58,26 @@ namespace Discord.Rest
             return new RoleUpdateAuditLogData(entry.TargetId.Value, oldProps, newProps);
         }
 
+        /// <summary>
+        ///     Gets the ID of the role that was changed.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the role that was changed.
+        /// </returns>
         public ulong RoleId { get; }
+        /// <summary>
+        ///     Gets the role information before the changes.
+        /// </summary>
+        /// <returns>
+        ///     A role information object containing the role information before the changes were made.
+        /// </returns>
         public RoleEditInfo Before { get; }
+        /// <summary>
+        ///     Gets the role information after the changes.
+        /// </summary>
+        /// <returns>
+        ///     A role information object containing the role information after the changes were made.
+        /// </returns>
         public RoleEditInfo After { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs
index c94f18271..bc7e7fd4f 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to an unban.
+    /// </summary>
     public class UnbanAuditLogData : IAuditLogData
     {
         private UnbanAuditLogData(IUser user)
@@ -18,6 +21,12 @@ namespace Discord.Rest
             return new UnbanAuditLogData(RestUser.Create(discord, userInfo));
         }
 
+        /// <summary>
+        ///     Gets the user that was unbanned.
+        /// </summary>
+        /// <returns>
+        ///     A user object representing the user that was unbanned.
+        /// </returns>
         public IUser Target { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
index 06932bfc4..21388f985 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs
@@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a webhook creation.
+    /// </summary>
     public class WebhookCreateAuditLogData : IAuditLogData
     {
         private WebhookCreateAuditLogData(IWebhook webhook, WebhookType type, string name, ulong channelId)
@@ -33,12 +36,40 @@ namespace Discord.Rest
             return new WebhookCreateAuditLogData(webhook, type, name, channelId);
         }
 
-        //Corresponds to the *current* data
+        // Doc Note: Corresponds to the *current* data
+
+        /// <summary>
+        ///     Gets the webhook that was created.
+        /// </summary>
+        /// <returns>
+        ///     A webhook object representing the webhook that was created.
+        /// </returns>
         public IWebhook Webhook { get; }
 
-        //Corresponds to the *audit log* data
+        // Doc Note: Corresponds to the *audit log* data
+
+        /// <summary>
+        ///     Gets the type of webhook that was created.
+        /// </summary>
+        /// <returns>
+        ///     The type of webhook that was created.
+        /// </returns>
         public WebhookType Type { get; }
+
+        /// <summary>
+        ///     Gets the name of the webhook.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the webhook.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the ID of the channel that the webhook could send to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the channel that the webhook could send
+        ///     to.
+        /// </returns>
         public ulong ChannelId { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
index 8fc4da578..308020c95 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs
@@ -1,14 +1,13 @@
-using System;
-using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a webhook deletion.
+    /// </summary>
     public class WebhookDeleteAuditLogData : IAuditLogData
     {
         private WebhookDeleteAuditLogData(ulong id, ulong channel, WebhookType type, string name, string avatar)
@@ -37,10 +36,41 @@ namespace Discord.Rest
             return new WebhookDeleteAuditLogData(entry.TargetId.Value, channelId, type, name, avatarHash);
         }
 
+        /// <summary>
+        ///     Gets the ID of the webhook that was deleted.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the webhook that was deleted.
+        /// </returns>
         public ulong WebhookId { get; }
+        /// <summary>
+        ///     Gets the ID of the channel that the webhook could send to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the channel that the webhook could send
+        ///     to.
+        /// </returns>
         public ulong ChannelId { get; }
+        /// <summary>
+        ///     Gets the type of the webhook that was deleted.
+        /// </summary>
+        /// <returns>
+        ///     The type of webhook that was deleted.
+        /// </returns>
         public WebhookType Type { get; }
+        /// <summary>
+        ///     Gets the name of the webhook that was deleted.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the webhook that was deleted.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the hash value of the webhook's avatar.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the hash of the webhook's avatar.
+        /// </returns>
         public string Avatar { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs
index 26975cc7c..e60157b1a 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs
@@ -1,5 +1,8 @@
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents information for a webhook.
+    /// </summary>
     public struct WebhookInfo
     {
         internal WebhookInfo(string name, ulong? channelId, string avatar)
@@ -9,8 +12,27 @@ namespace Discord.Rest
             Avatar = avatar;
         }
 
+        /// <summary>
+        ///     Gets the name of this webhook.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of this webhook.
+        /// </returns>
         public string Name { get; }
+        /// <summary>
+        ///     Gets the ID of the channel that this webhook sends to.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the channel that this webhook can send
+        ///     to.
+        /// </returns>
         public ulong? ChannelId { get; }
+        /// <summary>
+        ///     Gets the hash value of this webhook's avatar.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the hash of this webhook's avatar.
+        /// </returns>
         public string Avatar { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
index ad7db53e2..18fe865df 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs
@@ -1,14 +1,13 @@
-using System;
-using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 using Model = Discord.API.AuditLog;
 using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Contains a piece of audit log data related to a webhook update.
+    /// </summary>
     public class WebhookUpdateAuditLogData : IAuditLogData
     {
         private WebhookUpdateAuditLogData(IWebhook webhook, WebhookInfo before, WebhookInfo after)
@@ -42,11 +41,28 @@ namespace Discord.Rest
             return new WebhookUpdateAuditLogData(webhook, before, after);
         }
 
-        //Again, the *current* data
+        /// <summary>
+        ///     Gets the webhook that was updated.
+        /// </summary>
+        /// <returns>
+        ///     A webhook object representing the webhook that was updated.
+        /// </returns>
         public IWebhook Webhook { get; }
 
-        //And the *audit log* data
+        /// <summary>
+        ///     Gets the webhook information before the changes.
+        /// </summary>
+        /// <returns>
+        ///     A webhook information object representing the webhook before the changes were made.
+        /// </returns>
         public WebhookInfo Before { get; }
+
+        /// <summary>
+        ///     Gets the webhook information after the changes.
+        /// </summary>
+        /// <returns>
+        ///     A webhook information object representing the webhook after the changes were made.
+        /// </returns>
         public WebhookInfo After { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/RestAuditLogEntry.cs b/src/Discord.Net.Rest/Entities/AuditLogs/RestAuditLogEntry.cs
index d01e964ae..d604077f4 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/RestAuditLogEntry.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/RestAuditLogEntry.cs
@@ -6,6 +6,9 @@ using EntryModel = Discord.API.AuditLogEntry;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based audit log entry.
+    /// </summary>
     public class RestAuditLogEntry : RestEntity<ulong>, IAuditLogEntry
     {
         private RestAuditLogEntry(BaseDiscordClient discord, Model fullLog, EntryModel model, IUser user)
diff --git a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
index 74ce7870f..716f3beaf 100644
--- a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using System.Threading.Tasks;
 using Model = Discord.API.Channel;
 using UserModel = Discord.API.User;
-using WebhookModel = Discord.API.Webhook;
 
 namespace Discord.Rest
 {
@@ -78,14 +77,8 @@ namespace Discord.Rest
             int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
         {
             var args = new CreateChannelInviteParams { IsTemporary = isTemporary, IsUnique = isUnique };
-            if (maxAge.HasValue)
-                args.MaxAge = maxAge.Value;
-            else
-                args.MaxAge = 0;
-            if (maxUses.HasValue)
-                args.MaxUses = maxUses.Value;
-            else
-                args.MaxUses = 0;
+            args.MaxAge = maxAge.GetValueOrDefault(0);
+            args.MaxUses = maxUses.GetValueOrDefault(0);
             var model = await client.ApiClient.CreateChannelInviteAsync(channel.Id, args, options).ConfigureAwait(false);
             return RestInviteMetadata.Create(client, null, channel, model);
         }
@@ -161,6 +154,7 @@ namespace Discord.Rest
             return builder.ToImmutable();
         }
 
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public static async Task<RestUserMessage> SendMessageAsync(IMessageChannel channel, BaseDiscordClient client,
             string text, bool isTTS, Embed embed, RequestOptions options)
         {
@@ -169,6 +163,30 @@ namespace Discord.Rest
             return RestUserMessage.Create(client, channel, client.CurrentUser, model);
         }
 
+        /// <exception cref="ArgumentException">
+        /// <paramref name="filePath" /> is a zero-length string, contains only white space, or contains one or more
+        /// invalid characters as defined by <see cref="System.IO.Path.GetInvalidPathChars"/>.
+        /// </exception>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="filePath" /> is <c>null</c>.
+        /// </exception>
+        /// <exception cref="PathTooLongException">
+        /// The specified path, file name, or both exceed the system-defined maximum length. For example, on
+        /// Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260
+        /// characters.
+        /// </exception>
+        /// <exception cref="DirectoryNotFoundException">
+        /// The specified path is invalid, (for example, it is on an unmapped drive).
+        /// </exception>
+        /// <exception cref="UnauthorizedAccessException">
+        /// <paramref name="filePath" /> specified a directory.-or- The caller does not have the required permission.
+        /// </exception>
+        /// <exception cref="FileNotFoundException">
+        /// The file specified in <paramref name="filePath" /> was not found.
+        /// </exception>
+        /// <exception cref="NotSupportedException"><paramref name="filePath" /> is in an invalid format.</exception>
+        /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public static async Task<RestUserMessage> SendFileAsync(IMessageChannel channel, BaseDiscordClient client,
             string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
         {
@@ -177,6 +195,7 @@ namespace Discord.Rest
                 return await SendFileAsync(channel, client, file, filename, text, isTTS, embed, options).ConfigureAwait(false);
         }
 
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public static async Task<RestUserMessage> SendFileAsync(IMessageChannel channel, BaseDiscordClient client,
             Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
         {
@@ -241,6 +260,7 @@ namespace Discord.Rest
         }
 
         //Users
+        /// <exception cref="InvalidOperationException">Resolving permissions requires the parent guild to be downloaded.</exception>
         public static async Task<RestGuildUser> GetUserAsync(IGuildChannel channel, IGuild guild, BaseDiscordClient client,
             ulong id, RequestOptions options)
         {
@@ -253,6 +273,7 @@ namespace Discord.Rest
 
             return user;
         }
+        /// <exception cref="InvalidOperationException">Resolving permissions requires the parent guild to be downloaded.</exception>
         public static IAsyncEnumerable<IReadOnlyCollection<RestGuildUser>> GetUsersAsync(IGuildChannel channel, IGuild guild, BaseDiscordClient client,
             ulong? fromUserId, int? limit, RequestOptions options)
         {
@@ -292,7 +313,7 @@ namespace Discord.Rest
         }
         public static IDisposable EnterTypingState(IMessageChannel channel, BaseDiscordClient client,
             RequestOptions options)
-            => new TypingNotifier(client, channel, options);
+            => new TypingNotifier(channel, options);
 
         //Webhooks
         public static async Task<RestWebhook> CreateWebhookAsync(ITextChannel channel, BaseDiscordClient client, string name, Stream avatar, RequestOptions options)
diff --git a/src/Discord.Net.Rest/Entities/Channels/IRestMessageChannel.cs b/src/Discord.Net.Rest/Entities/Channels/IRestMessageChannel.cs
index e0095c7b1..42ca20f7c 100644
--- a/src/Discord.Net.Rest/Entities/Channels/IRestMessageChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/IRestMessageChannel.cs
@@ -4,25 +4,193 @@ using System.Threading.Tasks;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based channel that can send and receive messages.
+    /// </summary>
     public interface IRestMessageChannel : IMessageChannel
     {
-        /// <summary> Sends a message to this message channel. </summary>
+        /// <summary>
+        ///     Sends a message to this message channel.
+        /// </summary>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Determines whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/>embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>.
+        ///     </note>
+        /// </remarks>
+        /// <param name="filePath">The file path of the file.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich" /> <see cref="Embed" /> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendFileAsync(string filePath, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/>embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>.
+        ///     </note>
+        /// </remarks>
+        /// <param name="stream">The <see cref="Stream" /> of the file to be sent.</param>
+        /// <param name="filename">The name of the attachment.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
 
-        /// <summary> Gets a message from this message channel with the given id, or null if not found. </summary>
+        /// <summary>
+        ///     Gets a message from this message channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the message.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous get operation for retrieving the message. The task result contains
+        ///     the retrieved message; <c>null</c> if no message is found with the specified identifier.
+        /// </returns>
         Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null);
-        /// <summary> Gets the last N messages from this message channel. </summary>
+        /// <summary>
+        ///     Gets the last N messages from this message channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/>. The
+        ///     library will attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example downloads 300 messages and gets messages that belong to the user 
+        ///     <c>53905483156684800</c>.
+        ///     <code lang="cs">
+        ///     var messages = await messageChannel.GetMessagesAsync(300).FlattenAsync();
+        ///     var userMessages = messages.Where(x =&gt; x.Author.Id == 53905483156684800);
+        ///     </code>
+        /// </example>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessageId"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to the message identifier <c>442012544660537354</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(442012544660537354, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessageId">The ID of the starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from
+        /// cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessage"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to a specific message, <c>oldMessage</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(oldMessage, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessage">The starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from
+        /// cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null);
-        /// <summary> Gets a collection of pinned messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of pinned messages in this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation for retrieving pinned messages in this channel.
+        ///     The task result contains a collection of messages found in the pinned messages.
+        /// </returns>
         new Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Channels/IRestPrivateChannel.cs b/src/Discord.Net.Rest/Entities/Channels/IRestPrivateChannel.cs
index a6939f81e..f387ac2d4 100644
--- a/src/Discord.Net.Rest/Entities/Channels/IRestPrivateChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/IRestPrivateChannel.cs
@@ -1,9 +1,15 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based channel that is private to select recipients.
+    /// </summary>
     public interface IRestPrivateChannel : IPrivateChannel
     {
+        /// <summary>
+        ///     Users that can access this channel.
+        /// </summary>
         new IReadOnlyCollection<RestUser> Recipients { get; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
index 321f1f1d2..9d69d6bdc 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
@@ -1,13 +1,14 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using System.IO;
-using System.Linq;
 using System.Threading.Tasks;
 using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based category channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestCategoryChannel : RestGuildChannel, ICategoryChannel
     {
@@ -25,14 +26,22 @@ namespace Discord.Rest
         private string DebuggerDisplay => $"{Name} ({Id}, Category)";
 
         // IGuildChannel
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
             => throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
             => throw new NotSupportedException();
 
         //IChannel
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => throw new NotSupportedException();
     }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestChannel.cs
index 5860d8283..dd190199f 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestChannel.cs
@@ -6,14 +6,19 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a generic REST-based channel.
+    /// </summary>
     public class RestChannel : RestEntity<ulong>, IChannel, IUpdateable
     {
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
 
         internal RestChannel(BaseDiscordClient discord, ulong id)
             : base(discord, id)
         {
         }
+        /// <exception cref="InvalidOperationException">Unexpected channel type.</exception>
         internal static RestChannel Create(BaseDiscordClient discord, Model model)
         {
             switch (model.Type)
@@ -30,6 +35,7 @@ namespace Discord.Rest
                     return new RestChannel(discord, model.Id);
             }
         }
+        /// <exception cref="InvalidOperationException">Unexpected channel type.</exception>
         internal static IRestPrivateChannel CreatePrivate(BaseDiscordClient discord, Model model)
         {
             switch (model.Type)
@@ -44,13 +50,17 @@ namespace Discord.Rest
         }
         internal virtual void Update(Model model) { }
 
+        /// <inheritdoc />
         public virtual Task UpdateAsync(RequestOptions options = null) => Task.Delay(0);
 
         //IChannel
+        /// <inheritdoc />
         string IChannel.Name => null;
 
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(null); //Overridden
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => AsyncEnumerable.Empty<IReadOnlyCollection<IUser>>(); //Overridden
     }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
index 20a76aaf0..bee096273 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestDMChannel.cs
@@ -9,12 +9,25 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based direct-message channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestDMChannel : RestChannel, IDMChannel, IRestPrivateChannel, IRestMessageChannel
     {
-        public RestUser CurrentUser { get; private set; }
-        public RestUser Recipient { get; private set; }
-
+        /// <summary>
+        ///     Gets the current logged-in user.
+        /// </summary>
+        public RestUser CurrentUser { get; }
+
+        /// <summary>
+        ///     Gets the recipient of the channel.
+        /// </summary>
+        public RestUser Recipient { get; }
+
+        /// <summary>
+        ///     Gets a collection that is the current logged-in user and the recipient.
+        /// </summary>
         public IReadOnlyCollection<RestUser> Users => ImmutableArray.Create(CurrentUser, Recipient);
 
         internal RestDMChannel(BaseDiscordClient discord, ulong id, ulong recipientId)
@@ -34,14 +47,24 @@ namespace Discord.Rest
             Recipient.Update(model.Recipients.Value[0]);
         }
 
+        /// <inheritdoc />
         public override async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetChannelAsync(Id, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task CloseAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
+
+        /// <summary>
+        ///     Gets a user in this channel from the provided <paramref name="id"/>.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <returns>
+        ///     A <see cref="RestUser"/> object that is a recipient of this channel; otherwise <c>null</c>.
+        /// </returns>
         public RestUser GetUser(ulong id)
         {
             if (id == Recipient.Id)
@@ -52,49 +75,96 @@ namespace Discord.Rest
                 return null;
         }
 
+        /// <inheritdoc />
         public Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetMessageAsync(this, Discord, id, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, null, Direction.Before, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessageId, dir, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessage.Id, dir, limit, options);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentException">
+        /// <paramref name="filePath" /> is a zero-length string, contains only white space, or contains one or more
+        /// invalid characters as defined by <see cref="System.IO.Path.GetInvalidPathChars"/>.
+        /// </exception>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="filePath" /> is <c>null</c>.
+        /// </exception>
+        /// <exception cref="PathTooLongException">
+        /// The specified path, file name, or both exceed the system-defined maximum length. For example, on
+        /// Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260
+        /// characters.
+        /// </exception>
+        /// <exception cref="DirectoryNotFoundException">
+        /// The specified path is invalid, (for example, it is on an unmapped drive).
+        /// </exception>
+        /// <exception cref="UnauthorizedAccessException">
+        /// <paramref name="filePath" /> specified a directory.-or- The caller does not have the required permission.
+        /// </exception>
+        /// <exception cref="FileNotFoundException">
+        /// The file specified in <paramref name="filePath" /> was not found.
+        /// </exception>
+        /// <exception cref="NotSupportedException"><paramref name="filePath" /> is in an invalid format.</exception>
+        /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
-
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
+        /// <summary>
+        ///     Gets a string that represents the Username#Discriminator of the recipient.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to the Recipient of this channel.
+        /// </returns>
         public override string ToString() => $"@{Recipient}";
         private string DebuggerDisplay => $"@{Recipient} ({Id}, DM)";
 
-        //IDMChannel            
+        //IDMChannel
+        /// <inheritdoc />
         IUser IDMChannel.Recipient => Recipient;
 
         //IRestPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<RestUser> IRestPrivateChannel.Recipients => ImmutableArray.Create(Recipient);
 
         //IPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<IUser> IPrivateChannel.Recipients => ImmutableArray.Create<IUser>(Recipient);
 
         //IMessageChannel
+        /// <inheritdoc />
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -102,6 +172,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -109,6 +180,7 @@ namespace Discord.Rest
             else
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -116,6 +188,7 @@ namespace Discord.Rest
             else
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -123,24 +196,27 @@ namespace Discord.Rest
             else
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
             => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
-
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
-
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
         //IChannel
+        /// <inheritdoc />
         string IChannel.Name => $"@{Recipient}";
 
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IUser>>(Users).ToAsyncEnumerable();
     }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
index c6b5d6ad0..39991d411 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs
@@ -10,12 +10,16 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based group-message channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGroupChannel : RestChannel, IGroupChannel, IRestPrivateChannel, IRestMessageChannel, IRestAudioChannel
     {
         private string _iconId;
         private ImmutableDictionary<ulong, RestGroupUser> _users;
 
+        /// <inheritdoc />
         public string Name { get; private set; }
 
         public IReadOnlyCollection<RestGroupUser> Users => _users.ToReadOnlyCollection();
@@ -49,12 +53,13 @@ namespace Discord.Rest
                 users[models[i].Id] = RestGroupUser.Create(Discord, models[i]);
             _users = users.ToImmutable();
         }
-
+        /// <inheritdoc />
         public override async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetChannelAsync(Id, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task LeaveAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
@@ -65,33 +70,70 @@ namespace Discord.Rest
             return null;
         }
 
+        /// <inheritdoc />
         public Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetMessageAsync(this, Discord, id, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, null, Direction.Before, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessageId, dir, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessage.Id, dir, limit, options);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentException">
+        /// <paramref name="filePath" /> is a zero-length string, contains only white space, or contains one or more
+        /// invalid characters as defined by <see cref="System.IO.Path.GetInvalidPathChars"/>.
+        /// </exception>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="filePath" /> is <c>null</c>.
+        /// </exception>
+        /// <exception cref="PathTooLongException">
+        /// The specified path, file name, or both exceed the system-defined maximum length. For example, on
+        /// Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260
+        /// characters.
+        /// </exception>
+        /// <exception cref="DirectoryNotFoundException">
+        /// The specified path is invalid, (for example, it is on an unmapped drive).
+        /// </exception>
+        /// <exception cref="UnauthorizedAccessException">
+        /// <paramref name="filePath" /> specified a directory.-or- The caller does not have the required permission.
+        /// </exception>
+        /// <exception cref="FileNotFoundException">
+        /// The file specified in <paramref name="filePath" /> was not found.
+        /// </exception>
+        /// <exception cref="NotSupportedException"><paramref name="filePath" /> is in an invalid format.</exception>
+        /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
-
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
@@ -143,10 +185,10 @@ namespace Discord.Rest
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
         //IAudioChannel
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Connecting to a group channel is not supported.</exception>
         Task<IAudioClient> IAudioChannel.ConnectAsync(bool selfDeaf, bool selfMute, bool external) { throw new NotSupportedException(); }
         Task IAudioChannel.DisconnectAsync() { throw new NotSupportedException(); }
 
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
index 1dbcf7e9a..380a64c8c 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
@@ -7,15 +7,22 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a private REST-based group channel.
+    /// </summary>
     public class RestGuildChannel : RestChannel, IGuildChannel
     {
         private ImmutableArray<Overwrite> _overwrites;
 
+        /// <inheritdoc />
         public IReadOnlyCollection<Overwrite> PermissionOverwrites => _overwrites;
 
         internal IGuild Guild { get; }
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public int Position { get; private set; }
+        /// <inheritdoc />
         public ulong GuildId => Guild.Id;
 
         internal RestGuildChannel(BaseDiscordClient discord, IGuild guild, ulong id)
@@ -49,19 +56,29 @@ namespace Discord.Rest
             _overwrites = newOverwrites.ToImmutable();
         }
 
+        /// <inheritdoc />
         public override async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetChannelAsync(GuildId, Id, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null)
         {
             var model = await ChannelHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the permission overwrite for a specific user.
+        /// </summary>
+        /// <param name="user">The user to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted user; <c>null</c> if none is set.
+        /// </returns>
         public OverwritePermissions? GetPermissionOverwrite(IUser user)
         {
             for (int i = 0; i < _overwrites.Length; i++)
@@ -71,6 +88,14 @@ namespace Discord.Rest
             }
             return null;
         }
+
+        /// <summary>
+        ///     Gets the permission overwrite for a specific role.
+        /// </summary>
+        /// <param name="role">The role to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted role; <c>null</c> if none is set.
+        /// </returns>
         public OverwritePermissions? GetPermissionOverwrite(IRole role)
         {
             for (int i = 0; i < _overwrites.Length; i++)
@@ -80,16 +105,44 @@ namespace Discord.Rest
             }
             return null;
         }
-        public async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions perms, RequestOptions options = null)
+
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given user.
+        /// </summary>
+        /// <param name="user">The user to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
+        public async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null)
         {
-            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, perms, options).ConfigureAwait(false);
-            _overwrites = _overwrites.Add(new Overwrite(user.Id, PermissionTarget.User, new OverwritePermissions(perms.AllowValue, perms.DenyValue)));
+            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, permissions, options).ConfigureAwait(false);
+            _overwrites = _overwrites.Add(new Overwrite(user.Id, PermissionTarget.User, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
         }
-        public async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions perms, RequestOptions options = null)
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given role.
+        /// </summary>
+        /// <param name="role">The role to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the role.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
+        public async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null)
         {
-            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, perms, options).ConfigureAwait(false);
-            _overwrites = _overwrites.Add(new Overwrite(role.Id, PermissionTarget.Role, new OverwritePermissions(perms.AllowValue, perms.DenyValue)));
+            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, permissions, options).ConfigureAwait(false);
+            _overwrites = _overwrites.Add(new Overwrite(role.Id, PermissionTarget.Role, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
         }
+
+        /// <summary>
+        ///     Removes the permission overwrite for the given user, if one exists.
+        /// </summary>
+        /// <param name="user">The user to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         public async Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null)
         {
             await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, user, options).ConfigureAwait(false);
@@ -103,6 +156,14 @@ namespace Discord.Rest
                 }
             }
         }
+        /// <summary>
+        ///     Removes the permission overwrite for the given role, if one exists.
+        /// </summary>
+        /// <param name="role">The role to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         public async Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null)
         {
             await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, role, options).ConfigureAwait(false);
@@ -117,14 +178,42 @@ namespace Discord.Rest
             }
         }
 
+        /// <summary>
+        ///     Gets a collection of all invites to this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of invite metadata that are created for this channel.
+        /// </returns>
         public async Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
             => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
+
+        /// <summary>
+        ///     Creates a new invite to this channel.
+        /// </summary>
+        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
+        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
+        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
+        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
+        ///     metadata object containing information for the created invite.
+        /// </returns>
         public async Task<RestInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
             => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
 
+        /// <summary>
+        ///     Gets the name of this channel.
+        /// </summary>
+        /// <returns>
+        ///     A string that is the name of this channel.
+        /// </returns>
         public override string ToString() => Name;
 
         //IGuildChannel
+        /// <inheritdoc />
         IGuild IGuildChannel.Guild
         {
             get
@@ -135,32 +224,44 @@ namespace Discord.Rest
             }
         }
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
             => await GetInvitesAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
             => await CreateInviteAsync(maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IRole role)
             => GetPermissionOverwrite(role);
+        /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IUser user)
             => GetPermissionOverwrite(user);
+        /// <inheritdoc />
         async Task IGuildChannel.AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options)
             => await AddPermissionOverwriteAsync(role, permissions, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options)
             => await AddPermissionOverwriteAsync(user, permissions, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.RemovePermissionOverwriteAsync(IRole role, RequestOptions options)
             => await RemovePermissionOverwriteAsync(role, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.RemovePermissionOverwriteAsync(IUser user, RequestOptions options)
             => await RemovePermissionOverwriteAsync(user, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => AsyncEnumerable.Empty<IReadOnlyCollection<IGuildUser>>(); //Overridden //Overridden in Text/Voice
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(null); //Overridden in Text/Voice
 
         //IChannel
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => AsyncEnumerable.Empty<IReadOnlyCollection<IUser>>(); //Overridden in Text/Voice
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(null); //Overridden in Text/Voice
     }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
index 12437c969..4ccd35a3a 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
@@ -8,17 +8,22 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based channel in a guild that can send and receive messages.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestTextChannel : RestGuildChannel, IRestMessageChannel, ITextChannel
     {
+        /// <inheritdoc />
         public string Topic { get; private set; }
         public int SlowModeInterval { get; private set; } 
+        /// <inheritdoc />
         public ulong? CategoryId { get; private set; }
 
+        /// <inheritdoc />
         public string Mention => MentionUtils.MentionChannel(Id);
-
-        private bool _nsfw;
-        public bool IsNsfw => _nsfw;
+        /// <inheritdoc />
+        public bool IsNsfw { get; private set; }
 
         internal RestTextChannel(BaseDiscordClient discord, IGuild guild, ulong id)
             : base(discord, guild, id)
@@ -30,82 +35,188 @@ namespace Discord.Rest
             entity.Update(model);
             return entity;
         }
+        /// <inheritdoc />
         internal override void Update(Model model)
         {
             base.Update(model);
             CategoryId = model.CategoryId;
             Topic = model.Topic.Value;
             SlowModeInterval = model.SlowMode.Value;
-            _nsfw = model.Nsfw.GetValueOrDefault();
+            IsNsfw = model.Nsfw.GetValueOrDefault();
         }
 
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<TextChannelProperties> func, RequestOptions options = null)
         {
             var model = await ChannelHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
 
+        /// <summary>
+        ///     Gets a user in this channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="InvalidOperationException">
+        /// Resolving permissions requires the parent guild to be downloaded.
+        /// </exception>
+        /// <returns>
+        ///     A task representing the asynchronous get operation. The task result contains a guild user object that
+        ///     represents the user; <c>null</c> if none is found.
+        /// </returns>
         public Task<RestGuildUser> GetUserAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetUserAsync(this, Guild, Discord, id, options);
+
+        /// <summary>
+        ///     Gets a collection of users that are able to view the channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="InvalidOperationException">
+        /// Resolving permissions requires the parent guild to be downloaded.
+        /// </exception>
+        /// <returns>
+        ///     A paged collection containing a collection of guild users that can access this channel. Flattening the
+        ///     paginated response into a collection of users with 
+        ///     <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<RestGuildUser>> GetUsersAsync(RequestOptions options = null)
             => ChannelHelper.GetUsersAsync(this, Guild, Discord, null, null, options);
 
+        /// <inheritdoc />
         public Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetMessageAsync(this, Discord, id, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, null, Direction.Before, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessageId, dir, limit, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => ChannelHelper.GetMessagesAsync(this, Discord, fromMessage.Id, dir, limit, options);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentException">
+        /// <paramref name="filePath" /> is a zero-length string, contains only white space, or contains one or more
+        /// invalid characters as defined by <see cref="System.IO.Path.GetInvalidPathChars"/>.
+        /// </exception>
+        /// <exception cref="ArgumentNullException">
+        /// <paramref name="filePath" /> is <c>null</c>.
+        /// </exception>
+        /// <exception cref="PathTooLongException">
+        /// The specified path, file name, or both exceed the system-defined maximum length. For example, on
+        /// Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260
+        /// characters.
+        /// </exception>
+        /// <exception cref="DirectoryNotFoundException">
+        /// The specified path is invalid, (for example, it is on an unmapped drive).
+        /// </exception>
+        /// <exception cref="UnauthorizedAccessException">
+        /// <paramref name="filePath" /> specified a directory.-or- The caller does not have the required permission.
+        /// </exception>
+        /// <exception cref="FileNotFoundException">
+        /// The file specified in <paramref name="filePath" /> was not found.
+        /// </exception>
+        /// <exception cref="NotSupportedException"><paramref name="filePath" /> is in an invalid format.</exception>
+        /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null)
             => ChannelHelper.DeleteMessagesAsync(this, Discord, messages.Select(x => x.Id), options);
+        /// <inheritdoc />
         public Task DeleteMessagesAsync(IEnumerable<ulong> messageIds, RequestOptions options = null)
             => ChannelHelper.DeleteMessagesAsync(this, Discord, messageIds, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
+        /// <summary>
+        ///     Creates a webhook in this text channel.
+        /// </summary>
+        /// <param name="name">The name of the webhook.</param>
+        /// <param name="avatar">The avatar of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     webhook.
+        /// </returns>
         public Task<RestWebhook> CreateWebhookAsync(string name, Stream avatar = null, RequestOptions options = null)
             => ChannelHelper.CreateWebhookAsync(this, Discord, name, avatar, options);
+        /// <summary>
+        ///     Gets a webhook available in this text channel.
+        /// </summary>
+        /// <param name="id">The identifier of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a webhook associated
+        ///     with the identifier; <c>null</c> if the webhook is not found.
+        /// </returns>
         public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetWebhookAsync(this, Discord, id, options);
+        /// <summary>
+        ///     Gets the webhooks available in this text channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks that is available in this channel.
+        /// </returns>
         public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
             => ChannelHelper.GetWebhooksAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the parent (category) channel of this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the category channel
+        ///     representing the parent of this channel; <c>null</c> if none is set.
+        /// </returns>
         public Task<ICategoryChannel> GetCategoryAsync(RequestOptions options = null)
             => ChannelHelper.GetCategoryAsync(this, Discord, options);
 
         private string DebuggerDisplay => $"{Name} ({Id}, Text)";
 
         //ITextChannel
+        /// <inheritdoc />
         async Task<IWebhook> ITextChannel.CreateWebhookAsync(string name, Stream avatar, RequestOptions options)
             => await CreateWebhookAsync(name, avatar, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IWebhook> ITextChannel.GetWebhookAsync(ulong id, RequestOptions options)
             => await GetWebhookAsync(id, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IWebhook>> ITextChannel.GetWebhooksAsync(RequestOptions options)
             => await GetWebhooksAsync(options).ConfigureAwait(false);
 
         //IMessageChannel
+        /// <inheritdoc />
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -113,6 +224,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -121,6 +233,7 @@ namespace Discord.Rest
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
 
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -128,6 +241,7 @@ namespace Discord.Rest
             else
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -135,20 +249,23 @@ namespace Discord.Rest
             else
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
             => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
         //IGuildChannel
+        /// <inheritdoc />
         async Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -156,6 +273,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -165,6 +283,7 @@ namespace Discord.Rest
         }
 
         //IChannel
+        /// <inheritdoc />
         async Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -172,6 +291,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -181,6 +301,7 @@ namespace Discord.Rest
         }
 
         // INestedChannel
+        /// <inheritdoc />
         async Task<ICategoryChannel> INestedChannel.GetCategoryAsync(CacheMode mode, RequestOptions options)
         {
             if (CategoryId.HasValue && mode == CacheMode.AllowDownload)
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
index 13f3b5efa..7f0295c18 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
@@ -8,11 +8,17 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based voice channel in a guild.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestVoiceChannel : RestGuildChannel, IVoiceChannel, IRestAudioChannel
     {
+        /// <inheritdoc />
         public int Bitrate { get; private set; }
+        /// <inheritdoc />
         public int? UserLimit { get; private set; }
+        /// <inheritdoc />
         public ulong? CategoryId { get; private set; }
 
         internal RestVoiceChannel(BaseDiscordClient discord, IGuild guild, ulong id)
@@ -25,6 +31,7 @@ namespace Discord.Rest
             entity.Update(model);
             return entity;
         }
+        /// <inheritdoc />
         internal override void Update(Model model)
         {
             base.Update(model);
@@ -33,24 +40,37 @@ namespace Discord.Rest
             UserLimit = model.UserLimit.Value != 0 ? model.UserLimit.Value : (int?)null;
         }
 
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<VoiceChannelProperties> func, RequestOptions options = null)
         {
             var model = await ChannelHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
 
+        /// <summary>
+        ///     Gets the parent (category) channel of this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the category channel
+        ///     representing the parent of this channel; <c>null</c> if none is set.
+        /// </returns>
         public Task<ICategoryChannel> GetCategoryAsync(RequestOptions options = null)
             => ChannelHelper.GetCategoryAsync(this, Discord, options);
 
         private string DebuggerDisplay => $"{Name} ({Id}, Voice)";
 
         //IAudioChannel
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Connecting to a REST-based channel is not supported.</exception>
         Task<IAudioClient> IAudioChannel.ConnectAsync(bool selfDeaf, bool selfMute, bool external) { throw new NotSupportedException(); }
         Task IAudioChannel.DisconnectAsync() { throw new NotSupportedException(); }
 
         //IGuildChannel
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(null);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => AsyncEnumerable.Empty<IReadOnlyCollection<IGuildUser>>();
 
diff --git a/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs
index e8b939e65..ce37af6b4 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs
@@ -41,13 +41,17 @@ namespace Discord.Rest
 
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
@@ -57,7 +61,7 @@ namespace Discord.Rest
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
-                return await GetMessageAsync(id, options);
+                return await GetMessageAsync(id, options).ConfigureAwait(false);
             else
                 return null;
         }
@@ -83,27 +87,24 @@ namespace Discord.Rest
                 return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
         }
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
-            => await GetPinnedMessagesAsync(options);
+            => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
 
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options);
 
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
-            => await SendFileAsync(stream, filename, text, isTTS, embed, options);
+            => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
-            => await SendMessageAsync(text, isTTS, embed, options);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
+            => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
 
         //IChannel
-        string IChannel.Name { get { throw new NotSupportedException(); } }
-        IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
-        {
+        string IChannel.Name => 
             throw new NotSupportedException();
-        }
-        Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
-        {
+
+        IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options) => 
+            throw new NotSupportedException();
+
+        Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options) => 
             throw new NotSupportedException();
-        }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index 2b7900154..823d41a05 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -14,10 +14,11 @@ namespace Discord.Rest
     internal static class GuildHelper
     {
         //General
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public static async Task<Model> ModifyAsync(IGuild guild, BaseDiscordClient client,
             Action<GuildProperties> func, RequestOptions options)
         {
-            if (func == null) throw new NullReferenceException(nameof(func));
+            if (func == null) throw new ArgumentNullException(nameof(func));
 
             var args = new GuildProperties();
             func(args);
@@ -31,7 +32,6 @@ namespace Discord.Rest
                 Icon = args.Icon.IsSpecified ? args.Icon.Value?.ToModel() : Optional.Create<ImageModel?>(),
                 Name = args.Name,
                 Splash = args.Splash.IsSpecified ? args.Splash.Value?.ToModel() : Optional.Create<ImageModel?>(),
-                Username = args.Username,
                 VerificationLevel = args.VerificationLevel
             };
 
@@ -62,10 +62,11 @@ namespace Discord.Rest
 
             return await client.ApiClient.ModifyGuildAsync(guild.Id, apiArgs, options).ConfigureAwait(false);
         }
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public static async Task<EmbedModel> ModifyEmbedAsync(IGuild guild, BaseDiscordClient client,
             Action<GuildEmbedProperties> func, RequestOptions options)
         {
-            if (func == null) throw new NullReferenceException(nameof(func));
+            if (func == null) throw new ArgumentNullException(nameof(func));
 
             var args = new GuildEmbedProperties();
             func(args);
@@ -144,6 +145,7 @@ namespace Discord.Rest
             var models = await client.ApiClient.GetGuildChannelsAsync(guild.Id, options).ConfigureAwait(false);
             return models.Select(x => RestGuildChannel.Create(client, guild, x)).ToImmutableArray();
         }
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         public static async Task<RestTextChannel> CreateTextChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options, Action<TextChannelProperties> func = null)
         {
@@ -161,6 +163,7 @@ namespace Discord.Rest
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestTextChannel.Create(client, guild, model);
         }
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         public static async Task<RestVoiceChannel> CreateVoiceChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options, Action<VoiceChannelProperties> func = null)
         {
@@ -178,6 +181,7 @@ namespace Discord.Rest
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestVoiceChannel.Create(client, guild, model);
         }
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client,
             string name, RequestOptions options)
         {
@@ -220,6 +224,7 @@ namespace Discord.Rest
         }
 
         //Roles
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         public static async Task<RestRole> CreateRoleAsync(IGuild guild, BaseDiscordClient client,
             string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options)
         {
@@ -266,7 +271,7 @@ namespace Discord.Rest
                     };
                     if (info.Position != null)
                         args.AfterUserId = info.Position.Value;
-                    var models = await client.ApiClient.GetGuildMembersAsync(guild.Id, args, options);
+                    var models = await client.ApiClient.GetGuildMembersAsync(guild.Id, args, options).ConfigureAwait(false);
                     return models.Select(x => RestGuildUser.Create(client, guild, x)).ToImmutableArray();
                 },
                 nextPage: (info, lastPage) =>
@@ -338,7 +343,7 @@ namespace Discord.Rest
         //Emotes
         public static async Task<GuildEmote> GetEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options)
         {
-            var emote = await client.ApiClient.GetGuildEmoteAsync(guild.Id, id, options);
+            var emote = await client.ApiClient.GetGuildEmoteAsync(guild.Id, id, options).ConfigureAwait(false);
             return emote.ToEntity();
         }
         public static async Task<GuildEmote> CreateEmoteAsync(IGuild guild, BaseDiscordClient client, string name, Image image, Optional<IEnumerable<IRole>> roles, 
@@ -350,11 +355,12 @@ namespace Discord.Rest
                 Image = image.ToModel()
             };
             if (roles.IsSpecified)
-                apiargs.RoleIds = roles.Value?.Select(xr => xr.Id)?.ToArray();
+                apiargs.RoleIds = roles.Value?.Select(xr => xr.Id).ToArray();
 
-            var emote = await client.ApiClient.CreateGuildEmoteAsync(guild.Id, apiargs, options);
+            var emote = await client.ApiClient.CreateGuildEmoteAsync(guild.Id, apiargs, options).ConfigureAwait(false);
             return emote.ToEntity();
         }
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, 
             RequestOptions options)
         {
@@ -368,9 +374,9 @@ namespace Discord.Rest
                 Name = props.Name
             };
             if (props.Roles.IsSpecified)
-                apiargs.RoleIds = props.Roles.Value?.Select(xr => xr.Id)?.ToArray();
+                apiargs.RoleIds = props.Roles.Value?.Select(xr => xr.Id).ToArray();
 
-            var emote = await client.ApiClient.ModifyGuildEmoteAsync(guild.Id, id, apiargs, options);
+            var emote = await client.ApiClient.ModifyGuildEmoteAsync(guild.Id, id, apiargs, options).ConfigureAwait(false);
             return emote.ToEntity();
         }
         public static Task DeleteEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options) 
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestBan.cs b/src/Discord.Net.Rest/Entities/Guilds/RestBan.cs
index 104bec903..ec8f60ae5 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestBan.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestBan.cs
@@ -1,12 +1,22 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.Ban;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based ban object.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestBan : IBan
     {
+        /// <summary>
+        ///     Gets the banned user.
+        /// </summary>
+        /// <returns>
+        ///     A generic <see cref="RestUser"/> object that was banned.
+        /// </returns>
         public RestUser User { get; }
+        /// <inheritdoc />
         public string Reason { get; }
 
         internal RestBan(RestUser user, string reason)
@@ -19,10 +29,17 @@ namespace Discord.Rest
             return new RestBan(RestUser.Create(client, model.User), model.Reason);
         }
 
+        /// <summary>
+        ///     Gets the name of the banned user.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the name of the user that was banned.
+        /// </returns>
         public override string ToString() => User.ToString();
         private string DebuggerDisplay => $"{User}: {Reason}";
 
         //IBan
+        /// <inheritdoc />
         IUser IBan.User => User;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index e6819e8a4..fda9b609d 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -10,6 +10,9 @@ using Model = Discord.API.Guild;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based guild/server.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGuild : RestEntity<ulong>, IGuild, IUpdateable
     {
@@ -17,32 +20,57 @@ namespace Discord.Rest
         private ImmutableArray<GuildEmote> _emotes;
         private ImmutableArray<string> _features;
 
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public int AFKTimeout { get; private set; }
+        /// <inheritdoc />
         public bool IsEmbeddable { get; private set; }
+        /// <inheritdoc />
         public VerificationLevel VerificationLevel { get; private set; }
+        /// <inheritdoc />
         public MfaLevel MfaLevel { get; private set; }
+        /// <inheritdoc />
         public DefaultMessageNotifications DefaultMessageNotifications { get; private set; }
 
+        /// <inheritdoc />
         public ulong? AFKChannelId { get; private set; }
+        /// <inheritdoc />
         public ulong? EmbedChannelId { get; private set; }
+        /// <inheritdoc />
         public ulong? SystemChannelId { get; private set; }
+        /// <inheritdoc />
         public ulong OwnerId { get; private set; }
+        /// <inheritdoc />
         public string VoiceRegionId { get; private set; }
+        /// <inheritdoc />
         public string IconId { get; private set; }
+        /// <inheritdoc />
         public string SplashId { get; private set; }
         internal bool Available { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
 
         [Obsolete("DefaultChannelId is deprecated, use GetDefaultChannelAsync")]
         public ulong DefaultChannelId => Id;
+        /// <inheritdoc />
         public string IconUrl => CDN.GetGuildIconUrl(Id, IconId);
+        /// <inheritdoc />
         public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId);
 
+        /// <summary>
+        ///     Gets the built-in role containing all users in this guild.
+        /// </summary>
         public RestRole EveryoneRole => GetRole(Id);
+
+        /// <summary>
+        ///     Gets a collection of all roles in this guild.
+        /// </summary>
         public IReadOnlyCollection<RestRole> Roles => _roles.ToReadOnlyCollection();
+        /// <inheritdoc />
         public IReadOnlyCollection<GuildEmote> Emotes => _emotes;
+        /// <inheritdoc />
         public IReadOnlyCollection<string> Features => _features;
 
         internal RestGuild(BaseDiscordClient client, ulong id)
@@ -103,89 +131,206 @@ namespace Discord.Rest
         }
 
         //General
+        /// <inheritdoc />
         public async Task UpdateAsync(RequestOptions options = null)
             => Update(await Discord.ApiClient.GetGuildAsync(Id, options).ConfigureAwait(false));
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => GuildHelper.DeleteAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public async Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null)
         {
             var model = await GuildHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
+
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public async Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null)
         {
             var model = await GuildHelper.ModifyEmbedAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
+
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="args" /> is <c>null</c>.</exception>
         public async Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null)
         {
             var arr = args.ToArray();
-            await GuildHelper.ReorderChannelsAsync(this, Discord, arr, options);
+            await GuildHelper.ReorderChannelsAsync(this, Discord, arr, options).ConfigureAwait(false);
         }
+        /// <inheritdoc />
         public async Task ReorderRolesAsync(IEnumerable<ReorderRoleProperties> args, RequestOptions options = null)
         {
             var models = await GuildHelper.ReorderRolesAsync(this, Discord, args, options).ConfigureAwait(false);
             foreach (var model in models)
             {
                 var role = GetRole(model.Id);
-                if (role != null)
-                    role.Update(model);
+                role?.Update(model);
             }
         }
-
+        
+        /// <inheritdoc />
         public Task LeaveAsync(RequestOptions options = null)
             => GuildHelper.LeaveAsync(this, Discord, options);
 
         //Bans
+        //Bans
+        /// <summary>
+        ///     Gets a collection of all users banned in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     ban objects that this guild currently possesses, with each object containing the user banned and reason
+        ///     behind the ban.
+        /// </returns>
         public Task<IReadOnlyCollection<RestBan>> GetBansAsync(RequestOptions options = null)
             => GuildHelper.GetBansAsync(this, Discord, options);
+        /// <summary>
+        ///     Gets a ban object for a banned user.
+        /// </summary>
+        /// <param name="user">The banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
+        /// </returns>
         public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null)
             => GuildHelper.GetBanAsync(this, Discord, user.Id, options);
+        /// <summary>
+        ///     Gets a ban object for a banned user.
+        /// </summary>
+        /// <param name="userId">The snowflake identifier for the banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
+        /// </returns>
         public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null)
             => GuildHelper.GetBanAsync(this, Discord, userId, options);
 
+        /// <inheritdoc />
         public Task AddBanAsync(IUser user, int pruneDays = 0, string reason = null, RequestOptions options = null)
             => GuildHelper.AddBanAsync(this, Discord, user.Id, pruneDays, reason, options);
+        /// <inheritdoc />
         public Task AddBanAsync(ulong userId, int pruneDays = 0, string reason = null, RequestOptions options = null)
             => GuildHelper.AddBanAsync(this, Discord, userId, pruneDays, reason, options);
 
+        /// <inheritdoc />
         public Task RemoveBanAsync(IUser user, RequestOptions options = null)
             => GuildHelper.RemoveBanAsync(this, Discord, user.Id, options);
+        /// <inheritdoc />
         public Task RemoveBanAsync(ulong userId, RequestOptions options = null)
             => GuildHelper.RemoveBanAsync(this, Discord, userId, options);
 
         //Channels
+        /// <summary>
+        ///     Gets a collection of all channels in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     generic channels found within this guild.
+        /// </returns>
         public Task<IReadOnlyCollection<RestGuildChannel>> GetChannelsAsync(RequestOptions options = null)
             => GuildHelper.GetChannelsAsync(this, Discord, options);
+
+        /// <summary>
+        ///     Gets a channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the channel.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the generic channel
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public Task<RestGuildChannel> GetChannelAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetChannelAsync(this, Discord, id, options);
+
+        /// <summary>
+        ///     Gets a text channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the text channel.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the text channel
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public async Task<RestTextChannel> GetTextChannelAsync(ulong id, RequestOptions options = null)
         {
             var channel = await GuildHelper.GetChannelAsync(this, Discord, id, options).ConfigureAwait(false);
             return channel as RestTextChannel;
         }
+
+        /// <summary>
+        ///     Gets a collection of all text channels in this guild.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     message channels found within this guild.
+        /// </returns>
         public async Task<IReadOnlyCollection<RestTextChannel>> GetTextChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
             return channels.OfType<RestTextChannel>().ToImmutableArray();
         }
+
+        /// <summary>
+        ///     Gets a voice channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the voice channel.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the voice channel associated
+        ///     with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public async Task<RestVoiceChannel> GetVoiceChannelAsync(ulong id, RequestOptions options = null)
         {
             var channel = await GuildHelper.GetChannelAsync(this, Discord, id, options).ConfigureAwait(false);
             return channel as RestVoiceChannel;
         }
+
+        /// <summary>
+        ///     Gets a collection of all voice channels in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     voice channels found within this guild.
+        /// </returns>
         public async Task<IReadOnlyCollection<RestVoiceChannel>> GetVoiceChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
             return channels.OfType<RestVoiceChannel>().ToImmutableArray();
         }
+
+        /// <summary>
+        ///     Gets a collection of all category channels in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     category channels found within this guild.
+        /// </returns>
         public async Task<IReadOnlyCollection<RestCategoryChannel>> GetCategoryChannelsAsync(RequestOptions options = null)
         {
             var channels = await GuildHelper.GetChannelsAsync(this, Discord, options).ConfigureAwait(false);
             return channels.OfType<RestCategoryChannel>().ToImmutableArray();
         }
 
+        /// <summary>
+        ///     Gets the AFK voice channel in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the voice channel that the
+        ///     AFK users will be moved to after they have idled for too long; <c>null</c> if none is set.
+        /// </returns>
         public async Task<RestVoiceChannel> GetAFKChannelAsync(RequestOptions options = null)
         {
             var afkId = AFKChannelId;
@@ -196,6 +341,15 @@ namespace Discord.Rest
             }
             return null;
         }
+
+        /// <summary>
+        ///     Gets the first viewable text channel in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the first viewable text
+        ///     channel in this guild; <c>null</c> if none is found.
+        /// </returns>
         public async Task<RestTextChannel> GetDefaultChannelAsync(RequestOptions options = null)
         {
             var channels = await GetTextChannelsAsync(options).ConfigureAwait(false);
@@ -205,6 +359,15 @@ namespace Discord.Rest
                 .OrderBy(c => c.Position)
                 .FirstOrDefault();
         }
+
+        /// <summary>
+        ///     Gets the embed channel (i.e. the channel set in the guild's widget settings) in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the embed channel set
+        ///     within the server's widget settings; <c>null</c> if none is set.
+        /// </returns>
         public async Task<RestGuildChannel> GetEmbedChannelAsync(RequestOptions options = null)
         {
             var embedId = EmbedChannelId;
@@ -212,6 +375,15 @@ namespace Discord.Rest
                 return await GuildHelper.GetChannelAsync(this, Discord, embedId.Value, options).ConfigureAwait(false);
             return null;
         }
+
+        /// <summary>
+        ///     Gets the first viewable text channel in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the first viewable text
+        ///     channel in this guild; <c>null</c> if none is found.
+        /// </returns>
         public async Task<RestTextChannel> GetSystemChannelAsync(RequestOptions options = null)
         {
             var systemId = SystemChannelId;
@@ -222,10 +394,52 @@ namespace Discord.Rest
             }
             return null;
         }
+        /// <summary>
+        ///     Creates a new text channel in this guild.
+        /// </summary>
+        /// <example>
+        ///     The following example creates a new text channel under an existing category named <c>Wumpus</c> with a set topic.
+        ///     <code lang="cs">
+        ///     var categories = await guild.GetCategoriesAsync();
+        ///     var targetCategory = categories.FirstOrDefault(x => x.Name == "wumpus");
+        ///     if (targetCategory == null) return;
+        ///     await Context.Guild.CreateTextChannelAsync(name, x =>
+        ///     {
+        ///         x.CategoryId = targetCategory.Id;
+        ///         x.Topic = $"This channel was created at {DateTimeOffset.UtcNow} by {user}.";
+        ///     });
+        ///     </code>
+        /// </example>
+        /// <param name="name">The new name for the text channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     text channel.
+        /// </returns>
         public Task<RestTextChannel> CreateTextChannelAsync(string name, Action<TextChannelProperties> func = null, RequestOptions options = null)
             => GuildHelper.CreateTextChannelAsync(this, Discord, name, options, func);
+        /// <summary>
+        ///     Creates a voice channel with the provided name.
+        /// </summary>
+        /// <param name="name">The name of the new channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name" /> is <c>null</c>.</exception>
+        /// <returns>
+        ///     The created voice channel.
+        /// </returns>
         public Task<RestVoiceChannel> CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func = null, RequestOptions options = null)
             => GuildHelper.CreateVoiceChannelAsync(this, Discord, name, options, func);
+        /// <summary>
+        ///     Creates a category channel with the provided name.
+        /// </summary>
+        /// <param name="name">The name of the new channel.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name" /> is <c>null</c>.</exception>
+        /// <returns>
+        ///     The created category channel.
+        /// </returns>
         public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, RequestOptions options = null)
             => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options);
 
@@ -236,6 +450,14 @@ namespace Discord.Rest
             => GuildHelper.CreateIntegrationAsync(this, Discord, id, type, options);
 
         //Invites
+        /// <summary>
+        ///     Gets a collection of all invites in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     invite metadata, each representing information for an invite found within this guild.
+        /// </returns>
         public Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
             => GuildHelper.GetInvitesAsync(this, Discord, options);
         /// <summary>
@@ -249,6 +471,13 @@ namespace Discord.Rest
             => GuildHelper.GetVanityInviteAsync(this, Discord, options);
 
         //Roles
+        /// <summary>
+        ///     Gets a role in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the role.</param>
+        /// <returns>
+        ///     A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public RestRole GetRole(ulong id)
         {
             if (_roles.TryGetValue(id, out RestRole value))
@@ -256,6 +485,18 @@ namespace Discord.Rest
             return null;
         }
 
+        /// <summary>
+        ///     Creates a new role with the provided name.
+        /// </summary>
+        /// <param name="name">The new name for the role.</param>
+        /// <param name="permissions">The guild permission that the role should possess.</param>
+        /// <param name="color">The color of the role.</param>
+        /// <param name="isHoisted">Whether the role is separated from others on the sidebar.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     role.
+        /// </returns>
         public async Task<RestRole> CreateRoleAsync(string name, GuildPermissions? permissions = default(GuildPermissions?), Color? color = default(Color?),
             bool isHoisted = false, RequestOptions options = null)
         {
@@ -265,47 +506,151 @@ namespace Discord.Rest
         }
 
         //Users
+        /// <summary>
+        ///     Gets a collection of all users in this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method retrieves all users found within this guild.
+        /// </remarks>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a collection of guild
+        ///     users found within this guild.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<RestGuildUser>> GetUsersAsync(RequestOptions options = null)
             => GuildHelper.GetUsersAsync(this, Discord, null, null, options);
+
+        /// <summary>
+        ///     Gets a user from this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method retrieves a user found within this guild.
+        /// </remarks>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the guild user
+        ///     associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public Task<RestGuildUser> GetUserAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetUserAsync(this, Discord, id, options);
+
+        /// <summary>
+        ///     Gets the current user for this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the currently logged-in
+        ///     user within this guild.
+        /// </returns>
         public Task<RestGuildUser> GetCurrentUserAsync(RequestOptions options = null)
             => GuildHelper.GetUserAsync(this, Discord, Discord.CurrentUser.Id, options);
+
+        /// <summary>
+        ///     Gets the owner of this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the owner of this guild.
+        /// </returns>
         public Task<RestGuildUser> GetOwnerAsync(RequestOptions options = null)
             => GuildHelper.GetUserAsync(this, Discord, OwnerId, options);
 
+        /// <inheritdoc />
+        /// <summary>
+        ///     Prunes inactive users.
+        /// </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This method removes all users that have not logged on in the provided number of <paramref name="days"/>.
+        ///     </para>
+        ///     <para>
+        ///         If <paramref name="simulate" /> is <c>true</c>, this method will only return the number of users that
+        ///         would be removed without kicking the users.
+        ///     </para>
+        /// </remarks>
+        /// <param name="days">The number of days required for the users to be kicked.</param>
+        /// <param name="simulate">Whether this prune action is a simulation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous prune operation. The task result contains the number of users to
+        ///     be or has been removed from this guild.
+        /// </returns>
         public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null)
             => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options);
 
         //Audit logs
+        /// <summary>
+        ///     Gets the specified number of audit log entries for this guild.
+        /// </summary>
+        /// <param name="limit">The number of audit log entries to fetch.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of the requested audit log entries.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<RestAuditLogEntry>> GetAuditLogsAsync(int limit, RequestOptions options = null)
             => GuildHelper.GetAuditLogsAsync(this, Discord, null, limit, options);
 
         //Webhooks
+        /// <summary>
+        ///     Gets a webhook found within this guild.
+        /// </summary>
+        /// <param name="id">The identifier for the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the webhook with the
+        ///     specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetWebhookAsync(this, Discord, id, options);
+
+        /// <summary>
+        ///     Gets a collection of all webhook from this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks found within the guild.
+        /// </returns>
         public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
             => GuildHelper.GetWebhooksAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Returns the name of the guild.
+        /// </summary>
+        /// <returns>
+        ///     The name of the guild.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id})";
 
         //Emotes
+        /// <inheritdoc />
         public Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetEmoteAsync(this, Discord, id, options);
+        /// <inheritdoc />
         public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null)
             => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options);
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null)
             => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options);
+        /// <inheritdoc />
         public Task DeleteEmoteAsync(GuildEmote emote, RequestOptions options = null)
             => GuildHelper.DeleteEmoteAsync(this, Discord, emote.Id, options);
 
         //IGuild
+        /// <inheritdoc />
         bool IGuild.Available => Available;
+        /// <inheritdoc />
         IAudioClient IGuild.AudioClient => null;
+        /// <inheritdoc />
         IRole IGuild.EveryoneRole => EveryoneRole;
+        /// <inheritdoc />
         IReadOnlyCollection<IRole> IGuild.Roles => Roles;
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IBan>> IGuild.GetBansAsync(RequestOptions options)
             => await GetBansAsync(options).ConfigureAwait(false);
         /// <inheritdoc/>
@@ -315,6 +660,7 @@ namespace Discord.Rest
         async Task<IBan> IGuild.GetBanAsync(ulong userId, RequestOptions options)
             => await GetBanAsync(userId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildChannel>> IGuild.GetChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -322,6 +668,7 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IGuildChannel>();
         }
+        /// <inheritdoc />
         async Task<IGuildChannel> IGuild.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -329,6 +676,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<ITextChannel>> IGuild.GetTextChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -336,6 +684,7 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<ITextChannel>();
         }
+        /// <inheritdoc />
         async Task<ITextChannel> IGuild.GetTextChannelAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -343,6 +692,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IVoiceChannel>> IGuild.GetVoiceChannelsAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -350,6 +700,7 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IVoiceChannel>();
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<ICategoryChannel>> IGuild.GetCategoriesAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -357,6 +708,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IVoiceChannel> IGuild.GetVoiceChannelAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -364,6 +716,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IVoiceChannel> IGuild.GetAFKChannelAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -371,6 +724,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<ITextChannel> IGuild.GetDefaultChannelAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -378,6 +732,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -385,6 +740,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -392,29 +748,38 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options)
             => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IVoiceChannel> IGuild.CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
             => await CreateVoiceChannelAsync(name, func, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
             => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildIntegration>> IGuild.GetIntegrationsAsync(RequestOptions options)
             => await GetIntegrationsAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IGuildIntegration> IGuild.CreateIntegrationAsync(ulong id, string type, RequestOptions options)
             => await CreateIntegrationAsync(id, type, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IInviteMetadata>> IGuild.GetInvitesAsync(RequestOptions options)
             => await GetInvitesAsync(options).ConfigureAwait(false);
         /// <inheritdoc />
         async Task<IInviteMetadata> IGuild.GetVanityInviteAsync(RequestOptions options)
             => await GetVanityInviteAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         IRole IGuild.GetRole(ulong id)
             => GetRole(id);
+        /// <inheritdoc />
         async Task<IRole> IGuild.CreateRoleAsync(string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options)
             => await CreateRoleAsync(name, permissions, color, isHoisted, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IGuildUser> IGuild.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -422,6 +787,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IGuildUser> IGuild.GetCurrentUserAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -429,6 +795,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IGuildUser> IGuild.GetOwnerAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -436,6 +803,7 @@ namespace Discord.Rest
             else
                 return null;
         }
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildUser>> IGuild.GetUsersAsync(CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -443,7 +811,10 @@ namespace Discord.Rest
             else
                 return ImmutableArray.Create<IGuildUser>();
         }
-        Task IGuild.DownloadUsersAsync() { throw new NotSupportedException(); }
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Downloading users is not supported for a REST-based guild.</exception>
+        Task IGuild.DownloadUsersAsync() =>
+            throw new NotSupportedException();
 
         async Task<IReadOnlyCollection<IAuditLogEntry>> IGuild.GetAuditLogsAsync(int limit, CacheMode cacheMode, RequestOptions options)
         {
@@ -453,9 +824,11 @@ namespace Discord.Rest
                 return ImmutableArray.Create<IAuditLogEntry>();
         }
 
+        /// <inheritdoc />
         async Task<IWebhook> IGuild.GetWebhookAsync(ulong id, RequestOptions options)
-            => await GetWebhookAsync(id, options);
+            => await GetWebhookAsync(id, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IWebhook>> IGuild.GetWebhooksAsync(RequestOptions options)
-            => await GetWebhooksAsync(options);
+            => await GetWebhooksAsync(options).ConfigureAwait(false);
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
index f26a62d8d..00f3fae69 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.GuildEmbed;
 
 namespace Discord
@@ -19,7 +19,7 @@ namespace Discord
             return new RestGuildEmbed(model.Enabled, model.ChannelId);
         }
 
-        public override string ToString() => ChannelId?.ToString();
+        public override string ToString() => ChannelId?.ToString() ?? "Unknown";
         private string DebuggerDisplay => $"{ChannelId} ({(IsEnabled ? "Enabled" : "Disabled")})";
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuildIntegration.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuildIntegration.cs
index eadda53f2..9759e64d2 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuildIntegration.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuildIntegration.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.Integration;
@@ -10,18 +10,28 @@ namespace Discord.Rest
     {
         private long _syncedAtTicks;
 
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public string Type { get; private set; }
+        /// <inheritdoc />
         public bool IsEnabled { get; private set; }
+        /// <inheritdoc />
         public bool IsSyncing { get; private set; }
+        /// <inheritdoc />
         public ulong ExpireBehavior { get; private set; }
+        /// <inheritdoc />
         public ulong ExpireGracePeriod { get; private set; }
+        /// <inheritdoc />
         public ulong GuildId { get; private set; }
+        /// <inheritdoc />
         public ulong RoleId { get; private set; }
         public RestUser User { get; private set; }
+        /// <inheritdoc />
         public IntegrationAccount Account { get; private set; }
         internal IGuild Guild { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset SyncedAt => DateTimeUtils.FromTicks(_syncedAtTicks);
 
         internal RestGuildIntegration(BaseDiscordClient discord, IGuild guild, ulong id)
@@ -78,6 +88,7 @@ namespace Discord.Rest
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id}{(IsEnabled ? ", Enabled" : "")})";
 
+        /// <inheritdoc />
         IGuild IGuildIntegration.Guild
         {
             get
@@ -87,6 +98,7 @@ namespace Discord.Rest
                 throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
             }
         }
+        /// <inheritdoc />
         IUser IGuildIntegration.User => User;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
index de5a5f7d9..b75d6288e 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestUserGuild.cs
@@ -9,12 +9,17 @@ namespace Discord.Rest
     public class RestUserGuild : RestEntity<ulong>, IUserGuild
     {
         private string _iconId;
-                
+
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public bool IsOwner { get; private set; }
+        /// <inheritdoc />
         public GuildPermissions Permissions { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public string IconUrl => CDN.GetGuildIconUrl(Id, _iconId);
 
         internal RestUserGuild(BaseDiscordClient discord, ulong id)
@@ -40,6 +45,7 @@ namespace Discord.Rest
         {
             await Discord.ApiClient.LeaveGuildAsync(Id, options).ConfigureAwait(false);
         }
+        /// <inheritdoc />
         public async Task DeleteAsync(RequestOptions options = null)
         {
             await Discord.ApiClient.DeleteGuildAsync(Id, options).ConfigureAwait(false);
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs b/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
index 4e0c3c1ee..7a03b68d4 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
@@ -4,6 +4,9 @@ using Model = Discord.API.VoiceRegion;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a REST-based voice region.
+    /// </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public class RestVoiceRegion : RestEntity<string>, IVoiceRegion
     {
diff --git a/src/Discord.Net.Rest/Entities/Invites/RestInvite.cs b/src/Discord.Net.Rest/Entities/Invites/RestInvite.cs
index 050f117fb..153eb6c41 100644
--- a/src/Discord.Net.Rest/Entities/Invites/RestInvite.cs
+++ b/src/Discord.Net.Rest/Entities/Invites/RestInvite.cs
@@ -9,16 +9,24 @@ namespace Discord.Rest
     public class RestInvite : RestEntity<string>, IInvite, IUpdateable
     {
         public ChannelType ChannelType { get; private set; }
+        /// <inheritdoc />
         public string ChannelName { get; private set; }
+        /// <inheritdoc />
         public string GuildName { get; private set; }
+        /// <inheritdoc />
         public int? PresenceCount { get; private set; }
+        /// <inheritdoc />
         public int? MemberCount { get; private set; }
+        /// <inheritdoc />
         public ulong ChannelId { get; private set; }
+        /// <inheritdoc />
         public ulong? GuildId { get; private set; }
         internal IChannel Channel { get; }
         internal IGuild Guild { get; }
 
+        /// <inheritdoc />
         public string Code => Id;
+        /// <inheritdoc />
         public string Url => $"{DiscordConfig.InviteUrl}{Code}";
 
         internal RestInvite(BaseDiscordClient discord, IGuild guild, IChannel channel, string id)
@@ -43,18 +51,27 @@ namespace Discord.Rest
             PresenceCount = model.PresenceCount.IsSpecified ? model.PresenceCount.Value : null;
             ChannelType = (ChannelType)model.Channel.Type;
         }
-        
+
+        /// <inheritdoc />
         public async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetInviteAsync(Code, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => InviteHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the URL of the invite.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to the Url of the invite.
+        /// </returns>
         public override string ToString() => Url;
         private string DebuggerDisplay => $"{Url} ({GuildName} / {ChannelName})";
-        
+
+        /// <inheritdoc />
         IGuild IInvite.Guild
         {
             get
@@ -66,6 +83,7 @@ namespace Discord.Rest
                 throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
             }
         }
+        /// <inheritdoc />
         IChannel IInvite.Channel
         {
             get
diff --git a/src/Discord.Net.Rest/Entities/Invites/RestInviteMetadata.cs b/src/Discord.Net.Rest/Entities/Invites/RestInviteMetadata.cs
index c7236be58..55acd5f45 100644
--- a/src/Discord.Net.Rest/Entities/Invites/RestInviteMetadata.cs
+++ b/src/Discord.Net.Rest/Entities/Invites/RestInviteMetadata.cs
@@ -3,17 +3,27 @@ using Model = Discord.API.InviteMetadata;
 
 namespace Discord.Rest
 {
+    /// <summary> Represents additional information regarding the REST-based invite object. </summary>
     public class RestInviteMetadata : RestInvite, IInviteMetadata
     {
         private long? _createdAtTicks;
 
+        /// <inheritdoc />
         public bool IsRevoked { get; private set; }
+        /// <inheritdoc />
         public bool IsTemporary { get; private set; }
+        /// <inheritdoc />
         public int? MaxAge { get; private set; }
+        /// <inheritdoc />
         public int? MaxUses { get; private set; }
+        /// <inheritdoc />
         public int? Uses { get; private set; }
+        /// <summary>
+        ///     Gets the user that created this invite.
+        /// </summary>
         public RestUser Inviter { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset? CreatedAt => DateTimeUtils.FromTicks(_createdAtTicks);
 
         internal RestInviteMetadata(BaseDiscordClient discord, IGuild guild, IChannel channel, string id)
@@ -38,6 +48,7 @@ namespace Discord.Rest
             _createdAtTicks = model.CreatedAt.IsSpecified ? model.CreatedAt.Value.UtcTicks : (long?)null;
         }
 
+        /// <inheritdoc />
         IUser IInviteMetadata.Inviter => Inviter;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Messages/Attachment.cs b/src/Discord.Net.Rest/Entities/Messages/Attachment.cs
index e185234ac..a2c7b9cf7 100644
--- a/src/Discord.Net.Rest/Entities/Messages/Attachment.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/Attachment.cs
@@ -1,17 +1,27 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.Attachment;
 
 namespace Discord
 {
+    /// <summary>
+    ///     An attachment file seen in a <see cref="IUserMessage"/>.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class Attachment : IAttachment
     {
+        /// <inheritdoc />
         public ulong Id { get; }
+        /// <inheritdoc />
         public string Filename { get; }
+        /// <inheritdoc />
         public string Url { get; }
+        /// <inheritdoc />
         public string ProxyUrl { get; }
+        /// <inheritdoc />
         public int Size { get; }
+        /// <inheritdoc />
         public int? Height { get; }
+        /// <inheritdoc />
         public int? Width { get; }
 
         internal Attachment(ulong id, string filename, string url, string proxyUrl, int size, int? height, int? width)
@@ -31,6 +41,12 @@ namespace Discord
                 model.Width.IsSpecified ? model.Width.Value : (int?)null);
         }
 
+        /// <summary>
+        ///     Returns the filename of this attachment.
+        /// </summary>
+        /// <returns>
+        ///     A string containing the filename of this attachment.
+        /// </returns>
         public override string ToString() => Filename;
         private string DebuggerDisplay => $"{Filename} ({Size} bytes)";
     }
diff --git a/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs b/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
index 30ee75c47..b963fd532 100644
--- a/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/MessageHelper.cs
@@ -10,11 +10,13 @@ namespace Discord.Rest
 {
     internal static class MessageHelper
     {
+        /// <exception cref="InvalidOperationException">Only the author of a message may modify the message.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public static async Task<Model> ModifyAsync(IMessage msg, BaseDiscordClient client, Action<MessageProperties> func,
             RequestOptions options)
         {
             if (msg.Author.Id != client.CurrentUser.Id)
-                throw new InvalidOperationException("Only the author of a message may change it.");
+                throw new InvalidOperationException("Only the author of a message may modify the message.");
 
             var args = new MessageProperties();
             func(args);
@@ -45,7 +47,7 @@ namespace Discord.Rest
 
         public static async Task RemoveAllReactionsAsync(IMessage msg, BaseDiscordClient client, RequestOptions options)
         {
-            await client.ApiClient.RemoveAllReactionsAsync(msg.Channel.Id, msg.Id, options);
+            await client.ApiClient.RemoveAllReactionsAsync(msg.Channel.Id, msg.Id, options).ConfigureAwait(false);
         }
 
         public static IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IMessage msg, IEmote emote,
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs b/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
index 590886886..a4ecf3647 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
@@ -7,27 +7,53 @@ using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based message.
+    /// </summary>
     public abstract class RestMessage : RestEntity<ulong>, IMessage, IUpdateable
     {
         private long _timestampTicks;
 
+        /// <inheritdoc />
         public IMessageChannel Channel { get; }
+        /// <summary>
+        ///     Gets the Author of the message.
+        /// </summary>
         public IUser Author { get; }
+        /// <inheritdoc />
         public MessageSource Source { get; }
 
+        /// <inheritdoc />
         public string Content { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public virtual bool IsTTS => false;
+        /// <inheritdoc />
         public virtual bool IsPinned => false;
+        /// <inheritdoc />
         public virtual DateTimeOffset? EditedTimestamp => null;
+        /// <summary>
+        ///     Gets a collection of the <see cref="Attachment"/>'s on the message.
+        /// </summary>
         public virtual IReadOnlyCollection<Attachment> Attachments => ImmutableArray.Create<Attachment>();
+        /// <summary>
+        ///     Gets a collection of the <see cref="Embed"/>'s on the message.
+        /// </summary>
         public virtual IReadOnlyCollection<Embed> Embeds => ImmutableArray.Create<Embed>();
+        /// <inheritdoc />
         public virtual IReadOnlyCollection<ulong> MentionedChannelIds => ImmutableArray.Create<ulong>();
+        /// <inheritdoc />
         public virtual IReadOnlyCollection<ulong> MentionedRoleIds => ImmutableArray.Create<ulong>();
+        /// <summary>
+        ///     Gets a collection of the mentioned users in the message.
+        /// </summary>
         public virtual IReadOnlyCollection<RestUser> MentionedUsers => ImmutableArray.Create<RestUser>();
+        /// <inheritdoc />
         public virtual IReadOnlyCollection<ITag> Tags => ImmutableArray.Create<ITag>();
 
+        /// <inheritdoc />
         public DateTimeOffset Timestamp => DateTimeUtils.FromTicks(_timestampTicks);
 
         internal RestMessage(BaseDiscordClient discord, ulong id, IMessageChannel channel, IUser author, MessageSource source)
@@ -53,20 +79,32 @@ namespace Discord.Rest
                 Content = model.Content.Value;
         }
 
+        /// <inheritdoc />
         public async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetChannelMessageAsync(Channel.Id, Id, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => MessageHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the <see cref="Content"/> of the message.
+        /// </summary>
+        /// <returns>
+        ///     A string that is the <see cref="Content"/> of the message.
+        /// </returns>
         public override string ToString() => Content;
 
+        /// <inheritdoc />
         MessageType IMessage.Type => MessageType.Default;
         IUser IMessage.Author => Author;
+        /// <inheritdoc />
         IReadOnlyCollection<IAttachment> IMessage.Attachments => Attachments;
+        /// <inheritdoc />
         IReadOnlyCollection<IEmbed> IMessage.Embeds => Embeds;
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IMessage.MentionedUserIds => MentionedUsers.Select(x => x.Id).ToImmutableArray();
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestReaction.cs b/src/Discord.Net.Rest/Entities/Messages/RestReaction.cs
index 6d3f72419..c38efe32d 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestReaction.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestReaction.cs
@@ -1,11 +1,21 @@
-using Model = Discord.API.Reaction;
+using Model = Discord.API.Reaction;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST reaction object.
+    /// </summary>
     public class RestReaction : IReaction
     {
+        /// <inheritdoc />
         public IEmote Emote { get; }
+        /// <summary>
+        ///     Gets the number of reactions added.
+        /// </summary>
         public int Count { get; }
+        /// <summary>
+        ///     Gets whether the reactions is added by the user.
+        /// </summary>
         public bool Me { get; }
 
         internal RestReaction(IEmote emote, int count, bool me)
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestSystemMessage.cs b/src/Discord.Net.Rest/Entities/Messages/RestSystemMessage.cs
index b9dda08ae..89a651eb7 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestSystemMessage.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestSystemMessage.cs
@@ -1,11 +1,15 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based system message.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestSystemMessage : RestMessage, ISystemMessage
     {
+        /// <inheritdoc />
         public MessageType Type { get; private set; }
 
         internal RestSystemMessage(BaseDiscordClient discord, ulong id, IMessageChannel channel, IUser author)
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs b/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
index 7354cc4af..5ec908fde 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
@@ -8,6 +8,9 @@ using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based message sent by a user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestUserMessage : RestMessage, IUserMessage
     {
@@ -17,23 +20,33 @@ namespace Discord.Rest
         private ImmutableArray<Embed> _embeds;
         private ImmutableArray<ITag> _tags;
         private ImmutableArray<RestReaction> _reactions;
-        
+
+        /// <inheritdoc />
         public override bool IsTTS => _isTTS;
+        /// <inheritdoc />
         public override bool IsPinned => _isPinned;
+        /// <inheritdoc />
         public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks);
+        /// <inheritdoc />
         public override IReadOnlyCollection<Attachment> Attachments => _attachments;
+        /// <inheritdoc />
         public override IReadOnlyCollection<Embed> Embeds => _embeds;
+        /// <inheritdoc />
         public override IReadOnlyCollection<ulong> MentionedChannelIds => MessageHelper.FilterTagsByKey(TagType.ChannelMention, _tags);
+        /// <inheritdoc />
         public override IReadOnlyCollection<ulong> MentionedRoleIds => MessageHelper.FilterTagsByKey(TagType.RoleMention, _tags);
+        /// <inheritdoc />
         public override IReadOnlyCollection<RestUser> MentionedUsers => MessageHelper.FilterTagsByValue<RestUser>(TagType.UserMention, _tags);
+        /// <inheritdoc />
         public override IReadOnlyCollection<ITag> Tags => _tags;
+        /// <inheritdoc />
         public IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions => _reactions.ToDictionary(x => x.Emote, x => new ReactionMetadata { ReactionCount = x.Count, IsMe = x.Me });
 
         internal RestUserMessage(BaseDiscordClient discord, ulong id, IMessageChannel channel, IUser author, MessageSource source)
             : base(discord, id, channel, author, source)
         {
         }
-        internal static new RestUserMessage Create(BaseDiscordClient discord, IMessageChannel channel, IUser author, Model model)
+        internal new static RestUserMessage Create(BaseDiscordClient discord, IMessageChannel channel, IUser author, Model model)
         {
             var entity = new RestUserMessage(discord, model.Id, channel, author, MessageHelper.GetSource(model));
             entity.Update(model);
@@ -124,30 +137,37 @@ namespace Discord.Rest
             }
         }
 
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<MessageProperties> func, RequestOptions options = null)
         {
             var model = await MessageHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
 
+        /// <inheritdoc />
         public Task AddReactionAsync(IEmote emote, RequestOptions options = null)
             => MessageHelper.AddReactionAsync(this, emote, Discord, options);
+        /// <inheritdoc />
         public Task RemoveReactionAsync(IEmote emote, IUser user, RequestOptions options = null)
             => MessageHelper.RemoveReactionAsync(this, user, emote, Discord, options);
+        /// <inheritdoc />
         public Task RemoveAllReactionsAsync(RequestOptions options = null)
             => MessageHelper.RemoveAllReactionsAsync(this, Discord, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IEmote emote, int limit, RequestOptions options = null)
             => MessageHelper.GetReactionUsersAsync(this, emote, limit, Discord, options);
 
-
+        /// <inheritdoc />
         public Task PinAsync(RequestOptions options = null)
             => MessageHelper.PinAsync(this, Discord, options);
+        /// <inheritdoc />
         public Task UnpinAsync(RequestOptions options = null)
             => MessageHelper.UnpinAsync(this, Discord, options);
 
         public string Resolve(int startIndex, TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name,
             TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name)
             => MentionUtils.Resolve(this, startIndex, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
+        /// <inheritdoc />
         public string Resolve(TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name,
             TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name)
             => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
diff --git a/src/Discord.Net.Rest/Entities/RestApplication.cs b/src/Discord.Net.Rest/Entities/RestApplication.cs
index 827c33cf7..d033978d0 100644
--- a/src/Discord.Net.Rest/Entities/RestApplication.cs
+++ b/src/Discord.Net.Rest/Entities/RestApplication.cs
@@ -1,23 +1,33 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.Application;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based entity that contains information about a Discord application created via the developer portal.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestApplication : RestEntity<ulong>, IApplication
     {
         protected string _iconId;
-        
+
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public string Description { get; private set; }
+        /// <inheritdoc />
         public string[] RPCOrigins { get; private set; }
+        /// <inheritdoc />
         public ulong Flags { get; private set; }
 
+        /// <inheritdoc />
         public IUser Owner { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public string IconUrl => CDN.GetApplicationIconUrl(Id, _iconId);
 
         internal RestApplication(BaseDiscordClient discord, ulong id)
@@ -43,6 +53,7 @@ namespace Discord.Rest
                 Owner = RestUser.Create(Discord, model.Owner.Value);
         }
 
+        /// <exception cref="InvalidOperationException">Unable to update this object from a different application token.</exception>
         public async Task UpdateAsync()
         {
             var response = await Discord.ApiClient.GetMyApplicationAsync().ConfigureAwait(false);
@@ -51,6 +62,12 @@ namespace Discord.Rest
             Update(response);
         }
 
+        /// <summary>
+        ///     Gets the name of the application.
+        /// </summary>
+        /// <returns>
+        ///     Name of the application.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id})";
     }
diff --git a/src/Discord.Net.Rest/Entities/Roles/RestRole.cs b/src/Discord.Net.Rest/Entities/Roles/RestRole.cs
index 486f41b9e..7c1a3aaa2 100644
--- a/src/Discord.Net.Rest/Entities/Roles/RestRole.cs
+++ b/src/Discord.Net.Rest/Entities/Roles/RestRole.cs
@@ -1,24 +1,39 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.Role;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based role.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestRole : RestEntity<ulong>, IRole
     {
         internal IGuild Guild { get; }
+        /// <inheritdoc />
         public Color Color { get; private set; }
+        /// <inheritdoc />
         public bool IsHoisted { get; private set; }
+        /// <inheritdoc />
         public bool IsManaged { get; private set; }
+        /// <inheritdoc />
         public bool IsMentionable { get; private set; }
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public GuildPermissions Permissions { get; private set; }
+        /// <inheritdoc />
         public int Position { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <summary>
+        ///     Gets if this role is the @everyone role of the guild or not.
+        /// </summary>
         public bool IsEveryone => Id == Guild.Id;
+        /// <inheritdoc />
         public string Mention => IsEveryone ? "@everyone" : MentionUtils.MentionRole(Id);
 
         internal RestRole(BaseDiscordClient discord, IGuild guild, ulong id)
@@ -43,20 +58,30 @@ namespace Discord.Rest
             Permissions = new GuildPermissions(model.Permissions);
         }
 
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<RoleProperties> func, RequestOptions options = null)
         { 
             var model = await RoleHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => RoleHelper.DeleteAsync(this, Discord, options);
 
+        /// <inheritdoc />
         public int CompareTo(IRole role) => RoleUtils.Compare(this, role);
 
+        /// <summary>
+        ///     Gets the name of the role.
+        /// </summary>
+        /// <returns>
+        ///     A string that is the name of the role.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id})";
 
         //IRole
+        /// <inheritdoc />
         IGuild IRole.Guild
         {
             get
diff --git a/src/Discord.Net.Rest/Entities/Users/RestConnection.cs b/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
index b8b83be3e..0c91493d2 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
 using Model = Discord.API.Connection;
@@ -8,10 +8,15 @@ namespace Discord
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestConnection : IConnection
     {
+        /// <inheritdoc />
         public string Id { get; }
+        /// <inheritdoc />
         public string Type { get; }
+        /// <inheritdoc />
         public string Name { get; }
+        /// <inheritdoc />
         public bool IsRevoked { get; }
+        /// <inheritdoc />
         public IReadOnlyCollection<ulong> IntegrationIds { get; }
 
         internal RestConnection(string id, string type, string name, bool isRevoked, IReadOnlyCollection<ulong> integrationIds)
@@ -28,6 +33,12 @@ namespace Discord
             return new RestConnection(model.Id, model.Type, model.Name, model.Revoked, model.Integrations.ToImmutableArray());
         }
 
+        /// <summary>
+        ///     Gets the name of the connection.
+        /// </summary>
+        /// <returns>
+        ///     Name of the connection.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id}, {Type}{(IsRevoked ? ", Revoked" : "")})";
     }
diff --git a/src/Discord.Net.Rest/Entities/Users/RestGroupUser.cs b/src/Discord.Net.Rest/Entities/Users/RestGroupUser.cs
index 951bd2e7c..fbd76f609 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestGroupUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestGroupUser.cs
@@ -1,8 +1,11 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based group user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGroupUser : RestUser, IGroupUser
     {
@@ -16,14 +19,21 @@ namespace Discord.Rest
             entity.Update(model);
             return entity;
         }
-        
+
         //IVoiceState
+        /// <inheritdoc />
         bool IVoiceState.IsDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSuppressed => false;
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => null;
+        /// <inheritdoc />
         string IVoiceState.VoiceSessionId => null;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs b/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
index 3c47587cb..e59d92407 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs
@@ -8,18 +8,28 @@ using Model = Discord.API.GuildMember;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based guild user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGuildUser : RestUser, IGuildUser
     {
         private long? _joinedAtTicks;
         private ImmutableArray<ulong> _roleIds;
 
+        /// <inheritdoc />
         public string Nickname { get; private set; }
         internal IGuild Guild { get; private set; }
+        /// <inheritdoc />
         public bool IsDeafened { get; private set; }
+        /// <inheritdoc />
         public bool IsMuted { get; private set; }
 
+        /// <inheritdoc />
         public ulong GuildId => Guild.Id;
+
+        /// <inheritdoc />
+        /// <exception cref="InvalidOperationException" accessor="get">Resolving permissions requires the parent guild to be downloaded.</exception>
         public GuildPermissions GuildPermissions
         {
             get
@@ -29,8 +39,10 @@ namespace Discord.Rest
                 return new GuildPermissions(Permissions.ResolveGuild(Guild, this));
             }
         }
+        /// <inheritdoc />
         public IReadOnlyCollection<ulong> RoleIds => _roleIds;
 
+        /// <inheritdoc />
         public DateTimeOffset? JoinedAt => DateTimeUtils.FromTicks(_joinedAtTicks);
 
         internal RestGuildUser(BaseDiscordClient discord, IGuild guild, ulong id)
@@ -67,11 +79,13 @@ namespace Discord.Rest
             _roleIds = roles.ToImmutable();
         }
 
+        /// <inheritdoc />
         public override async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetGuildMemberAsync(GuildId, Id, options).ConfigureAwait(false);
             Update(model);
         }
+        /// <inheritdoc />
         public async Task ModifyAsync(Action<GuildUserProperties> func, RequestOptions options = null)
         {
             var args = await UserHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
@@ -86,6 +100,7 @@ namespace Discord.Rest
             else if (args.RoleIds.IsSpecified)
                 UpdateRoles(args.RoleIds.Value.ToArray());
         }
+        /// <inheritdoc />
         public Task KickAsync(string reason = null, RequestOptions options = null)
             => UserHelper.KickAsync(this, Discord, reason, options);
         /// <inheritdoc />
@@ -101,6 +116,8 @@ namespace Discord.Rest
         public Task RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null)
             => UserHelper.RemoveRolesAsync(this, Discord, roles, options);
 
+        /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">Resolving permissions requires the parent guild to be downloaded.</exception>
         public ChannelPermissions GetPermissions(IGuildChannel channel)
         {
             var guildPerms = GuildPermissions;
@@ -108,6 +125,7 @@ namespace Discord.Rest
         }
 
         //IGuildUser
+        /// <inheritdoc />
         IGuild IGuildUser.Guild
         {
             get
@@ -119,10 +137,15 @@ namespace Discord.Rest
         }
 
         //IVoiceState
+        /// <inheritdoc />
         bool IVoiceState.IsSelfDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSuppressed => false;
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => null;
+        /// <inheritdoc />
         string IVoiceState.VoiceSessionId => null;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Users/RestSelfUser.cs b/src/Discord.Net.Rest/Entities/Users/RestSelfUser.cs
index ab5ec4a3b..7f3a3faa8 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestSelfUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestSelfUser.cs
@@ -1,15 +1,21 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents the logged-in REST-based user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestSelfUser : RestUser, ISelfUser
     {
+        /// <inheritdoc />
         public string Email { get; private set; }
+        /// <inheritdoc />
         public bool IsVerified { get; private set; }
+        /// <inheritdoc />
         public bool IsMfaEnabled { get; private set; }
 
         internal RestSelfUser(BaseDiscordClient discord, ulong id)
@@ -22,6 +28,7 @@ namespace Discord.Rest
             entity.Update(model);
             return entity;
         }
+        /// <inheritdoc />
         internal override void Update(Model model)
         {
             base.Update(model);
@@ -34,6 +41,8 @@ namespace Discord.Rest
                 IsMfaEnabled = model.MfaEnabled.Value;
         }
 
+        /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">Unable to update this object using a different token.</exception>
         public override async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetMyUserAsync(options).ConfigureAwait(false);
@@ -42,6 +51,8 @@ namespace Discord.Rest
             Update(model);
         }
 
+        /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">Unable to modify this object using a different token.</exception>
         public async Task ModifyAsync(Action<SelfUserProperties> func, RequestOptions options = null)
         {
             if (Id != Discord.CurrentUser.Id)
diff --git a/src/Discord.Net.Rest/Entities/Users/RestUser.cs b/src/Discord.Net.Rest/Entities/Users/RestUser.cs
index c484986b1..6af5b5c95 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestUser.cs
@@ -5,19 +5,32 @@ using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestUser : RestEntity<ulong>, IUser, IUpdateable
     {
+        /// <inheritdoc />
         public bool IsBot { get; private set; }
+        /// <inheritdoc />
         public string Username { get; private set; }
+        /// <inheritdoc />
         public ushort DiscriminatorValue { get; private set; }
+        /// <inheritdoc />
         public string AvatarId { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public string Discriminator => DiscriminatorValue.ToString("D4");
+        /// <inheritdoc />
         public string Mention => MentionUtils.MentionUser(Id);
+        /// <inheritdoc />
         public virtual IActivity Activity => null;
+        /// <inheritdoc />
         public virtual UserStatus Status => UserStatus.Offline;
+        /// <inheritdoc />
         public virtual bool IsWebhook => false;
 
         internal RestUser(BaseDiscordClient discord, ulong id)
@@ -48,26 +61,43 @@ namespace Discord.Rest
                 Username = model.Username.Value;
         }
 
+        /// <inheritdoc />
         public virtual async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetUserAsync(Id, options).ConfigureAwait(false);
             Update(model);
         }
 
+        /// <summary>
+        ///     Returns a direct message channel to this user, or create one if it does not already exist.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a rest DM channel where the user is the recipient.
+        /// </returns>
         public Task<RestDMChannel> GetOrCreateDMChannelAsync(RequestOptions options = null)
             => UserHelper.CreateDMChannelAsync(this, Discord, options);
 
+        /// <inheritdoc />
         public string GetAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128)
             => CDN.GetUserAvatarUrl(Id, AvatarId, size, format);
 
+        /// <inheritdoc />
         public string GetDefaultAvatarUrl()
             => CDN.GetDefaultUserAvatarUrl(DiscriminatorValue);
 
+        /// <summary>
+        ///     Gets the Username#Discriminator of the user.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to Username#Discriminator of the user.
+        /// </returns>
         public override string ToString() => $"{Username}#{Discriminator}";
         private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")})";
 
         //IUser
+        /// <inheritdoc />
         async Task<IDMChannel> IUser.GetOrCreateDMChannelAsync(RequestOptions options)
-            => await GetOrCreateDMChannelAsync(options);
+            => await GetOrCreateDMChannelAsync(options).ConfigureAwait(false);
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Users/RestWebhookUser.cs b/src/Discord.Net.Rest/Entities/Users/RestWebhookUser.cs
index bb44f2777..bee4892fe 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestWebhookUser.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestWebhookUser.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
@@ -10,10 +10,13 @@ namespace Discord.Rest
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestWebhookUser : RestUser, IWebhookUser
     {
+        /// <inheritdoc />
         public ulong WebhookId { get; }
         internal IGuild Guild { get; }
 
+        /// <inheritdoc />
         public override bool IsWebhook => true;
+        /// <inheritdoc />
         public ulong GuildId => Guild.Id;
 
         internal RestWebhookUser(BaseDiscordClient discord, IGuild guild, ulong id, ulong webhookId)
@@ -28,8 +31,9 @@ namespace Discord.Rest
             entity.Update(model);
             return entity;
         }
-        
+
         //IGuildUser
+        /// <inheritdoc />
         IGuild IGuildUser.Guild
         {
             get
@@ -39,45 +43,55 @@ namespace Discord.Rest
                 throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
             }
         }
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IGuildUser.RoleIds => ImmutableArray.Create<ulong>();
+        /// <inheritdoc />
         DateTimeOffset? IGuildUser.JoinedAt => null;
+        /// <inheritdoc />
         string IGuildUser.Nickname => null;
+        /// <inheritdoc />
         GuildPermissions IGuildUser.GuildPermissions => GuildPermissions.Webhook;
 
+        /// <inheritdoc />
         ChannelPermissions IGuildUser.GetPermissions(IGuildChannel channel) => Permissions.ToChannelPerms(channel, GuildPermissions.Webhook.RawValue);
-        Task IGuildUser.KickAsync(string reason, RequestOptions options)
-        {
+        /// <inheritdoc />
+        Task IGuildUser.KickAsync(string reason, RequestOptions options) => 
             throw new NotSupportedException("Webhook users cannot be kicked.");
-        }
-        Task IGuildUser.ModifyAsync(Action<GuildUserProperties> func, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        Task IGuildUser.ModifyAsync(Action<GuildUserProperties> func, RequestOptions options) => 
             throw new NotSupportedException("Webhook users cannot be modified.");
-        }
 
-        Task IGuildUser.AddRoleAsync(IRole role, RequestOptions options)
-        {
+        /// <inheritdoc />
+        Task IGuildUser.AddRoleAsync(IRole role, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        Task IGuildUser.AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.RemoveRoleAsync(IRole role, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        Task IGuildUser.RemoveRoleAsync(IRole role, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        Task IGuildUser.RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
 
         //IVoiceState
+        /// <inheritdoc />
         bool IVoiceState.IsDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSuppressed => false;
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => null;
+        /// <inheritdoc />
         string IVoiceState.VoiceSessionId => null;
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Users/UserHelper.cs b/src/Discord.Net.Rest/Entities/Users/UserHelper.cs
index dfb81ff2c..3e7493ab5 100644
--- a/src/Discord.Net.Rest/Entities/Users/UserHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Users/UserHelper.cs
@@ -76,13 +76,13 @@ namespace Discord.Rest
         public static async Task AddRolesAsync(IGuildUser user, BaseDiscordClient client, IEnumerable<IRole> roles, RequestOptions options)
         {
             foreach (var role in roles)
-                await client.ApiClient.AddRoleAsync(user.Guild.Id, user.Id, role.Id, options);
+                await client.ApiClient.AddRoleAsync(user.Guild.Id, user.Id, role.Id, options).ConfigureAwait(false);
         }
 
         public static async Task RemoveRolesAsync(IGuildUser user, BaseDiscordClient client, IEnumerable<IRole> roles, RequestOptions options)
         {
             foreach (var role in roles)
-                await client.ApiClient.RemoveRoleAsync(user.Guild.Id, user.Id, role.Id, options);
+                await client.ApiClient.RemoveRoleAsync(user.Guild.Id, user.Id, role.Id, options).ConfigureAwait(false);
         }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Webhooks/RestWebhook.cs b/src/Discord.Net.Rest/Entities/Webhooks/RestWebhook.cs
index 47cc50a9c..1fdc95a63 100644
--- a/src/Discord.Net.Rest/Entities/Webhooks/RestWebhook.cs
+++ b/src/Discord.Net.Rest/Entities/Webhooks/RestWebhook.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.Webhook;
@@ -11,14 +11,21 @@ namespace Discord.Rest
         internal IGuild Guild { get; private set; }
         internal ITextChannel Channel { get; private set; }
 
+        /// <inheritdoc />
         public ulong ChannelId { get; }
+        /// <inheritdoc />
         public string Token { get; }
 
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public string AvatarId { get; private set; }
+        /// <inheritdoc />
         public ulong? GuildId { get; private set; }
+        /// <inheritdoc />
         public IUser Creator { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
 
         internal RestWebhook(BaseDiscordClient discord, IGuild guild, ulong id, string token, ulong channelId)
@@ -59,12 +66,14 @@ namespace Discord.Rest
                 Name = model.Name.Value;
         }
 
+        /// <inheritdoc />
         public async Task UpdateAsync(RequestOptions options = null)
         {
             var model = await Discord.ApiClient.GetWebhookAsync(Id, options).ConfigureAwait(false);
             Update(model);
         }
 
+        /// <inheritdoc />
         public string GetAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128)
            => CDN.GetUserAvatarUrl(Id, AvatarId, size, format);
 
@@ -74,6 +83,7 @@ namespace Discord.Rest
             Update(model);
         }
 
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => WebhookHelper.DeleteAsync(this, Discord, options);
 
@@ -81,10 +91,13 @@ namespace Discord.Rest
         private string DebuggerDisplay => $"Webhook: {Name} ({Id})";
 
         //IWebhook
+        /// <inheritdoc />
         IGuild IWebhook.Guild 
             => Guild ?? throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
+        /// <inheritdoc />
         ITextChannel IWebhook.Channel 
             => Channel ?? throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
+        /// <inheritdoc />
         Task IWebhook.ModifyAsync(Action<WebhookProperties> func, RequestOptions options)
             => ModifyAsync(func, options);
     }
diff --git a/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs b/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
index a5a440d8b..9bbcfb8a3 100644
--- a/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
+++ b/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.IO;
 using Newtonsoft.Json;
 using Model = Discord.API.Image;
@@ -13,6 +13,7 @@ namespace Discord.Net.Converters
         public override bool CanRead => true;
         public override bool CanWrite => true;
 
+        /// <exception cref="InvalidOperationException">Cannot read from image.</exception>
         public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
         {
             throw new InvalidOperationException();
diff --git a/src/Discord.Net.Rest/Net/Converters/PermissionTargetConverter.cs b/src/Discord.Net.Rest/Net/Converters/PermissionTargetConverter.cs
index 0ed566a84..de2e379d7 100644
--- a/src/Discord.Net.Rest/Net/Converters/PermissionTargetConverter.cs
+++ b/src/Discord.Net.Rest/Net/Converters/PermissionTargetConverter.cs
@@ -1,4 +1,4 @@
-using Newtonsoft.Json;
+using Newtonsoft.Json;
 using System;
 
 namespace Discord.Net.Converters
@@ -11,6 +11,7 @@ namespace Discord.Net.Converters
         public override bool CanRead => true;
         public override bool CanWrite => true;
 
+        /// <exception cref="JsonSerializationException">Unknown permission target.</exception>
         public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
         {
             switch ((string)reader.Value)
@@ -20,10 +21,11 @@ namespace Discord.Net.Converters
                 case "role":
                     return PermissionTarget.Role;
                 default:
-                    throw new JsonSerializationException("Unknown permission target");
+                    throw new JsonSerializationException("Unknown permission target.");
             }
         }
 
+        /// <exception cref="JsonSerializationException">Invalid permission target.</exception>
         public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
         {
             switch ((PermissionTarget)value)
@@ -35,7 +37,7 @@ namespace Discord.Net.Converters
                     writer.WriteValue("role");
                     break;
                 default:
-                    throw new JsonSerializationException("Invalid permission target");
+                    throw new JsonSerializationException("Invalid permission target.");
             }
         }
     }
diff --git a/src/Discord.Net.Rest/Net/DefaultRestClient.cs b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
index 54fe3b681..05a568198 100644
--- a/src/Discord.Net.Rest/Net/DefaultRestClient.cs
+++ b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
@@ -82,6 +82,8 @@ namespace Discord.Net.Rest
                 return await SendInternalAsync(restRequest, cancelToken, headerOnly).ConfigureAwait(false);
             }
         }
+
+        /// <exception cref="InvalidOperationException">Unsupported param type.</exception>
         public async Task<RestResponse> SendAsync(string method, string endpoint, IReadOnlyDictionary<string, object> multipartParams, CancellationToken cancelToken, bool headerOnly, string reason = null)
         {
             string uri = Path.Combine(_baseUrl, endpoint);
@@ -111,7 +113,7 @@ namespace Discord.Net.Rest
                                 content.Add(new StreamContent(stream), p.Key, fileValue.Filename);
                                 continue;
                             }
-                            default: throw new InvalidOperationException($"Unsupported param type \"{p.Value.GetType().Name}\"");
+                            default: throw new InvalidOperationException($"Unsupported param type \"{p.Value.GetType().Name}\".");
                         }
                     }
                 }
diff --git a/src/Discord.Net.Rest/Net/DefaultRestClientProvider.cs b/src/Discord.Net.Rest/Net/DefaultRestClientProvider.cs
index e0e776549..67b47096e 100644
--- a/src/Discord.Net.Rest/Net/DefaultRestClientProvider.cs
+++ b/src/Discord.Net.Rest/Net/DefaultRestClientProvider.cs
@@ -6,6 +6,7 @@ namespace Discord.Net.Rest
     {
         public static readonly RestClientProvider Instance = Create();
 
+        /// <exception cref="PlatformNotSupportedException">The default RestClientProvider is not supported on this platform.</exception>
         public static RestClientProvider Create(bool useProxy = false)
         {
             return url =>
diff --git a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
index 40b91e98e..1b4830da2 100644
--- a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
+++ b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
@@ -117,7 +117,7 @@ namespace Discord.Net.Queue
                         if ((now - bucket.LastAttemptAt).TotalMinutes > 1.0)
                             _buckets.TryRemove(bucket.Id, out _);
                     }
-                    await Task.Delay(60000, _cancelToken.Token); //Runs each minute
+                    await Task.Delay(60000, _cancelToken.Token).ConfigureAwait(false); //Runs each minute
                 }
             }
             catch (OperationCanceledException) { }
diff --git a/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs b/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
index d7f9779a4..d2f77cc39 100644
--- a/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
+++ b/src/Discord.Net.Rest/Net/Queue/RequestQueueBucket.cs
@@ -126,7 +126,7 @@ namespace Discord.Net.Queue
                     if ((request.Options.RetryMode & RetryMode.RetryTimeouts) == 0)
                         throw;
 
-                    await Task.Delay(500);
+                    await Task.Delay(500).ConfigureAwait(false);
                     continue; //Retry
                 }
                 /*catch (Exception)
diff --git a/src/Discord.Net.Rest/Utils/TypingNotifier.cs b/src/Discord.Net.Rest/Utils/TypingNotifier.cs
index b4bd2f44b..745dbd36d 100644
--- a/src/Discord.Net.Rest/Utils/TypingNotifier.cs
+++ b/src/Discord.Net.Rest/Utils/TypingNotifier.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -6,21 +6,19 @@ namespace Discord.Rest
 {
     internal class TypingNotifier : IDisposable
     {
-        private readonly BaseDiscordClient _client;
         private readonly CancellationTokenSource _cancelToken;
         private readonly IMessageChannel _channel;
         private readonly RequestOptions _options;
 
-        public TypingNotifier(BaseDiscordClient discord, IMessageChannel channel, RequestOptions options)
+        public TypingNotifier(IMessageChannel channel, RequestOptions options)
         {
-            _client = discord;
             _cancelToken = new CancellationTokenSource();
             _channel = channel;
             _options = options;
-            var _ = Run();
+            _ = RunAsync();
         }
 
-        private async Task Run()
+        private async Task RunAsync()
         {
             try
             {
@@ -31,7 +29,11 @@ namespace Discord.Rest
                     {
                         await _channel.TriggerTypingAsync(_options).ConfigureAwait(false);
                     }
-                    catch { }
+                    catch
+                    {
+                        // ignored
+                    }
+
                     await Task.Delay(9500, token).ConfigureAwait(false);
                 }
             }
diff --git a/src/Discord.Net.WebSocket/Audio/AudioClient.cs b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
index 9f197b5c5..800e04933 100644
--- a/src/Discord.Net.WebSocket/Audio/AudioClient.cs
+++ b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
@@ -420,7 +420,6 @@ namespace Discord.Audio
         }
         private async Task RunKeepaliveAsync(int intervalMillis, CancellationToken cancelToken)
         {
-            var packet = new byte[8];
             try
             {
                 await _audioLogger.DebugAsync("Keepalive Started").ConfigureAwait(false);
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/OpusDecodeStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/OpusDecodeStream.cs
index 58c4f4c70..1861e3554 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/OpusDecodeStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/OpusDecodeStream.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -22,19 +22,22 @@ namespace Discord.Audio.Streams
             _decoder = new OpusDecoder();
         }
 
+        /// <exception cref="InvalidOperationException">Header received with no payload.</exception>
         public override void WriteHeader(ushort seq, uint timestamp, bool missed)
         {
             if (_hasHeader)
-                throw new InvalidOperationException("Header received with no payload");                
+                throw new InvalidOperationException("Header received with no payload.");                
             _hasHeader = true;
 
             _nextMissed = missed;
             _next.WriteHeader(seq, timestamp, missed);
         }
+
+        /// <exception cref="InvalidOperationException">Received payload without an RTP header.</exception>
         public override async Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancelToken)
         {
             if (!_hasHeader)
-                throw new InvalidOperationException("Received payload without an RTP header");
+                throw new InvalidOperationException("Received payload without an RTP header.");
             _hasHeader = false;
 
             if (!_nextMissed)
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/OpusEncodeStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/OpusEncodeStream.cs
index f5883ad4b..035b92b30 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/OpusEncodeStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/OpusEncodeStream.cs
@@ -25,7 +25,7 @@ namespace Discord.Audio.Streams
 
         public override async Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancelToken)
         {
-            //Assume threadsafe
+            //Assume thread-safe
             while (count > 0)
             {
                 if (_partialFramePos == 0 && count >= OpusConverter.FrameBytes)
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/RTPReadStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/RTPReadStream.cs
index 2cedea114..120f67e0d 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/RTPReadStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/RTPReadStream.cs
@@ -1,4 +1,5 @@
-using System.Threading;
+using System;
+using System.Threading;
 using System.Threading.Tasks;
 
 namespace Discord.Audio.Streams
@@ -20,6 +21,8 @@ namespace Discord.Audio.Streams
             _nonce = new byte[24];
         }
 
+        /// <exception cref="OperationCanceledException">The token has had cancellation requested.</exception>
+        /// <exception cref="ObjectDisposedException">The associated <see cref="T:System.Threading.CancellationTokenSource" /> has been disposed.</exception>
         public override async Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancelToken)
         {
             cancelToken.ThrowIfCancellationRequested();
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/SodiumDecryptStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/SodiumDecryptStream.cs
index 9ed849a5e..2b1a97f04 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/SodiumDecryptStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/SodiumDecryptStream.cs
@@ -4,7 +4,9 @@ using System.Threading.Tasks;
 
 namespace Discord.Audio.Streams
 {
-    ///<summary> Decrypts an RTP frame using libsodium </summary>
+    /// <summary>
+    ///     Decrypts an RTP frame using libsodium.
+    /// </summary>
     public class SodiumDecryptStream : AudioOutStream
     {
         private readonly AudioClient _client;
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/SodiumEncryptStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/SodiumEncryptStream.cs
index bacc9be47..8b3f0e302 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/SodiumEncryptStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/SodiumEncryptStream.cs
@@ -4,7 +4,9 @@ using System.Threading.Tasks;
 
 namespace Discord.Audio.Streams
 {
-    ///<summary> Encrypts an RTP frame using libsodium </summary>
+    /// <summary>
+    ///     Encrypts an RTP frame using libsodium.
+    /// </summary>
     public class SodiumEncryptStream : AudioOutStream
     {
         private readonly AudioClient _client;
@@ -20,21 +22,25 @@ namespace Discord.Audio.Streams
             _client = (AudioClient)client;
             _nonce = new byte[24];
         }
-        
+
+        /// <exception cref="InvalidOperationException">Header received with no payload.</exception>
         public override void WriteHeader(ushort seq, uint timestamp, bool missed)
         {
             if (_hasHeader)
-                throw new InvalidOperationException("Header received with no payload");
+                throw new InvalidOperationException("Header received with no payload.");
 
             _nextSeq = seq;
             _nextTimestamp = timestamp;
             _hasHeader = true;
         }
+        /// <exception cref="InvalidOperationException">Received payload without an RTP header.</exception>
+        /// <exception cref="OperationCanceledException">The token has had cancellation requested.</exception>
+        /// <exception cref="ObjectDisposedException">The associated <see cref="T:System.Threading.CancellationTokenSource" /> has been disposed.</exception>
         public override async Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancelToken)
         {
             cancelToken.ThrowIfCancellationRequested();
             if (!_hasHeader)
-                throw new InvalidOperationException("Received payload without an RTP header");
+                throw new InvalidOperationException("Received payload without an RTP header.");
             _hasHeader = false;
 
             if (_client.SecretKey == null)
diff --git a/src/Discord.Net.WebSocket/BaseSocketClient.Events.cs b/src/Discord.Net.WebSocket/BaseSocketClient.Events.cs
index c236b1045..b1b7d17b5 100644
--- a/src/Discord.Net.WebSocket/BaseSocketClient.Events.cs
+++ b/src/Discord.Net.WebSocket/BaseSocketClient.Events.cs
@@ -7,6 +7,17 @@ namespace Discord.WebSocket
     {
         //Channels
         /// <summary> Fired when a channel is created. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a generic channel has been created. The event handler must return a
+        ///         <see cref="Task"/> and accept a <see cref="SocketChannel"/> as its parameter.
+        ///     </para>
+        ///     <para>
+        ///         The newly created channel is passed into the event handler parameter. The given channel type may
+        ///         include, but not limited to, Private Channels (DM, Group), Guild Channels (Text, Voice, Category);
+        ///         see the derived classes of <see cref="SocketChannel"/> for more details.
+        ///     </para>
+        /// </remarks>
         public event Func<SocketChannel, Task> ChannelCreated 
         {
             add { _channelCreatedEvent.Add(value); }
@@ -14,12 +25,35 @@ namespace Discord.WebSocket
         }
         internal readonly AsyncEvent<Func<SocketChannel, Task>> _channelCreatedEvent = new AsyncEvent<Func<SocketChannel, Task>>();
         /// <summary> Fired when a channel is destroyed. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a generic channel has been destroyed. The event handler must return a
+        ///         <see cref="Task"/> and accept a <see cref="SocketChannel"/> as its parameter.
+        ///     </para>
+        ///     <para>
+        ///         The destroyed channel is passed into the event handler parameter. The given channel type may
+        ///         include, but not limited to, Private Channels (DM, Group), Guild Channels (Text, Voice, Category);
+        ///         see the derived classes of <see cref="SocketChannel"/> for more details.
+        ///     </para>
+        /// </remarks>
         public event Func<SocketChannel, Task> ChannelDestroyed {
             add { _channelDestroyedEvent.Add(value); }
             remove { _channelDestroyedEvent.Remove(value); }
         }
         internal readonly AsyncEvent<Func<SocketChannel, Task>> _channelDestroyedEvent = new AsyncEvent<Func<SocketChannel, Task>>();
         /// <summary> Fired when a channel is updated. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a generic channel has been destroyed. The event handler must return a
+        ///         <see cref="Task"/> and accept 2 <see cref="SocketChannel"/> as its parameters.
+        ///     </para>
+        ///     <para>
+        ///         The original (prior to update) channel is passed into the first <see cref="SocketChannel"/>, while
+        ///         the updated channel is passed into the second. The given channel type may include, but not limited
+        ///         to, Private Channels (DM, Group), Guild Channels (Text, Voice, Category); see the derived classes of
+        ///         <see cref="SocketChannel"/> for more details.
+        ///     </para>
+        /// </remarks>
         public event Func<SocketChannel, SocketChannel, Task> ChannelUpdated {
             add { _channelUpdatedEvent.Add(value); }
             remove { _channelUpdatedEvent.Remove(value); }
@@ -28,18 +62,72 @@ namespace Discord.WebSocket
 
         //Messages
         /// <summary> Fired when a message is received. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a message is received. The event handler must return a
+        ///         <see cref="Task"/> and accept a <see cref="SocketMessage"/> as its parameter.
+        ///     </para>
+        ///     <para>
+        ///         The message that is sent to the client is passed into the event handler parameter as
+        ///         <see cref="SocketMessage"/>. This message may be a system message (i.e.
+        ///         <see cref="SocketSystemMessage"/>) or a user message (i.e. <see cref="SocketUserMessage"/>. See the
+        ///         derived classes of <see cref="SocketMessage"/> for more details.
+        ///     </para>
+        /// </remarks>
         public event Func<SocketMessage, Task> MessageReceived {
             add { _messageReceivedEvent.Add(value); }
             remove { _messageReceivedEvent.Remove(value); }
         }
         internal readonly AsyncEvent<Func<SocketMessage, Task>> _messageReceivedEvent = new AsyncEvent<Func<SocketMessage, Task>>();
         /// <summary> Fired when a message is deleted. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a message is deleted. The event handler must return a
+        ///         <see cref="Task"/> and accept a <see cref="Cacheable{TEntity,TId}"/> and 
+        ///         <see cref="ISocketMessageChannel"/> as its parameters.
+        ///     </para>
+        ///     <para>
+        ///         <note type="important">
+        ///             It is not possible to retrieve the message via
+        ///             <see cref="Cacheable{TEntity,TId}.DownloadAsync"/>; the message cannot be retrieved by Discord
+        ///             after the message has been deleted.
+        ///         </note>
+        ///         If caching is enabled via <see cref="DiscordSocketConfig"/>, the
+        ///         <see cref="Cacheable{TEntity,TId}"/> entity will contain the deleted message; otherwise, in event
+        ///         that the message cannot be retrieved, the snowflake ID of the message is preserved in the 
+        ///         <see cref="ulong"/>.
+        ///     </para>
+        ///     <para>
+        ///         The source channel of the removed message will be passed into the 
+        ///         <see cref="ISocketMessageChannel"/> parameter.
+        ///     </para>
+        /// </remarks>
         public event Func<Cacheable<IMessage, ulong>, ISocketMessageChannel, Task> MessageDeleted {
             add { _messageDeletedEvent.Add(value); }
             remove { _messageDeletedEvent.Remove(value); }
         }
         internal readonly AsyncEvent<Func<Cacheable<IMessage, ulong>, ISocketMessageChannel, Task>> _messageDeletedEvent = new AsyncEvent<Func<Cacheable<IMessage, ulong>, ISocketMessageChannel, Task>>();
         /// <summary> Fired when a message is updated. </summary>
+        /// <remarks>
+        ///     <para>
+        ///         This event is fired when a message is updated. The event handler must return a
+        ///         <see cref="Task"/> and accept a <see cref="Cacheable{TEntity,TId}"/>, <see cref="SocketMessage"/>,
+        ///         and <see cref="ISocketMessageChannel"/> as its parameters.
+        ///     </para>
+        ///     <para>
+        ///         If caching is enabled via <see cref="DiscordSocketConfig"/>, the
+        ///         <see cref="Cacheable{TEntity,TId}"/> entity will contain the original message; otherwise, in event
+        ///         that the message cannot be retrieved, the snowflake ID of the message is preserved in the 
+        ///         <see cref="ulong"/>.
+        ///     </para>
+        ///     <para>
+        ///         The updated message will be passed into the <see cref="SocketMessage"/> parameter.
+        ///     </para>
+        ///     <para>
+        ///         The source channel of the updated message will be passed into the 
+        ///         <see cref="ISocketMessageChannel"/> parameter.
+        ///     </para>
+        /// </remarks>
         public event Func<Cacheable<IMessage, ulong>, SocketMessage, ISocketMessageChannel, Task> MessageUpdated {
             add { _messageUpdatedEvent.Add(value); }
             remove { _messageUpdatedEvent.Remove(value); }
diff --git a/src/Discord.Net.WebSocket/BaseSocketClient.cs b/src/Discord.Net.WebSocket/BaseSocketClient.cs
index a7d590b42..abaf5989e 100644
--- a/src/Discord.Net.WebSocket/BaseSocketClient.cs
+++ b/src/Discord.Net.WebSocket/BaseSocketClient.cs
@@ -6,88 +6,288 @@ using Discord.Rest;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents the base of a WebSocket-based Discord client.
+    /// </summary>
     public abstract partial class BaseSocketClient : BaseDiscordClient, IDiscordClient
     {
-        protected readonly DiscordSocketConfig _baseconfig;
+        protected readonly DiscordSocketConfig BaseConfig;
 
-        /// <summary> Gets the estimated round-trip latency, in milliseconds, to the gateway server. </summary>
+        /// <summary>
+        ///     Gets the estimated round-trip latency, in milliseconds, to the gateway server.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="int"/> that represents the round-trip latency to the WebSocket server. Please
+        ///     note that this value does not represent a "true" latency for operations such as sending a message.
+        /// </returns>
         public abstract int Latency { get; protected set; }
-        public abstract UserStatus Status { get; protected set; } 
+        /// <summary>
+        ///     Gets the status for the logged-in user.
+        /// </summary>
+        /// <returns>
+        ///     A status object that represents the user's online presence status.
+        /// </returns>
+        public abstract UserStatus Status { get; protected set; }
+        /// <summary>
+        ///     Gets the activity for the logged-in user.
+        /// </summary>
+        /// <returns>
+        ///     An activity object that represents the user's current activity.
+        /// </returns>
         public abstract IActivity Activity { get; protected set; }
 
         internal new DiscordSocketApiClient ApiClient => base.ApiClient as DiscordSocketApiClient;
 
+        /// <summary>
+        ///     Gets the current logged-in user.
+        /// </summary>
         public new SocketSelfUser CurrentUser { get => base.CurrentUser as SocketSelfUser; protected set => base.CurrentUser = value; }
+        /// <summary>
+        ///     Gets a collection of guilds that the user is currently in.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of guilds that the current user is in.
+        /// </returns>
         public abstract IReadOnlyCollection<SocketGuild> Guilds { get; }
+        /// <summary>
+        ///     Gets a collection of private channels opened in this session.
+        /// </summary>
+        /// <remarks>
+        ///     This method will retrieve all private channels (including direct-message, group channel and such) that
+        ///     are currently opened in this session.
+        ///     <note type="warning">
+        ///         This method will not return previously opened private channels outside of the current session! If
+        ///         you have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A read-only collection of private channels that the user currently partakes in.
+        /// </returns>
         public abstract IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels { get; }
+        /// <summary>
+        ///     Gets a collection of available voice regions.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of voice regions that the user has access to.
+        /// </returns>
         public abstract IReadOnlyCollection<RestVoiceRegion> VoiceRegions { get; }
 
         internal BaseSocketClient(DiscordSocketConfig config, DiscordRestApiClient client)
-            : base(config, client) => _baseconfig = config;
+            : base(config, client) => BaseConfig = config;
         private static DiscordSocketApiClient CreateApiClient(DiscordSocketConfig config)
             => new DiscordSocketApiClient(config.RestClientProvider, config.WebSocketProvider, DiscordRestConfig.UserAgent);
 
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets a Discord application information for the logged-in user.
+        /// </summary>
+        /// <remarks>
+        ///     This method reflects your application information you submitted when creating a Discord application via
+        ///     the Developer Portal.
+        /// </remarks>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the application
+        ///     information.
+        /// </returns>
         public abstract Task<RestApplication> GetApplicationInfoAsync(RequestOptions options = null);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets a generic user.
+        /// </summary>
+        /// <param name="id">The user snowflake ID.</param>
+        /// <remarks>
+        ///     This method gets the user present in the WebSocket cache with the given condition.
+        ///     <note type="warning">
+        ///         Sometimes a user may return <c>null</c> due to Discord not sending offline users in large
+        ///         guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling 
+        ///         <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>.
+        ///     </note>
+        ///     <note>
+        ///         This method does not attempt to fetch users that the logged-in user does not have access to (i.e.
+        ///         users who don't share mutual guild(s) with the current user).
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A generic WebSocket-based user; <c>null</c> when the user cannot be found.
+        /// </returns>
         public abstract SocketUser GetUser(ulong id);
-        /// <inheritdoc />
+
+        /// <summary>
+        ///     Gets a user.
+        /// </summary>
+        /// <param name="username">The name of the user.</param>
+        /// <param name="discriminator">The discriminator value of the user.</param>
+        /// <remarks>
+        ///     This method gets the user present in the WebSocket cache with the given condition.
+        ///     <note type="warning">
+        ///         Sometimes a user may return <c>null</c> due to Discord not sending offline users in large
+        ///         guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling 
+        ///         <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>.
+        ///     </note>
+        ///     <note>
+        ///         This method does not attempt to fetch users that the logged-in user does not have access to (i.e.
+        ///         users who don't share mutual guild(s) with the current user).
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A generic WebSocket-based user; <c>null</c> when the user cannot be found.
+        /// </returns>
         public abstract SocketUser GetUser(string username, string discriminator);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets a channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the channel (e.g. `381889909113225237`).</param>
+        /// <returns>
+        ///     A generic WebSocket-based channel object (voice, text, category, etc.) associated with the identifier;
+        ///     <c>null</c> when the channel cannot be found.
+        /// </returns>
         public abstract SocketChannel GetChannel(ulong id);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets a guild.
+        /// </summary>
+        /// <param name="id">The guild snowflake identifier.</param>
+        /// <returns>
+        ///     A WebSocket-based guild associated with the snowflake identifier; <c>null</c> when the guild cannot be
+        ///     found.
+        /// </returns>
         public abstract SocketGuild GetGuild(ulong id);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets a voice region.
+        /// </summary>
+        /// <param name="id">The identifier of the voice region (e.g. <c>eu-central</c> ).</param>
+        /// <returns>
+        ///     A REST-based voice region associated with the identifier; <c>null</c> if the voice region is not
+        ///     found.
+        /// </returns>
         public abstract RestVoiceRegion GetVoiceRegion(string id);
         /// <inheritdoc />
         public abstract Task StartAsync();
         /// <inheritdoc />
         public abstract Task StopAsync();
+        /// <summary>
+        ///     Sets the current status of the user (e.g. Online, Do not Disturb).
+        /// </summary>
+        /// <param name="status">The new status to be set.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous set operation.
+        /// </returns>
         public abstract Task SetStatusAsync(UserStatus status);
+        /// <summary>
+        ///     Sets the game of the user.
+        /// </summary>
+        /// <param name="name">The name of the game.</param>
+        /// <param name="streamUrl">If streaming, the URL of the stream. Must be a valid Twitch URL.</param>
+        /// <param name="type">The type of the game.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous set operation.
+        /// </returns>
         public abstract Task SetGameAsync(string name, string streamUrl = null, ActivityType type = ActivityType.Playing);
+        /// <summary>
+        ///     Sets the <paramref name="activity"/> of the logged-in user.
+        /// </summary>
+        /// <remarks>
+        ///     This method sets the <paramref name="activity"/> of the user. 
+        ///     <note type="note">
+        ///         Discord will only accept setting of name and the type of activity.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Rich Presence cannot be set via this method or client. Rich Presence is strictly limited to RPC
+        ///         clients only. 
+        ///     </note>
+        /// </remarks>
+        /// <param name="activity">The activity to be set.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous set operation.
+        /// </returns>
         public abstract Task SetActivityAsync(IActivity activity);
-        public abstract Task DownloadUsersAsync(IEnumerable<IGuild> guilds);  
+        /// <summary>
+        ///     Attempts to download users into the user cache for the selected guilds.
+        /// </summary>
+        /// <param name="guilds">The guilds to download the members from.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous download operation.
+        /// </returns>
+        public abstract Task DownloadUsersAsync(IEnumerable<IGuild> guilds);
 
-        /// <inheritdoc />
+        /// <summary>
+        ///     Creates a guild for the logged-in user who is in less than 10 active guilds.
+        /// </summary>
+        /// <remarks>
+        ///     This method creates a new guild on behalf of the logged-in user. 
+        ///     <note type="warning">
+        ///         Due to Discord's limitation, this method will only work for users that are in less than 10 guilds.
+        ///     </note>
+        /// </remarks>
+        /// <param name="name">The name of the new guild.</param>
+        /// <param name="region">The voice region to create the guild with.</param>
+        /// <param name="jpegIcon">The icon of the guild.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the created guild.
+        /// </returns>
         public Task<RestGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null)
             => ClientHelper.CreateGuildAsync(this, name, region, jpegIcon, options ?? RequestOptions.Default);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets the connections that the user has set up.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of connections.
+        /// </returns>
         public Task<IReadOnlyCollection<RestConnection>> GetConnectionsAsync(RequestOptions options = null)
             => ClientHelper.GetConnectionsAsync(this, options ?? RequestOptions.Default);
-        /// <inheritdoc />
+        /// <summary>
+        ///     Gets an invite.
+        /// </summary>
+        /// <param name="inviteId">The invitation identifier.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the invite information.
+        /// </returns>
         public Task<RestInviteMetadata> GetInviteAsync(string inviteId, RequestOptions options = null)
             => ClientHelper.GetInviteAsync(this, inviteId, options ?? RequestOptions.Default);
         
         // IDiscordClient
+        /// <inheritdoc />
         async Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options)
             => await GetApplicationInfoAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IChannel> IDiscordClient.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IChannel>(GetChannel(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IPrivateChannel>> IDiscordClient.GetPrivateChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IPrivateChannel>>(PrivateChannels);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IConnection>> IDiscordClient.GetConnectionsAsync(RequestOptions options)
             => await GetConnectionsAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IInvite> IDiscordClient.GetInviteAsync(string inviteId, RequestOptions options)
             => await GetInviteAsync(inviteId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IGuild> IDiscordClient.GetGuildAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuild>(GetGuild(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuild>> IDiscordClient.GetGuildsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuild>>(Guilds);
 
+        /// <inheritdoc />
         async Task<IGuild> IDiscordClient.CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon, RequestOptions options)
             => await CreateGuildAsync(name, region, jpegIcon, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(string username, string discriminator, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(username, discriminator));
 
+        /// <inheritdoc />
         Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => Task.FromResult<IVoiceRegion>(GetVoiceRegion(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IVoiceRegion>> IDiscordClient.GetVoiceRegionsAsync(RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IVoiceRegion>>(VoiceRegions);
     }
diff --git a/src/Discord.Net.WebSocket/ClientState.cs b/src/Discord.Net.WebSocket/ClientState.cs
index a119e5e28..dad185d66 100644
--- a/src/Discord.Net.WebSocket/ClientState.cs
+++ b/src/Discord.Net.WebSocket/ClientState.cs
@@ -74,7 +74,7 @@ namespace Discord.WebSocket
                     case SocketDMChannel dmChannel:
                         _dmChannels.TryRemove(dmChannel.Recipient.Id, out _);
                         break;
-                    case SocketGroupChannel groupChannel:
+                    case SocketGroupChannel _:
                         _groupChannels.TryRemove(id);
                         break;
                 }
diff --git a/src/Discord.Net.WebSocket/Commands/ShardedCommandContext.cs b/src/Discord.Net.WebSocket/Commands/ShardedCommandContext.cs
index a29c9bb70..f970c32fc 100644
--- a/src/Discord.Net.WebSocket/Commands/ShardedCommandContext.cs
+++ b/src/Discord.Net.WebSocket/Commands/ShardedCommandContext.cs
@@ -1,9 +1,11 @@
-using Discord.WebSocket;
+using Discord.WebSocket;
 
 namespace Discord.Commands
 {
+    /// <summary> The sharded variant of <see cref="ICommandContext"/>, which may contain the client, user, guild, channel, and message. </summary>
     public class ShardedCommandContext : SocketCommandContext, ICommandContext
     {
+        /// <summary> Gets the <see cref="DiscordShardedClient"/> that the command is executed with. </summary>
         public new DiscordShardedClient Client { get; }
 
         public ShardedCommandContext(DiscordShardedClient client, SocketUserMessage msg)
@@ -12,10 +14,12 @@ namespace Discord.Commands
             Client = client;
         }
 
+        /// <summary> Gets the shard ID of the command context. </summary>
         private static int GetShardId(DiscordShardedClient client, IGuild guild)
             => guild == null ? 0 : client.GetShardIdFor(guild);
 
         //ICommandContext
+        /// <inheritdoc />
         IDiscordClient ICommandContext.Client => Client;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Commands/SocketCommandContext.cs b/src/Discord.Net.WebSocket/Commands/SocketCommandContext.cs
index c8b0747e7..f4d517909 100644
--- a/src/Discord.Net.WebSocket/Commands/SocketCommandContext.cs
+++ b/src/Discord.Net.WebSocket/Commands/SocketCommandContext.cs
@@ -1,17 +1,43 @@
-using Discord.WebSocket;
+using Discord.WebSocket;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Represents a WebSocket-based context of a command. This may include the client, guild, channel, user, and message.
+    /// </summary>
     public class SocketCommandContext : ICommandContext
     {
+        /// <summary>
+        ///     Gets the <see cref="DiscordSocketClient" /> that the command is executed with.
+        /// </summary>
         public DiscordSocketClient Client { get; }
+        /// <summary>
+        ///     Gets the <see cref="SocketGuild" /> that the command is executed in.
+        /// </summary>
         public SocketGuild Guild { get; }
+        /// <summary>
+        ///     Gets the <see cref="ISocketMessageChannel" /> that the command is executed in.
+        /// </summary>
         public ISocketMessageChannel Channel { get; }
+        /// <summary>
+        ///     Gets the <see cref="SocketUser" /> who executed the command.
+        /// </summary>
         public SocketUser User { get; }
+        /// <summary>
+        ///     Gets the <see cref="SocketUserMessage" /> that the command is interpreted from.
+        /// </summary>
         public SocketUserMessage Message { get; }
 
+        /// <summary>
+        ///     Indicates whether the channel that the command is executed in is a private channel.
+        /// </summary>
         public bool IsPrivate => Channel is IPrivateChannel;
 
+        /// <summary>
+        ///     Initializes a new <see cref="SocketCommandContext" /> class with the provided client and message.
+        /// </summary>
+        /// <param name="client">The underlying client.</param>
+        /// <param name="msg">The underlying message.</param>
         public SocketCommandContext(DiscordSocketClient client, SocketUserMessage msg)
         {
             Client = client;
@@ -22,10 +48,15 @@ namespace Discord.Commands
         }
 
         //ICommandContext
+        /// <inheritdoc/>
         IDiscordClient ICommandContext.Client => Client;
+        /// <inheritdoc/>
         IGuild ICommandContext.Guild => Guild;
+        /// <inheritdoc/>
         IMessageChannel ICommandContext.Channel => Channel;
+        /// <inheritdoc/>
         IUser ICommandContext.User => User;
+        /// <inheritdoc/>
         IUserMessage ICommandContext.Message => Message;
     }
 }
diff --git a/src/Discord.Net.WebSocket/DiscordShardedClient.cs b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
index 881ce3909..4e497346f 100644
--- a/src/Discord.Net.WebSocket/DiscordShardedClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
@@ -19,24 +19,29 @@ namespace Discord.WebSocket
         private DiscordSocketClient[] _shards;
         private int _totalShards;
         
-        /// <summary> Gets the estimated round-trip latency, in milliseconds, to the gateway server. </summary>
+        /// <inheritdoc />
         public override int Latency { get => GetLatency(); protected set { } }
+        /// <inheritdoc />
         public override UserStatus Status { get => _shards[0].Status; protected set { } }
+        /// <inheritdoc />
         public override IActivity Activity { get => _shards[0].Activity; protected set { } }
 
         internal new DiscordSocketApiClient ApiClient => base.ApiClient as DiscordSocketApiClient;
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuild> Guilds => GetGuilds().ToReadOnlyCollection(GetGuildCount);
+        /// <inheritdoc />
         public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels => GetPrivateChannels().ToReadOnlyCollection(GetPrivateChannelCount);
         public IReadOnlyCollection<DiscordSocketClient> Shards => _shards;
+        /// <inheritdoc />
         public override IReadOnlyCollection<RestVoiceRegion> VoiceRegions => _shards[0].VoiceRegions;
 
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient() : this(null, new DiscordSocketConfig()) { }
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient(DiscordSocketConfig config) : this(null, config, CreateApiClient(config)) { }
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient(int[] ids) : this(ids, new DiscordSocketConfig()) { }
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient(int[] ids, DiscordSocketConfig config) : this(ids, config, CreateApiClient(config)) { }
         private DiscordShardedClient(int[] ids, DiscordSocketConfig config, API.DiscordSocketApiClient client)
             : base(config, client)
@@ -90,13 +95,13 @@ namespace Discord.WebSocket
                 }
             }
 
-            //Assume threadsafe: already in a connection lock
+            //Assume thread safe: already in a connection lock
             for (int i = 0; i < _shards.Length; i++)
-                await _shards[i].LoginAsync(tokenType, token, false);
+                await _shards[i].LoginAsync(tokenType, token);
         }
         internal override async Task OnLogoutAsync()
         {
-            //Assume threadsafe: already in a connection lock
+            //Assume thread safe: already in a connection lock
             if (_shards != null)
             {
                 for (int i = 0; i < _shards.Length; i++)
@@ -213,9 +218,11 @@ namespace Discord.WebSocket
         public override RestVoiceRegion GetVoiceRegion(string id)
             => _shards[0].GetVoiceRegion(id);
 
-        /// <summary> Downloads the users list for the provided guilds, if they don't have a complete list. </summary>
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="guilds"/> is <see langword="null"/></exception>
         public override async Task DownloadUsersAsync(IEnumerable<IGuild> guilds)
         {
+            if (guilds == null) throw new ArgumentNullException(nameof(guilds));
             for (int i = 0; i < _shards.Length; i++)
             {
                 int id = _shardIds[i];
@@ -233,11 +240,13 @@ namespace Discord.WebSocket
             return (int)Math.Round(total / (double)_shards.Length);
         }
 
+        /// <inheritdoc />
         public override async Task SetStatusAsync(UserStatus status)
         {
             for (int i = 0; i < _shards.Length; i++)
                 await _shards[i].SetStatusAsync(status).ConfigureAwait(false);
         }
+        /// <inheritdoc />
         public override async Task SetGameAsync(string name, string streamUrl = null, ActivityType type = ActivityType.Playing)
         {
             IActivity activity = null;
@@ -247,6 +256,7 @@ namespace Discord.WebSocket
                 activity = new Game(name, type);
             await SetActivityAsync(activity).ConfigureAwait(false);
         }
+        /// <inheritdoc />
         public override async Task SetActivityAsync(IActivity activity)
         {
             for (int i = 0; i < _shards.Length; i++)
@@ -317,34 +327,46 @@ namespace Discord.WebSocket
         }
 
         //IDiscordClient
+        /// <inheritdoc />
         async Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options)
             => await GetApplicationInfoAsync().ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IChannel> IDiscordClient.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IChannel>(GetChannel(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IPrivateChannel>> IDiscordClient.GetPrivateChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IPrivateChannel>>(PrivateChannels);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IConnection>> IDiscordClient.GetConnectionsAsync(RequestOptions options)
             => await GetConnectionsAsync().ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IInvite> IDiscordClient.GetInviteAsync(string inviteId, RequestOptions options)
             => await GetInviteAsync(inviteId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IGuild> IDiscordClient.GetGuildAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuild>(GetGuild(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuild>> IDiscordClient.GetGuildsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuild>>(Guilds);
+        /// <inheritdoc />
         async Task<IGuild> IDiscordClient.CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon, RequestOptions options)
             => await CreateGuildAsync(name, region, jpegIcon).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(string username, string discriminator, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(username, discriminator));
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IVoiceRegion>> IDiscordClient.GetVoiceRegionsAsync(RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IVoiceRegion>>(VoiceRegions);
+        /// <inheritdoc />
         Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => Task.FromResult<IVoiceRegion>(GetVoiceRegion(id));
     }
diff --git a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
index d42bd7132..bc579793d 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
@@ -1,6 +1,5 @@
 #pragma warning disable CS1591
 using Discord.API.Gateway;
-using Discord.API.Rest;
 using Discord.Net.Queue;
 using Discord.Net.Rest;
 using Discord.Net.WebSockets;
@@ -120,12 +119,14 @@ namespace Discord.API
             }
             finally { _stateLock.Release(); }
         }
+        /// <exception cref="InvalidOperationException">The client must be logged in before connecting.</exception>
+        /// <exception cref="NotSupportedException">This client is not configured with WebSocket support.</exception>
         internal override async Task ConnectInternalAsync()
         {
             if (LoginState != LoginState.LoggedIn)
-                throw new InvalidOperationException("You must log in before connecting.");
+                throw new InvalidOperationException("The client must be logged in before connecting.");
             if (WebSocketClient == null)
-                throw new NotSupportedException("This client is not configured with websocket support.");
+                throw new NotSupportedException("This client is not configured with WebSocket support.");
 
             //Re-create streams to reset the zlib state
             _compressed?.Dispose();
@@ -176,10 +177,11 @@ namespace Discord.API
             }
             finally { _stateLock.Release(); }
         }
+        /// <exception cref="NotSupportedException">This client is not configured with WebSocket support.</exception>
         internal override async Task DisconnectInternalAsync()
         {
             if (WebSocketClient == null)
-                throw new NotSupportedException("This client is not configured with websocket support.");
+                throw new NotSupportedException("This client is not configured with WebSocket support.");
 
             if (ConnectionState == ConnectionState.Disconnected) return;
             ConnectionState = ConnectionState.Disconnecting;
diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.Events.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.Events.cs
index 1222b270e..51dea5f9f 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.Events.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.Events.cs
@@ -1,8 +1,9 @@
-using System;
+using System;
 using System.Threading.Tasks;
+using Discord.API;
 
 namespace Discord.WebSocket
-{                                
+{
     public partial class DiscordSocketClient
     {
         //General
@@ -34,5 +35,9 @@ namespace Discord.WebSocket
             remove { _latencyUpdatedEvent.Remove(value); }
         }
         private readonly AsyncEvent<Func<int, int, Task>> _latencyUpdatedEvent = new AsyncEvent<Func<int, int, Task>>();
+
+        internal DiscordSocketClient(DiscordSocketConfig config, DiscordRestApiClient client) : base(config, client)
+        {
+        }
     }
 }
diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
index 45d60b764..81538e6e7 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
@@ -19,6 +19,9 @@ using GameModel = Discord.API.Game;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based Discord client.
+    /// </summary>
     public partial class DiscordSocketClient : BaseSocketClient, IDiscordClient
     {
         private readonly ConcurrentQueue<ulong> _largeGuilds;
@@ -46,7 +49,9 @@ namespace Discord.WebSocket
         public ConnectionState ConnectionState => _connection.State;
         /// <inheritdoc />
         public override int Latency { get; protected set; }
+        /// <inheritdoc />
         public override UserStatus Status { get; protected set; } = UserStatus.Online;
+        /// <inheritdoc />
         public override IActivity Activity { get; protected set; }
 
         //From DiscordSocketConfig
@@ -58,19 +63,53 @@ namespace Discord.WebSocket
         internal WebSocketProvider WebSocketProvider { get; private set; }
         internal bool AlwaysDownloadUsers { get; private set; }
         internal int? HandlerTimeout { get; private set; }
-
+        
         internal new DiscordSocketApiClient ApiClient => base.ApiClient as DiscordSocketApiClient;
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuild> Guilds => State.Guilds;
+        /// <inheritdoc />
         public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels => State.PrivateChannels;
+        /// <summary>
+        ///     Gets a collection of direct message channels opened in this session.
+        /// </summary>
+        /// <remarks>
+        ///     This method returns a collection of currently opened direct message channels.
+        ///     <note type="warning">
+        ///         This method will not return previously opened DM channels outside of the current session! If you
+        ///         have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     An collection of DM channels that have been opened in this session.
+        /// </returns>
         public IReadOnlyCollection<SocketDMChannel> DMChannels
             => State.PrivateChannels.OfType<SocketDMChannel>().ToImmutableArray();
+        /// <summary>
+        ///     Gets a collection of group channels opened in this session.
+        /// </summary>
+        /// <remarks>
+        ///     This method returns a collection of currently opened group channels.
+        ///     <note type="warning">
+        ///         This method will not return previously opened group channels outside of the current session! If you
+        ///         have just started the client, this may return an empty collection.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     An collection of group channels that have been opened in this session.
+        /// </returns>
         public IReadOnlyCollection<SocketGroupChannel> GroupChannels
             => State.PrivateChannels.OfType<SocketGroupChannel>().ToImmutableArray();
+        /// <inheritdoc />
         public override IReadOnlyCollection<RestVoiceRegion> VoiceRegions => _voiceRegions.ToReadOnlyCollection();
 
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary>
+        ///     Initializes a new REST/WebSocket-based Discord client.
+        /// </summary>
         public DiscordSocketClient() : this(new DiscordSocketConfig()) { }
-        /// <summary> Creates a new REST/WebSocket discord client. </summary>
+        /// <summary>
+        ///     Initializes a new REST/WebSocket-based Discord client with the provided configuration.
+        /// </summary>
+        /// <param name="config">The configuration to be used with the client.</param>
         public DiscordSocketClient(DiscordSocketConfig config) : this(config, CreateApiClient(config), null, null) { }
         internal DiscordSocketClient(DiscordSocketConfig config, SemaphoreSlim groupLock, DiscordSocketClient parentClient) : this(config, CreateApiClient(config), groupLock, parentClient) { }
         private DiscordSocketClient(DiscordSocketConfig config, API.DiscordSocketApiClient client, SemaphoreSlim groupLock, DiscordSocketClient parentClient)
@@ -128,6 +167,7 @@ namespace Discord.WebSocket
         }
         private static API.DiscordSocketApiClient CreateApiClient(DiscordSocketConfig config)
             => new API.DiscordSocketApiClient(config.RestClientProvider, config.WebSocketProvider, DiscordRestConfig.UserAgent, config.GatewayHost);
+        /// <inheritdoc />
         internal override void Dispose(bool disposing)
         {
             if (disposing)
@@ -137,6 +177,7 @@ namespace Discord.WebSocket
             }
         }
 
+        /// <inheritdoc />
         internal override async Task OnLoginAsync(TokenType tokenType, string token)
         {
             if (_parentClient == null)
@@ -147,6 +188,7 @@ namespace Discord.WebSocket
             else
                 _voiceRegions = _parentClient._voiceRegions;
         }
+        /// <inheritdoc />
         internal override async Task OnLogoutAsync()
         {
             await StopAsync().ConfigureAwait(false);
@@ -154,9 +196,11 @@ namespace Discord.WebSocket
             _voiceRegions = ImmutableDictionary.Create<string, RestVoiceRegion>();
         }
 
-        public override async Task StartAsync()
+        /// <inheritdoc />
+        public override async Task StartAsync() 
             => await _connection.StartAsync().ConfigureAwait(false);
-        public override async Task StopAsync()
+        /// <inheritdoc />
+        public override async Task StopAsync() 
             => await _connection.StopAsync().ConfigureAwait(false);
 
         private async Task OnConnectingAsync()
@@ -277,7 +321,7 @@ namespace Discord.WebSocket
             return null;
         }
 
-        /// <summary> Downloads the users list for the provided guilds, if they don't have a complete list. </summary>
+        /// <inheritdoc />
         public override async Task DownloadUsersAsync(IEnumerable<IGuild> guilds)
         {
             if (ConnectionState == ConnectionState.Connected)
@@ -316,6 +360,13 @@ namespace Discord.WebSocket
             }
         }
 
+        /// <inheritdoc />
+        /// <example>
+        ///     The following example sets the status of the current user to Do Not Disturb.
+        ///     <code language="cs">
+        ///     await client.SetStatusAsync(UserStatus.DoNotDisturb);
+        ///     </code>
+        /// </example>
         public override async Task SetStatusAsync(UserStatus status)
         {
             Status = status;
@@ -325,6 +376,21 @@ namespace Discord.WebSocket
                 _statusSince = null;
             await SendStatusAsync().ConfigureAwait(false);
         }
+        /// <inheritdoc />
+        /// <example>
+        /// <para>
+        ///     The following example sets the activity of the current user to the specified game name.
+        ///     <code language="cs">
+        ///     await client.SetGameAsync("A Strange Game");
+        ///     </code>
+        /// </para>
+        /// <para>
+        ///     The following example sets the activity of the current user to a streaming status.
+        ///     <code language="cs">
+        ///     await client.SetGameAsync("Great Stream 10/10", "https://twitch.tv/MyAmazingStream1337", ActivityType.Streaming);
+        ///     </code>
+        /// </para>
+        /// </example>
         public override async Task SetGameAsync(string name, string streamUrl = null, ActivityType type = ActivityType.Playing)
         {
             if (!string.IsNullOrEmpty(streamUrl))
@@ -335,6 +401,7 @@ namespace Discord.WebSocket
                 Activity = null;
             await SendStatusAsync().ConfigureAwait(false);
         }
+        /// <inheritdoc />
         public override async Task SetActivityAsync(IActivity activity)
         {
             Activity = activity;
@@ -352,7 +419,7 @@ namespace Discord.WebSocket
             var gameModel = new GameModel();
             // Discord only accepts rich presence over RPC, don't even bother building a payload
             if (Activity is RichGame)
-                throw new NotSupportedException("Outgoing Rich Presences are not supported");
+                throw new NotSupportedException("Outgoing Rich Presences are not supported via WebSocket.");
 
             if (Activity != null)
             {
@@ -1148,7 +1215,7 @@ namespace Discord.WebSocket
 
                                             after = SocketMessage.Create(this, State, author, channel, data);
                                         }
-                                        var cacheableBefore = new Cacheable<IMessage, ulong>(before, data.Id, isCached, async () => await channel.GetMessageAsync(data.Id));
+                                        var cacheableBefore = new Cacheable<IMessage, ulong>(before, data.Id, isCached, async () => await channel.GetMessageAsync(data.Id).ConfigureAwait(false));
 
                                         await TimedInvokeAsync(_messageUpdatedEvent, nameof(MessageUpdated), cacheableBefore, after, channel).ConfigureAwait(false);
                                     }
@@ -1175,7 +1242,7 @@ namespace Discord.WebSocket
 
                                         var msg = SocketChannelHelper.RemoveMessage(channel, this, data.Id);
                                         bool isCached = msg != null;
-                                        var cacheable = new Cacheable<IMessage, ulong>(msg, data.Id, isCached, async () => await channel.GetMessageAsync(data.Id));
+                                        var cacheable = new Cacheable<IMessage, ulong>(msg, data.Id, isCached, async () => await channel.GetMessageAsync(data.Id).ConfigureAwait(false));
 
                                         await TimedInvokeAsync(_messageDeletedEvent, nameof(MessageDeleted), cacheable, channel).ConfigureAwait(false);
                                     }
@@ -1195,9 +1262,9 @@ namespace Discord.WebSocket
                                     {
                                         var cachedMsg = channel.GetCachedMessage(data.MessageId) as SocketUserMessage;
                                         bool isCached = cachedMsg != null;
-                                        var user = await channel.GetUserAsync(data.UserId, CacheMode.CacheOnly);
+                                        var user = await channel.GetUserAsync(data.UserId, CacheMode.CacheOnly).ConfigureAwait(false);
                                         var reaction = SocketReaction.Create(data, channel, cachedMsg, Optional.Create(user));
-                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => await channel.GetMessageAsync(data.MessageId) as IUserMessage);
+                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => await channel.GetMessageAsync(data.MessageId).ConfigureAwait(false) as IUserMessage);
 
                                         cachedMsg?.AddReaction(reaction);
 
@@ -1219,9 +1286,9 @@ namespace Discord.WebSocket
                                     {
                                         var cachedMsg = channel.GetCachedMessage(data.MessageId) as SocketUserMessage;
                                         bool isCached = cachedMsg != null;
-                                        var user = await channel.GetUserAsync(data.UserId, CacheMode.CacheOnly);
+                                        var user = await channel.GetUserAsync(data.UserId, CacheMode.CacheOnly).ConfigureAwait(false);
                                         var reaction = SocketReaction.Create(data, channel, cachedMsg, Optional.Create(user));
-                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => await channel.GetMessageAsync(data.MessageId) as IUserMessage);
+                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => await channel.GetMessageAsync(data.MessageId).ConfigureAwait(false) as IUserMessage);
 
                                         cachedMsg?.RemoveReaction(reaction);
 
@@ -1243,7 +1310,7 @@ namespace Discord.WebSocket
                                     {
                                         var cachedMsg = channel.GetCachedMessage(data.MessageId) as SocketUserMessage;
                                         bool isCached = cachedMsg != null;
-                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => await channel.GetMessageAsync(data.MessageId) as IUserMessage);
+                                        var cacheable = new Cacheable<IUserMessage, ulong>(cachedMsg, data.MessageId, isCached, async () => (await channel.GetMessageAsync(data.MessageId).ConfigureAwait(false)) as IUserMessage);
 
                                         cachedMsg?.ClearReactions();
 
@@ -1274,7 +1341,7 @@ namespace Discord.WebSocket
                                         {
                                             var msg = SocketChannelHelper.RemoveMessage(channel, this, id);
                                             bool isCached = msg != null;
-                                            var cacheable = new Cacheable<IMessage, ulong>(msg, id, isCached, async () => await channel.GetMessageAsync(id));
+                                            var cacheable = new Cacheable<IMessage, ulong>(msg, id, isCached, async () => await channel.GetMessageAsync(id).ConfigureAwait(false));
                                             await TimedInvokeAsync(_messageDeletedEvent, nameof(MessageDeleted), cacheable, channel).ConfigureAwait(false);
                                         }
                                     }
@@ -1634,6 +1701,7 @@ namespace Discord.WebSocket
             return guild;
         }
 
+        /// <exception cref="InvalidOperationException">Unexpected channel type is created.</exception>
         internal ISocketPrivateChannel AddPrivateChannel(API.Channel model, ClientState state)
         {
             var channel = SocketChannel.CreatePrivate(this, state, model);
@@ -1806,43 +1874,59 @@ namespace Discord.WebSocket
         internal int GetAudioId() => _nextAudioId++;
 
         //IDiscordClient
+        /// <inheritdoc />
         async Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options)
             => await GetApplicationInfoAsync().ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IChannel> IDiscordClient.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IChannel>(GetChannel(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IPrivateChannel>> IDiscordClient.GetPrivateChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IPrivateChannel>>(PrivateChannels);
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IDMChannel>> IDiscordClient.GetDMChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IDMChannel>>(DMChannels);
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGroupChannel>> IDiscordClient.GetGroupChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGroupChannel>>(GroupChannels);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IConnection>> IDiscordClient.GetConnectionsAsync(RequestOptions options)
             => await GetConnectionsAsync().ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IInvite> IDiscordClient.GetInviteAsync(string inviteId, RequestOptions options)
             => await GetInviteAsync(inviteId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IGuild> IDiscordClient.GetGuildAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuild>(GetGuild(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuild>> IDiscordClient.GetGuildsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuild>>(Guilds);
+        /// <inheritdoc />
         async Task<IGuild> IDiscordClient.CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon, RequestOptions options)
             => await CreateGuildAsync(name, region, jpegIcon).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         Task<IUser> IDiscordClient.GetUserAsync(string username, string discriminator, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(username, discriminator));
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IVoiceRegion>> IDiscordClient.GetVoiceRegionsAsync(RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IVoiceRegion>>(VoiceRegions);
+        /// <inheritdoc />
         Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => Task.FromResult<IVoiceRegion>(GetVoiceRegion(id));
 
+        /// <inheritdoc />
         async Task IDiscordClient.StartAsync()
             => await StartAsync().ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IDiscordClient.StopAsync()
             => await StopAsync().ConfigureAwait(false);
     }
diff --git a/src/Discord.Net.WebSocket/DiscordSocketConfig.cs b/src/Discord.Net.WebSocket/DiscordSocketConfig.cs
index 3f9c18863..3ac2a81a0 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketConfig.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketConfig.cs
@@ -1,41 +1,72 @@
-using Discord.Net.Udp;
+using Discord.Net.Udp;
 using Discord.Net.WebSockets;
 using Discord.Rest;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a configuration class for <see cref="DiscordSocketClient"/>.
+    /// </summary>
     public class DiscordSocketConfig : DiscordRestConfig
     {
+        /// <summary>
+        ///     Gets or sets the encoding gateway should use.
+        /// </summary>
         public const string GatewayEncoding = "json";
 
-        /// <summary> Gets or sets the websocket host to connect to. If null, the client will use the /gateway endpoint. </summary>
+        /// <summary>
+        ///     Gets or sets the WebSocket host to connect to. If <c>null</c>, the client will use the
+        ///     /gateway endpoint.
+        /// </summary>
         public string GatewayHost { get; set; } = null;
 
-        /// <summary> Gets or sets the time, in milliseconds, to wait for a connection to complete before aborting. </summary>
+        /// <summary>
+        ///     Gets or sets the time, in milliseconds, to wait for a connection to complete before aborting.
+        /// </summary>
         public int ConnectionTimeout { get; set; } = 30000;
 
-        /// <summary> Gets or sets the id for this shard. Must be less than TotalShards. </summary>
+        /// <summary>
+        ///     Gets or sets the ID for this shard. Must be less than <see cref="TotalShards"/>.
+        /// </summary>
         public int? ShardId { get; set; } = null;
-        /// <summary> Gets or sets the total number of shards for this application. </summary>
+        /// <summary>
+        ///     Gets or sets the total number of shards for this application.
+        /// </summary>
         public int? TotalShards { get; set; } = null;
 
-        /// <summary> Gets or sets the number of messages per channel that should be kept in cache. Setting this to zero disables the message cache entirely. </summary>
+        /// <summary>
+        ///     Gets or sets the number of messages per channel that should be kept in cache. Setting this to zero
+        ///     disables the message cache entirely.
+        /// </summary>
         public int MessageCacheSize { get; set; } = 0;
-        /// <summary> 
-        /// Gets or sets the max number of users a guild may have for offline users to be included in the READY packet. Max is 250.
+        /// <summary>
+        ///     Gets or sets the max number of users a guild may have for offline users to be included in the READY
+        ///     packet. Max is 250.
         /// </summary>
         public int LargeThreshold { get; set; } = 250;
 
-        /// <summary> Gets or sets the provider used to generate new websocket connections. </summary>
+        /// <summary>
+        ///     Gets or sets the provider used to generate new WebSocket connections.
+        /// </summary>
         public WebSocketProvider WebSocketProvider { get; set; }
-        /// <summary> Gets or sets the provider used to generate new udp sockets. </summary>
+        /// <summary>
+        ///     Gets or sets the provider used to generate new UDP sockets.
+        /// </summary>
         public UdpSocketProvider UdpSocketProvider { get; set; }
 
-        /// <summary> Gets or sets whether or not all users should be downloaded as guilds come available. </summary>
+        /// <summary>
+        ///     Gets or sets whether or not all users should be downloaded as guilds come available.
+        /// </summary>
         public bool AlwaysDownloadUsers { get; set; } = false;
-        /// <summary> Gets or sets the timeout for event handlers, in milliseconds, after which a warning will be logged. Null disables this check. </summary>
+        /// <summary>
+        ///     Gets or sets the timeout for event handlers, in milliseconds, after which a warning will be logged. Null
+        ///     disables this check.
+        /// </summary>
         public int? HandlerTimeout { get; set; } = 3000;
 
+        /// <summary>
+        ///     Initializes a default configuration.
+        /// </summary>
         public DiscordSocketConfig()
         {
             WebSocketProvider = DefaultWebSocketProvider.Instance;
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/ISocketAudioChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/ISocketAudioChannel.cs
index 7056a4df5..3cb978abf 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/ISocketAudioChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/ISocketAudioChannel.cs
@@ -1,5 +1,8 @@
-namespace Discord.WebSocket
+namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a generic WebSocket-based audio channel.
+    /// </summary>
     public interface ISocketAudioChannel : IAudioChannel
     {
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/ISocketMessageChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/ISocketMessageChannel.cs
index 5fef7e4cd..9f04239ad 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/ISocketMessageChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/ISocketMessageChannel.cs
@@ -5,27 +5,120 @@ using System.Threading.Tasks;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a generic WebSocket-based channel that can send and receive messages.
+    /// </summary>
     public interface ISocketMessageChannel : IMessageChannel
     {
-        /// <summary> Gets all messages in this channel's cache. </summary>
+        /// <summary>
+        ///     Gets all messages in this channel's cache.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of WebSocket-based messages.
+        /// </returns>
         IReadOnlyCollection<SocketMessage> CachedMessages { get; }
 
-        /// <summary> Sends a message to this message channel. </summary>
+        /// <summary>
+        ///     Sends a message to this message channel.
+        /// </summary>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Determines whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/>embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>.
+        ///     </note>
+        /// </remarks>
+        /// <param name="filePath">The file path of the file.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich" /> <see cref="Embed" /> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendFileAsync(string filePath, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
-
-        /// <summary> Sends a file to this text channel, with an optional caption. </summary>
+        /// <summary>
+        ///     Sends a file to this message channel with an optional caption.
+        /// </summary>
+        /// <remarks>
+        ///     This method sends a file as if you are uploading an attachment directly from your Discord client.
+        ///     <note>
+        ///         If you wish to upload an image and have it embedded in a <see cref="Discord.EmbedType.Rich"/>embed,
+        ///         you may upload the file and refer to the file with "attachment://filename.ext" in the
+        ///         <see cref="Discord.EmbedBuilder.ImageUrl"/>.
+        ///     </note>
+        /// </remarks>
+        /// <param name="stream">The <see cref="Stream" /> of the file to be sent.</param>
+        /// <param name="filename">The name of the attachment.</param>
+        /// <param name="text">The message to be sent.</param>
+        /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param>
+        /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous send operation for delivering the message. The task result
+        ///     contains the sent message.
+        /// </returns>
         new Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets the cached message if one exists.
+        /// </summary>
+        /// <param name="id">The ID of the message.</param>
+        /// <returns>
+        ///     Cached message object; <c>null</c> if it doesn't exist in the cache.
+        /// </returns>
         SocketMessage GetCachedMessage(ulong id);
-        /// <summary> Gets the last N messages from this message channel. </summary>
+        /// <summary>
+        ///     Gets the last N messages from this message channel.
+        /// </summary>
+        /// <param name="limit">The number of messages to get.</param>
+        /// <returns>
+        ///     A read-only collection of WebSocket-based messages.
+        /// </returns>
         IReadOnlyCollection<SocketMessage> GetCachedMessages(int limit = DiscordConfig.MaxMessagesPerBatch);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <param name="fromMessageId">The message ID to start the fetching from.</param>
+        /// <param name="dir">The direction of which the message should be gotten from.</param>
+        /// <param name="limit">The number of messages to get.</param>
+        /// <returns>
+        ///     A read-only collection of WebSocket-based messages.
+        /// </returns>
         IReadOnlyCollection<SocketMessage> GetCachedMessages(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch);
-        /// <summary> Gets a collection of messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <param name="fromMessage">The message to start the fetching from.</param>
+        /// <param name="dir">The direction of which the message should be gotten from.</param>
+        /// <param name="limit">The number of messages to get.</param>
+        /// <returns>
+        ///     A read-only collection of WebSocket-based messages.
+        /// </returns>
         IReadOnlyCollection<SocketMessage> GetCachedMessages(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch);
-        /// <summary> Gets a collection of pinned messages in this channel. </summary>
+        /// <summary>
+        ///     Gets a collection of pinned messages in this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation for retrieving pinned messages in this channel.
+        ///     The task result contains a collection of messages found in the pinned messages.
+        /// </returns>
         new Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/ISocketPrivateChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/ISocketPrivateChannel.cs
index 4e91673dd..08da2237c 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/ISocketPrivateChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/ISocketPrivateChannel.cs
@@ -1,7 +1,10 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a generic WebSocket-based channel that is private to select recipients.
+    /// </summary>
     public interface ISocketPrivateChannel : IPrivateChannel
     {
         new IReadOnlyCollection<SocketUser> Recipients { get; }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
index 74ca02dba..0ae40820c 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
@@ -3,22 +3,31 @@ using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
 using System.Linq;
-using System.Text;
 using System.Threading.Tasks;
-using Discord.Audio;
-using Discord.Rest;
 using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based category channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketCategoryChannel : SocketGuildChannel, ICategoryChannel
     {
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuildUser> Users
             => Guild.Users.Where(x => Permissions.GetValue(
                Permissions.ResolveChannel(Guild, x, this, Permissions.ResolveGuild(Guild, x)),
                ChannelPermission.ViewChannel)).ToImmutableArray();
 
+        /// <summary>
+        ///     Gets the child channels of this category.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of <see cref="SocketGuildChannel" /> whose
+        ///     <see cref="Discord.INestedChannel.CategoryId" /> matches the snowflake identifier of this category
+        ///     channel.
+        /// </returns>
         public IReadOnlyCollection<SocketGuildChannel> Channels
             => Guild.Channels.Where(x => x is INestedChannel nestedChannel && nestedChannel.CategoryId == Id).ToImmutableArray();
 
@@ -34,6 +43,7 @@ namespace Discord.WebSocket
         }
 
         //Users
+        /// <inheritdoc />
         public override SocketGuildUser GetUser(ulong id)
         {
             var user = Guild.GetUser(id);
@@ -51,18 +61,26 @@ namespace Discord.WebSocket
         internal new SocketCategoryChannel Clone() => MemberwiseClone() as SocketCategoryChannel;
 
         // IGuildChannel
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IGuildUser>>(Users).ToAsyncEnumerable();
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
             => throw new NotSupportedException();
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
         Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
             => throw new NotSupportedException();
 
         //IChannel
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IUser>>(Users).ToAsyncEnumerable();
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketChannel.cs
index 502e61d15..13c0c9b4f 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketChannel.cs
@@ -1,4 +1,3 @@
-using Discord.Rest;
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -8,16 +7,27 @@ using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public abstract class SocketChannel : SocketEntity<ulong>, IChannel
     {
+        /// <summary>
+        ///     Gets when the channel is created.
+        /// </summary>
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <summary>
+        ///     Gets a collection of users from the WebSocket cache.
+        /// </summary>
         public IReadOnlyCollection<SocketUser> Users => GetUsersInternal();
 
         internal SocketChannel(DiscordSocketClient discord, ulong id)
             : base(discord, id)
         {
         }
+
+        /// <exception cref="InvalidOperationException">Unexpected channel type is created.</exception>
         internal static ISocketPrivateChannel CreatePrivate(DiscordSocketClient discord, ClientState state, Model model)
         {
             switch (model.Type)
@@ -33,17 +43,28 @@ namespace Discord.WebSocket
         internal abstract void Update(ClientState state, Model model);
 
         //User
+        /// <summary>
+        ///     Gets a generic user from this channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <returns>
+        ///     A generic WebSocket-based user associated with the snowflake identifier.
+        /// </returns>
         public SocketUser GetUser(ulong id) => GetUserInternal(id);
         internal abstract SocketUser GetUserInternal(ulong id);
         internal abstract IReadOnlyCollection<SocketUser> GetUsersInternal();
 
+        private string DebuggerDisplay => $"Unknown ({Id}, Channel)";
         internal SocketChannel Clone() => MemberwiseClone() as SocketChannel;
 
         //IChannel
+        /// <inheritdoc />
         string IChannel.Name => null;
 
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(null); //Overridden
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => AsyncEnumerable.Empty<IReadOnlyCollection<IUser>>(); //Overridden
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketChannelHelper.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketChannelHelper.cs
index ca53315aa..e6339b6d9 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketChannelHelper.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketChannelHelper.cs
@@ -1,4 +1,4 @@
-using Discord.Rest;
+using Discord.Rest;
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -57,7 +57,7 @@ namespace Discord.WebSocket
             else
                 return ImmutableArray.Create<SocketMessage>();
         }
-
+        /// <exception cref="NotSupportedException">Unexpected <see cref="ISocketMessageChannel"/> type.</exception>
         public static void AddMessage(ISocketMessageChannel channel, DiscordSocketClient discord,
             SocketMessage msg)
         {
@@ -66,9 +66,10 @@ namespace Discord.WebSocket
                 case SocketDMChannel dmChannel: dmChannel.AddMessage(msg); break;
                 case SocketGroupChannel groupChannel: groupChannel.AddMessage(msg); break;
                 case SocketTextChannel textChannel: textChannel.AddMessage(msg); break;
-                default: throw new NotSupportedException("Unexpected ISocketMessageChannel type");
+                default: throw new NotSupportedException($"Unexpected {nameof(ISocketMessageChannel)} type.");
             }
         }
+        /// <exception cref="NotSupportedException">Unexpected <see cref="ISocketMessageChannel"/> type.</exception>
         public static SocketMessage RemoveMessage(ISocketMessageChannel channel, DiscordSocketClient discord,
             ulong id)
         {
@@ -77,7 +78,7 @@ namespace Discord.WebSocket
                 case SocketDMChannel dmChannel: return dmChannel.RemoveMessage(id);
                 case SocketGroupChannel groupChannel: return groupChannel.RemoveMessage(id);
                 case SocketTextChannel textChannel: return textChannel.RemoveMessage(id);
-                default: throw new NotSupportedException("Unexpected ISocketMessageChannel type");
+                default: throw new NotSupportedException($"Unexpected {nameof(ISocketMessageChannel)} type.");
             }
         }
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
index 9a8be9703..6b6577167 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketDMChannel.cs
@@ -10,14 +10,25 @@ using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based direct-message channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketDMChannel : SocketChannel, IDMChannel, ISocketPrivateChannel, ISocketMessageChannel
     {
         private readonly MessageCache _messages;
 
-        public SocketUser Recipient { get; private set; }
+        /// <summary>
+        ///     Gets the recipient of the channel.
+        /// </summary>
+        public SocketUser Recipient { get; }
 
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> CachedMessages => _messages?.Messages ?? ImmutableArray.Create<SocketMessage>();
+
+        /// <summary>
+        ///     Gets a collection that is the current logged-in user and the recipient.
+        /// </summary>
         public new IReadOnlyCollection<SocketUser> Users => ImmutableArray.Create(Discord.CurrentUser, Recipient);
 
         internal SocketDMChannel(DiscordSocketClient discord, ulong id, SocketGlobalUser recipient)
@@ -26,7 +37,7 @@ namespace Discord.WebSocket
             Recipient = recipient;
             recipient.GlobalUser.AddRef();
             if (Discord.MessageCacheSize > 0)
-                _messages = new MessageCache(Discord, this);
+                _messages = new MessageCache(Discord);
         }
         internal static SocketDMChannel Create(DiscordSocketClient discord, ClientState state, Model model)
         {
@@ -39,12 +50,22 @@ namespace Discord.WebSocket
             Recipient.Update(state, model.Recipients.Value[0]);
         }
 
+        /// <inheritdoc />
         public Task CloseAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
         //Messages
+        /// <inheritdoc />
         public SocketMessage GetCachedMessage(ulong id)
             => _messages?.Get(id);
+        /// <summary>
+        ///     Gets the message associated with the given <paramref name="id"/>.
+        /// </summary>
+        /// <param name="id">TThe ID of the message.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     The message gotten from either the cache or the download, or <c>null</c> if none is found.
+        /// </returns>
         public async Task<IMessage> GetMessageAsync(ulong id, RequestOptions options = null)
         {
             IMessage msg = _messages?.Get(id);
@@ -52,37 +73,150 @@ namespace Discord.WebSocket
                 msg = await ChannelHelper.GetMessageAsync(this, Discord, id, options).ConfigureAwait(false);
             return msg;
         }
+
+        /// <summary>
+        ///     Gets the last N messages from this message channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/>. The
+        ///     library will attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example downloads 300 messages and gets messages that belong to the user 
+        ///     <c>53905483156684800</c>.
+        ///     <code lang="cs">
+        ///     var messages = await messageChannel.GetMessagesAsync(300).FlattenAsync();
+        ///     var userMessages = messages.Where(x =&gt; x.Author.Id == 53905483156684800);
+        ///     </code>
+        /// </example>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, CacheMode.AllowDownload, options);
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessageId"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to the message identifier <c>442012544660537354</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(442012544660537354, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessageId">The ID of the starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, CacheMode.AllowDownload, options);
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessage"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to a specific message, <c>oldMessage</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(oldMessage, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessage">The starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, CacheMode.AllowDownload, options);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, null, Direction.Before, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessageId, dir, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessage.Id, dir, limit);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
-
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
-
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
@@ -92,6 +226,13 @@ namespace Discord.WebSocket
             => _messages?.Remove(id);
 
         //Users
+        /// <summary>
+        ///     Gets a user in this channel from the provided <paramref name="id"/>.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <returns>
+        ///     A <see cref="SocketUser"/> object that is a recipient of this channel; otherwise <c>null</c>.
+        /// </returns>
         public new SocketUser GetUser(ulong id)
         {
             if (id == Recipient.Id)
@@ -102,24 +243,33 @@ namespace Discord.WebSocket
                 return null;
         }
 
+        /// <summary>
+        ///     Returns the recipient user.
+        /// </summary>
         public override string ToString() => $"@{Recipient}";
         private string DebuggerDisplay => $"@{Recipient} ({Id}, DM)";
         internal new SocketDMChannel Clone() => MemberwiseClone() as SocketDMChannel;
 
         //SocketChannel
+        /// <inheritdoc />
         internal override IReadOnlyCollection<SocketUser> GetUsersInternal() => Users;
+        /// <inheritdoc />
         internal override SocketUser GetUserInternal(ulong id) => GetUser(id);
 
-        //IDMChannel            
+        //IDMChannel
+        /// <inheritdoc />
         IUser IDMChannel.Recipient => Recipient;
 
         //ISocketPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<SocketUser> ISocketPrivateChannel.Recipients => ImmutableArray.Create(Recipient);
 
         //IPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<IUser> IPrivateChannel.Recipients => ImmutableArray.Create<IUser>(Recipient);
 
         //IMessageChannel
+        /// <inheritdoc />
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -127,28 +277,36 @@ namespace Discord.WebSocket
             else
                 return GetCachedMessage(id);
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, mode, options);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
             => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
-        //IChannel        
+        //IChannel
+        /// <inheritdoc />
         string IChannel.Name => $"@{Recipient}";
 
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IUser>>(Users).ToAsyncEnumerable();
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
index 74a1e3725..1fc289f41 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketGroupChannel.cs
@@ -14,6 +14,9 @@ using VoiceStateModel = Discord.API.VoiceState;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based private group channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketGroupChannel : SocketChannel, IGroupChannel, ISocketPrivateChannel, ISocketMessageChannel, ISocketAudioChannel
     {
@@ -23,8 +26,10 @@ namespace Discord.WebSocket
         private string _iconId;
         private ConcurrentDictionary<ulong, SocketGroupUser> _users;
 
+        /// <inheritdoc />
         public string Name { get; private set; }
 
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> CachedMessages => _messages?.Messages ?? ImmutableArray.Create<SocketMessage>();
         public new IReadOnlyCollection<SocketGroupUser> Users => _users.ToReadOnlyCollection();
         public IReadOnlyCollection<SocketGroupUser> Recipients
@@ -34,7 +39,7 @@ namespace Discord.WebSocket
             : base(discord, id)
         {
             if (Discord.MessageCacheSize > 0)
-                _messages = new MessageCache(Discord, this);
+                _messages = new MessageCache(Discord);
             _voiceStates = new ConcurrentDictionary<ulong, SocketVoiceState>(ConcurrentHashSet.DefaultConcurrencyLevel, 5);
             _users = new ConcurrentDictionary<ulong, SocketGroupUser>(ConcurrentHashSet.DefaultConcurrencyLevel, 5);
         }
@@ -62,15 +67,18 @@ namespace Discord.WebSocket
             _users = users;
         }
 
+        /// <inheritdoc />
         public Task LeaveAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
+        /// <exception cref="NotSupportedException">Voice is not yet supported for group channels.</exception>
         public Task<IAudioClient> ConnectAsync()
         {
             throw new NotSupportedException("Voice is not yet supported for group channels.");
         }
 
         //Messages
+        /// <inheritdoc />
         public SocketMessage GetCachedMessage(ulong id)
             => _messages?.Get(id);
         public async Task<IMessage> GetMessageAsync(ulong id, RequestOptions options = null)
@@ -86,31 +94,42 @@ namespace Discord.WebSocket
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, CacheMode.AllowDownload, options);
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, CacheMode.AllowDownload, options);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, null, Direction.Before, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessageId, dir, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessage.Id, dir, limit);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
-
+        /// <inheritdoc />
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
@@ -120,6 +139,13 @@ namespace Discord.WebSocket
             => _messages?.Remove(id);
 
         //Users
+        /// <summary>
+        ///     Gets a user from this group.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <returns>
+        ///     A WebSocket-based group user associated with the snowflake identifier.
+        /// </returns>
         public new SocketGroupUser GetUser(ulong id)
         {
             if (_users.TryGetValue(id, out SocketGroupUser user))
@@ -169,21 +195,29 @@ namespace Discord.WebSocket
             return null;
         }
 
+        /// <summary>
+        ///     Returns the name of the group.
+        /// </summary>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id}, Group)";
         internal new SocketGroupChannel Clone() => MemberwiseClone() as SocketGroupChannel;
 
         //SocketChannel
+        /// <inheritdoc />
         internal override IReadOnlyCollection<SocketUser> GetUsersInternal() => Users;
+        /// <inheritdoc />
         internal override SocketUser GetUserInternal(ulong id) => GetUser(id);
 
         //ISocketPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<SocketUser> ISocketPrivateChannel.Recipients => Recipients;
 
         //IPrivateChannel
+        /// <inheritdoc />
         IReadOnlyCollection<IUser> IPrivateChannel.Recipients => Recipients;
 
         //IMessageChannel
+        /// <inheritdoc />
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -191,32 +225,40 @@ namespace Discord.WebSocket
             else
                 return GetCachedMessage(id);
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, mode, options);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
             => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
-
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
         //IAudioChannel
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Connecting to a group channel is not supported.</exception>
         Task<IAudioClient> IAudioChannel.ConnectAsync(bool selfDeaf, bool selfMute, bool external) { throw new NotSupportedException(); }
         Task IAudioChannel.DisconnectAsync() { throw new NotSupportedException(); }
 
         //IChannel        
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id));
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IUser>>(Users).ToAsyncEnumerable();
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
index bfcffa35f..bf1b2260b 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
@@ -9,16 +9,34 @@ using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based guild channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketGuildChannel : SocketChannel, IGuildChannel
     {
         private ImmutableArray<Overwrite> _overwrites;
 
+        /// <summary>
+        ///     Gets the guild associated with this channel.
+        /// </summary>
+        /// <returns>
+        ///     A guild object that this channel belongs to.
+        /// </returns>
         public SocketGuild Guild { get; }
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public int Position { get; private set; }        
 
+        /// <inheritdoc />
         public IReadOnlyCollection<Overwrite> PermissionOverwrites => _overwrites;
+        /// <summary>
+        ///     Gets a collection of users that are able to view the channel.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of users that can access the channel (i.e. the users seen in the user list).
+        /// </returns>
         public new virtual IReadOnlyCollection<SocketGuildUser> Users => ImmutableArray.Create<SocketGuildUser>();
 
         internal SocketGuildChannel(DiscordSocketClient discord, ulong id, SocketGuild guild)
@@ -41,6 +59,7 @@ namespace Discord.WebSocket
                     return new SocketGuildChannel(guild.Discord, model.Id, guild);
             }
         }
+        /// <inheritdoc />
         internal override void Update(ClientState state, Model model)
         {
             Name = model.Name.Value;
@@ -53,11 +72,20 @@ namespace Discord.WebSocket
             _overwrites = newOverwrites.ToImmutable();
         }
 
+        /// <inheritdoc />
         public Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null)
             => ChannelHelper.ModifyAsync(this, Discord, func, options);
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => ChannelHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the permission overwrite for a specific user.
+        /// </summary>
+        /// <param name="user">The user to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted user; <c>null</c> if none is set.
+        /// </returns>
         public OverwritePermissions? GetPermissionOverwrite(IUser user)
         {
             for (int i = 0; i < _overwrites.Length; i++)
@@ -67,6 +95,13 @@ namespace Discord.WebSocket
             }
             return null;
         }
+        /// <summary>
+        ///     Gets the permission overwrite for a specific role.
+        /// </summary>
+        /// <param name="role">The role to get the overwrite from.</param>
+        /// <returns>
+        ///     An overwrite object for the targeted role; <c>null</c> if none is set.
+        /// </returns>
         public OverwritePermissions? GetPermissionOverwrite(IRole role)
         {
             for (int i = 0; i < _overwrites.Length; i++)
@@ -76,16 +111,44 @@ namespace Discord.WebSocket
             }
             return null;
         }
-        public async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions perms, RequestOptions options = null)
+
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given user.
+        /// </summary>
+        /// <param name="user">The user to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
+        public async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null)
         {
-            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, perms, options).ConfigureAwait(false);
-            _overwrites = _overwrites.Add(new Overwrite(user.Id, PermissionTarget.User, new OverwritePermissions(perms.AllowValue, perms.DenyValue)));
+            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, permissions, options).ConfigureAwait(false);
+            _overwrites = _overwrites.Add(new Overwrite(user.Id, PermissionTarget.User, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
         }
-        public async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions perms, RequestOptions options = null)
+
+        /// <summary>
+        ///     Adds or updates the permission overwrite for the given role.
+        /// </summary>
+        /// <param name="role">The role to add the overwrite to.</param>
+        /// <param name="permissions">The overwrite to add to the role.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous permission operation for adding the specified permissions to the channel.
+        /// </returns>
+        public async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null)
         {
-            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, perms, options).ConfigureAwait(false);
-            _overwrites = _overwrites.Add(new Overwrite(role.Id, PermissionTarget.Role, new OverwritePermissions(perms.AllowValue, perms.DenyValue)));
+            await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, permissions, options).ConfigureAwait(false);
+            _overwrites = _overwrites.Add(new Overwrite(role.Id, PermissionTarget.Role, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
         }
+        /// <summary>
+        ///     Removes the permission overwrite for the given user, if one exists.
+        /// </summary>
+        /// <param name="user">The user to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         public async Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null)
         {
             await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, user, options).ConfigureAwait(false);
@@ -99,6 +162,14 @@ namespace Discord.WebSocket
                 }
             }
         }
+        /// <summary>
+        ///     Removes the permission overwrite for the given role, if one exists.
+        /// </summary>
+        /// <param name="role">The role to remove the overwrite from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task representing the asynchronous operation for removing the specified permissions from the channel.
+        /// </returns>
         public async Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null)
         {
             await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, role, options).ConfigureAwait(false);
@@ -113,50 +184,93 @@ namespace Discord.WebSocket
             }
         }
 
+        /// <summary>
+        ///     Returns a collection of all invites to this channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of invite metadata that are created for this channel.
+        /// </returns>
         public async Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
             => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
+        /// <summary>
+        ///     Creates a new invite to this channel.
+        /// </summary>
+        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
+        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
+        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
+        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
+        ///     metadata object containing information for the created invite.
+        /// </returns>
         public async Task<RestInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
             => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
 
         public new virtual SocketGuildUser GetUser(ulong id) => null;
 
+        /// <summary>
+        ///     Gets the name of the channel.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="SocketGuildChannel.Name"/>.
+        /// </returns>
         public override string ToString() => Name;
+        private string DebuggerDisplay => $"{Name} ({Id}, Guild)";
         internal new SocketGuildChannel Clone() => MemberwiseClone() as SocketGuildChannel;
 
         //SocketChannel
+        /// <inheritdoc />
         internal override IReadOnlyCollection<SocketUser> GetUsersInternal() => Users;
+        /// <inheritdoc />
         internal override SocketUser GetUserInternal(ulong id) => GetUser(id);
 
         //IGuildChannel
+        /// <inheritdoc />
         IGuild IGuildChannel.Guild => Guild;
+        /// <inheritdoc />
         ulong IGuildChannel.GuildId => Guild.Id;
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
             => await GetInvitesAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
             => await CreateInviteAsync(maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IRole role)
             => GetPermissionOverwrite(role);
+        /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IUser user)
             => GetPermissionOverwrite(user);
+        /// <inheritdoc />
         async Task IGuildChannel.AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options)
             => await AddPermissionOverwriteAsync(role, permissions, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options)
             => await AddPermissionOverwriteAsync(user, permissions, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.RemovePermissionOverwriteAsync(IRole role, RequestOptions options)
             => await RemovePermissionOverwriteAsync(role, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task IGuildChannel.RemovePermissionOverwriteAsync(IUser user, RequestOptions options)
             => await RemovePermissionOverwriteAsync(user, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IGuildUser>>(Users).ToAsyncEnumerable();
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
 
         //IChannel
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IUser>>(Users).ToAsyncEnumerable(); //Overridden in Text/Voice
+        /// <inheritdoc />
         Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IUser>(GetUser(id)); //Overridden in Text/Voice
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
index 2e9cd90be..8faf1c6eb 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
@@ -10,22 +10,37 @@ using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based channel in a guild that can send and receive messages.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketTextChannel : SocketGuildChannel, ITextChannel, ISocketMessageChannel
     {
         private readonly MessageCache _messages;
 
+        /// <inheritdoc />
         public string Topic { get; private set; }
         public int SlowModeInterval { get; private set; }
+        /// <inheritdoc />
         public ulong? CategoryId { get; private set; }
+        /// <summary>
+        ///     Gets the parent (category) of this channel in the guild's channel list.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="ICategoryChannel"/> representing the parent of this channel; <c>null</c> if none is set.
+        /// </returns>
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
 
         private bool _nsfw;
+        /// <inheritdoc />
         public bool IsNsfw => _nsfw;
 
+        /// <inheritdoc />
         public string Mention => MentionUtils.MentionChannel(Id);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> CachedMessages => _messages?.Messages ?? ImmutableArray.Create<SocketMessage>();
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuildUser> Users
             => Guild.Users.Where(x => Permissions.GetValue(
                 Permissions.ResolveChannel(Guild, x, this, Permissions.ResolveGuild(Guild, x)),
@@ -35,7 +50,7 @@ namespace Discord.WebSocket
             : base(discord, id, guild)
         {
             if (Discord.MessageCacheSize > 0)
-                _messages = new MessageCache(Discord, this);
+                _messages = new MessageCache(Discord);
         }
         internal new static SocketTextChannel Create(SocketGuild guild, ClientState state, Model model)
         {
@@ -52,12 +67,23 @@ namespace Discord.WebSocket
             _nsfw = model.Nsfw.GetValueOrDefault();
         }
 
+        /// <inheritdoc />
         public Task ModifyAsync(Action<TextChannelProperties> func, RequestOptions options = null)
             => ChannelHelper.ModifyAsync(this, Discord, func, options);
 
         //Messages
+        /// <inheritdoc />
         public SocketMessage GetCachedMessage(ulong id)
             => _messages?.Get(id);
+        /// <summary>
+        ///     Gets a message from this message channel.
+        /// </summary>
+        /// <param name="id">The snowflake identifier of the message.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents an asynchronous get operation for retrieving the message. The task result contains
+        ///     the retrieved message; <c>null</c> if no message is found with the specified identifier.
+        /// </returns>
         public async Task<IMessage> GetMessageAsync(ulong id, RequestOptions options = null)
         {
             IMessage msg = _messages?.Get(id);
@@ -65,42 +91,159 @@ namespace Discord.WebSocket
                 msg = await ChannelHelper.GetMessageAsync(this, Discord, id, options).ConfigureAwait(false);
             return msg;
         }
+        /// <summary>
+        ///     Gets the last N messages from this message channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/>. The
+        ///     library will attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example downloads 300 messages and gets messages that belong to the user 
+        ///     <c>53905483156684800</c>.
+        ///     <code lang="cs">
+        ///     var messages = await messageChannel.GetMessagesAsync(300).FlattenAsync();
+        ///     var userMessages = messages.Where(x =&gt; x.Author.Id == 53905483156684800);
+        ///     </code>
+        /// </example>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
+
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, CacheMode.AllowDownload, options);
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessageId"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to the message identifier <c>442012544660537354</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(442012544660537354, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessageId">The ID of the starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, CacheMode.AllowDownload, options);
+        /// <summary>
+        ///     Gets a collection of messages in this channel.
+        /// </summary>
+        /// <remarks>
+        ///     <note type="important">
+        ///         The returned collection is an asynchronous enumerable object; one must call 
+        ///         <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
+        ///         collection.
+        ///     </note>
+        ///     <note type="warning">
+        ///         Do not fetch too many messages at once! This may cause unwanted preemptive rate limit or even actual
+        ///         rate limit, causing your bot to freeze!
+        ///     </note>
+        ///     This method will attempt to fetch the number of messages specified under <paramref name="limit"/> around
+        ///     the message <paramref name="fromMessage"/> depending on the <paramref name="dir"/>. The library will
+        ///     attempt to split up the requests according to your <paramref name="limit"/> and 
+        ///     <see cref="DiscordConfig.MaxMessagesPerBatch"/>. In other words, should the user request 500 messages,
+        ///     and the <see cref="Discord.DiscordConfig.MaxMessagesPerBatch"/> constant is <c>100</c>, the request will
+        ///     be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
+        ///     of flattening.
+        /// </remarks>
+        /// <example>
+        ///     The following example gets 5 message prior to a specific message, <c>oldMessage</c>.
+        ///     <code lang="cs">
+        ///     var messages = await channel.GetMessagesAsync(oldMessage, Direction.Before, 5).FlattenAsync();
+        ///     </code>
+        /// </example>
+        /// <param name="fromMessage">The starting message to get the messages from.</param>
+        /// <param name="dir">The direction of the messages to be gotten from.</param>
+        /// <param name="limit">The numbers of message to be gotten from.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     Paged collection of messages.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, CacheMode.AllowDownload, options);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, null, Direction.Before, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessageId, dir, limit);
+        /// <inheritdoc />
         public IReadOnlyCollection<SocketMessage> GetCachedMessages(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
             => SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessage.Id, dir, limit);
+        /// <inheritdoc />
         public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
             => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
             => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
 
+        /// <inheritdoc />
         public Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null)
             => ChannelHelper.DeleteMessagesAsync(this, Discord, messages.Select(x => x.Id), options);
+        /// <inheritdoc />
         public Task DeleteMessagesAsync(IEnumerable<ulong> messageIds, RequestOptions options = null)
             => ChannelHelper.DeleteMessagesAsync(this, Discord, messageIds, options);
 
+        /// <inheritdoc />
         public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
+        /// <inheritdoc />
         public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
             => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
 
+        /// <inheritdoc />
         public Task TriggerTypingAsync(RequestOptions options = null)
             => ChannelHelper.TriggerTypingAsync(this, Discord, options);
+        /// <inheritdoc />
         public IDisposable EnterTypingState(RequestOptions options = null)
             => ChannelHelper.EnterTypingState(this, Discord, options);
 
@@ -110,6 +253,7 @@ namespace Discord.WebSocket
             => _messages?.Remove(id);
 
         //Users
+        /// <inheritdoc />
         public override SocketGuildUser GetUser(ulong id)
         {
             var user = Guild.GetUser(id);
@@ -124,10 +268,37 @@ namespace Discord.WebSocket
         }
 
         //Webhooks
+        /// <summary>
+        ///     Creates a webhook in this text channel.
+        /// </summary>
+        /// <param name="name">The name of the webhook.</param>
+        /// <param name="avatar">The avatar of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     webhook.
+        /// </returns>
         public Task<RestWebhook> CreateWebhookAsync(string name, Stream avatar = null, RequestOptions options = null)
             => ChannelHelper.CreateWebhookAsync(this, Discord, name, avatar, options);
+        /// <summary>
+        ///     Gets a webhook available in this text channel.
+        /// </summary>
+        /// <param name="id">The identifier of the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a webhook associated
+        ///     with the identifier; <c>null</c> if the webhook is not found.
+        /// </returns>
         public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
             => ChannelHelper.GetWebhookAsync(this, Discord, id, options);
+        /// <summary>
+        ///     Gets the webhooks available in this text channel.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks that is available in this channel.
+        /// </returns>
         public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
             => ChannelHelper.GetWebhooksAsync(this, Discord, options);
 
@@ -135,20 +306,26 @@ namespace Discord.WebSocket
         internal new SocketTextChannel Clone() => MemberwiseClone() as SocketTextChannel;
 
         //ITextChannel
+        /// <inheritdoc />
         async Task<IWebhook> ITextChannel.CreateWebhookAsync(string name, Stream avatar, RequestOptions options)
-            => await CreateWebhookAsync(name, avatar, options);
+            => await CreateWebhookAsync(name, avatar, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IWebhook> ITextChannel.GetWebhookAsync(ulong id, RequestOptions options)
-            => await GetWebhookAsync(id, options);
+            => await GetWebhookAsync(id, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IWebhook>> ITextChannel.GetWebhooksAsync(RequestOptions options)
-            => await GetWebhooksAsync(options);
+            => await GetWebhooksAsync(options).ConfigureAwait(false);
 
         //IGuildChannel
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IGuildUser>>(Users).ToAsyncEnumerable();
 
         //IMessageChannel
+        /// <inheritdoc />
         async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
         {
             if (mode == CacheMode.AllowDownload)
@@ -156,26 +333,31 @@ namespace Discord.WebSocket
             else
                 return GetCachedMessage(id);
         }
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, mode, options);
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, mode, options);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
             => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(filePath, text, isTTS, embed, options).ConfigureAwait(false);
-
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
             => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-        IDisposable IMessageChannel.EnterTypingState(RequestOptions options)
-            => EnterTypingState(options);
 
         // INestedChannel
+        /// <inheritdoc />
         Task<ICategoryChannel> INestedChannel.GetCategoryAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult(Category);
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
index 8e6e09a9f..07977e5e0 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
@@ -10,15 +10,28 @@ using Model = Discord.API.Channel;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based voice channel in a guild.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketVoiceChannel : SocketGuildChannel, IVoiceChannel, ISocketAudioChannel
     {
+        /// <inheritdoc />
         public int Bitrate { get; private set; }
+        /// <inheritdoc />
         public int? UserLimit { get; private set; }
+        /// <inheritdoc />
         public ulong? CategoryId { get; private set; }
+        /// <summary>
+        ///     Gets the parent (category) channel of this channel.
+        /// </summary>
+        /// <returns>
+        ///     A category channel representing the parent of this channel; <c>null</c> if none is set.
+        /// </returns>
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
 
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuildUser> Users
             => Guild.Users.Where(x => x.VoiceChannel?.Id == Id).ToImmutableArray();
 
@@ -32,6 +45,7 @@ namespace Discord.WebSocket
             entity.Update(state, model);
             return entity;
         }
+        /// <inheritdoc />
         internal override void Update(ClientState state, Model model)
         {
             base.Update(state, model);
@@ -40,17 +54,21 @@ namespace Discord.WebSocket
             UserLimit = model.UserLimit.Value != 0 ? model.UserLimit.Value : (int?)null;
         }
 
+        /// <inheritdoc />
         public Task ModifyAsync(Action<VoiceChannelProperties> func, RequestOptions options = null)
             => ChannelHelper.ModifyAsync(this, Discord, func, options);
 
+        /// <inheritdoc />
         public async Task<IAudioClient> ConnectAsync(bool selfDeaf = false, bool selfMute = false, bool external = false)
         {
             return await Guild.ConnectAudioAsync(Id, selfDeaf, selfMute, external).ConfigureAwait(false);
         }
 
+        /// <inheritdoc />
         public async Task DisconnectAsync()
             => await Guild.DisconnectAudioAsync();
 
+        /// <inheritdoc />
         public override SocketGuildUser GetUser(ulong id)
         {
             var user = Guild.GetUser(id);
@@ -63,12 +81,15 @@ namespace Discord.WebSocket
         internal new SocketVoiceChannel Clone() => MemberwiseClone() as SocketVoiceChannel;
 
         //IGuildChannel
+        /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
+        /// <inheritdoc />
         IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
             => ImmutableArray.Create<IReadOnlyCollection<IGuildUser>>(Users).ToAsyncEnumerable();
 
         // INestedChannel
+        /// <inheritdoc />
         Task<ICategoryChannel> INestedChannel.GetCategoryAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult(Category);
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index 78ea4004a..06b048872 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -21,6 +21,10 @@ using VoiceStateModel = Discord.API.VoiceState;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based guild object.
+    /// </summary>
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketGuild : SocketEntity<ulong>, IGuild
     {
         private readonly SemaphoreSlim _audioLock;
@@ -34,38 +38,96 @@ namespace Discord.WebSocket
         private ImmutableArray<string> _features;
         private AudioClient _audioClient;
 
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public int AFKTimeout { get; private set; }
+        /// <inheritdoc />
         public bool IsEmbeddable { get; private set; }
+        /// <inheritdoc />
         public VerificationLevel VerificationLevel { get; private set; }
+        /// <inheritdoc />
         public MfaLevel MfaLevel { get; private set; }
+        /// <inheritdoc />
         public DefaultMessageNotifications DefaultMessageNotifications { get; private set; }
+        /// <summary>
+        ///     Gets the number of members.
+        /// </summary>
+        /// <remarks>
+        ///     This property retrieves the number of members returned by Discord.
+        ///     <note type="tip">
+        ///     <para>
+        ///         Due to how this property is returned by Discord instead of relying on the WebSocket cache, the
+        ///         number here is the most accurate in terms of counting the number of users within this guild.
+        ///     </para>
+        ///     <para>
+        ///         Use this instead of enumerating the count of the 
+        ///         <see cref="Discord.WebSocket.SocketGuild.Users" /> collection, as you may see discrepancy
+        ///         between that and this property.
+        ///     </para>
+        ///     </note>
+        /// </remarks>
         public int MemberCount { get; internal set; }
+        /// <summary> Gets the number of members downloaded to the local guild cache. </summary>
         public int DownloadedMemberCount { get; private set; }
         internal bool IsAvailable { get; private set; }
+        /// <summary> Indicates whether the client is connected to this guild. </summary>
         public bool IsConnected { get; internal set; }
 
         internal ulong? AFKChannelId { get; private set; }
         internal ulong? EmbedChannelId { get; private set; }
         internal ulong? SystemChannelId { get; private set; }
+        /// <inheritdoc />
         public ulong OwnerId { get; private set; }
+        /// <summary> Gets the user that owns this guild. </summary>
         public SocketGuildUser Owner => GetUser(OwnerId);
+        /// <inheritdoc />
         public string VoiceRegionId { get; private set; }
+        /// <inheritdoc />
         public string IconId { get; private set; }
+        /// <inheritdoc />
         public string SplashId { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public string IconUrl => CDN.GetGuildIconUrl(Id, IconId);
+        /// <inheritdoc />
         public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId);
+        /// <summary> Indicates whether the client has all the members downloaded to the local guild cache. </summary>
         public bool HasAllMembers => MemberCount == DownloadedMemberCount;// _downloaderPromise.Task.IsCompleted;
+        /// <summary> Indicates whether the guild cache is synced to this guild. </summary>
         public bool IsSynced => _syncPromise.Task.IsCompleted;
         public Task SyncPromise => _syncPromise.Task;
         public Task DownloaderPromise => _downloaderPromise.Task;
+        /// <summary>
+        ///     Gets the <see cref="IAudioClient" /> associated with this guild.
+        /// </summary>
         public IAudioClient AudioClient => _audioClient;
+        /// <summary>
+        ///     Gets the default channel in this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This property retrieves the first viewable text channel for this guild.
+        ///     <note type="warning">
+        ///         This channel does not guarantee the user can send message to it, as it only looks for the first viewable
+        ///         text channel.
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A <see cref="SocketTextChannel"/> representing the first viewable channel that the user has access to.
+        /// </returns>
         public SocketTextChannel DefaultChannel => TextChannels
             .Where(c => CurrentUser.GetPermissions(c).ViewChannel)
             .OrderBy(c => c.Position)
             .FirstOrDefault();
+        /// <summary>
+        ///     Gets the AFK voice channel in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="SocketVoiceChannel" /> that the AFK users will be moved to after they have idled for too
+        ///     long; <c>null</c> if none is set.
+        /// </returns>
         public SocketVoiceChannel AFKChannel
         {
             get
@@ -74,6 +136,12 @@ namespace Discord.WebSocket
                 return id.HasValue ? GetVoiceChannel(id.Value) : null;
             }
         }
+        /// <summary>
+        ///     Gets the embed channel (i.e. the channel set in the guild's widget settings) in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A channel set within the server's widget settings; <c>null</c> if none is set.
+        /// </returns>
         public SocketGuildChannel EmbedChannel
         {
             get
@@ -82,6 +150,12 @@ namespace Discord.WebSocket
                 return id.HasValue ? GetChannel(id.Value) : null;
             }
         }
+        /// <summary>
+        ///     Gets the system channel where randomized welcome messages are sent in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A text channel where randomized welcome messages will be sent to; <c>null</c> if none is set.
+        /// </returns>
         public SocketTextChannel SystemChannel
         {
             get
@@ -90,14 +164,47 @@ namespace Discord.WebSocket
                 return id.HasValue ? GetTextChannel(id.Value) : null;
             }
         }
+        /// <summary>
+        ///     Gets a collection of all text channels in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of message channels found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketTextChannel> TextChannels
             => Channels.OfType<SocketTextChannel>().ToImmutableArray();
+        /// <summary>
+        ///     Gets a collection of all voice channels in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of voice channels found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketVoiceChannel> VoiceChannels
             => Channels.OfType<SocketVoiceChannel>().ToImmutableArray();
+        /// <summary>
+        ///     Gets a collection of all category channels in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of category channels found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketCategoryChannel> CategoryChannels
             => Channels.OfType<SocketCategoryChannel>().ToImmutableArray();
+        /// <summary>
+        ///     Gets the current logged-in user.
+        /// </summary>
         public SocketGuildUser CurrentUser => _members.TryGetValue(Discord.CurrentUser.Id, out SocketGuildUser member) ? member : null;
+        /// <summary>
+        ///     Gets the built-in role containing all users in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A role object that represents an <c>@everyone</c> role in this guild.
+        /// </returns>
         public SocketRole EveryoneRole => GetRole(Id);
+        /// <summary>
+        ///     Gets a collection of all channels in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of generic channels found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketGuildChannel> Channels
         {
             get
@@ -107,9 +214,38 @@ namespace Discord.WebSocket
                 return channels.Select(x => state.GetChannel(x) as SocketGuildChannel).Where(x => x != null).ToReadOnlyCollection(channels);
             }
         }
+        /// <inheritdoc />
         public IReadOnlyCollection<GuildEmote> Emotes => _emotes;
+        /// <inheritdoc />
         public IReadOnlyCollection<string> Features => _features;
+        /// <summary>
+        ///     Gets a collection of users in this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This property retrieves all users found within this guild.
+        ///     <note type="warning">
+        ///         <para>
+        ///             This property may not always return all the members for large guilds (i.e. guilds containing
+        ///             100+ users). If you are simply looking to get the number of users present in this guild,
+        ///             consider using <see cref="MemberCount"/> instead.
+        ///         </para>
+        ///         <para>
+        ///             Otherwise, you may need to enable <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/> to fetch
+        ///             the full user list upon startup, or use <see cref="DownloadUsersAsync"/> to manually download
+        ///             the users.
+        ///         </para>
+        ///     </note>
+        /// </remarks>
+        /// <returns>
+        ///     A collection of guild users found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketGuildUser> Users => _members.ToReadOnlyCollection();
+        /// <summary>
+        ///     Gets a collection of all roles in this guild.
+        /// </summary>
+        /// <returns>
+        ///     A read-only collection of roles found within this guild.
+        /// </returns>
         public IReadOnlyCollection<SocketRole> Roles => _roles.ToReadOnlyCollection();
 
         internal SocketGuild(DiscordSocketClient client, ulong id)
@@ -270,40 +406,87 @@ namespace Discord.WebSocket
         }
 
         //General
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => GuildHelper.DeleteAsync(this, Discord, options);
 
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null)
             => GuildHelper.ModifyAsync(this, Discord, func, options);
+
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null)
             => GuildHelper.ModifyEmbedAsync(this, Discord, func, options);
+        /// <inheritdoc />
         public Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null)
             => GuildHelper.ReorderChannelsAsync(this, Discord, args, options);
+        /// <inheritdoc />
         public Task ReorderRolesAsync(IEnumerable<ReorderRoleProperties> args, RequestOptions options = null)
             => GuildHelper.ReorderRolesAsync(this, Discord, args, options);
 
+        /// <inheritdoc />
         public Task LeaveAsync(RequestOptions options = null)
             => GuildHelper.LeaveAsync(this, Discord, options);
 
         //Bans
+        /// <summary>
+        ///     Gets a collection of all users banned in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     ban objects that this guild currently possesses, with each object containing the user banned and reason
+        ///     behind the ban.
+        /// </returns>
         public Task<IReadOnlyCollection<RestBan>> GetBansAsync(RequestOptions options = null)
             => GuildHelper.GetBansAsync(this, Discord, options);
+        /// <summary>
+        ///     Gets a ban object for a banned user.
+        /// </summary>
+        /// <param name="user">The banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
+        /// </returns>
         public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null)
             => GuildHelper.GetBanAsync(this, Discord, user.Id, options);
+        /// <summary>
+        ///     Gets a ban object for a banned user.
+        /// </summary>
+        /// <param name="userId">The snowflake identifier for the banned user.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a ban object, which
+        ///     contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found.
+        /// </returns>
         public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null)
             => GuildHelper.GetBanAsync(this, Discord, userId, options);
 
+        /// <inheritdoc />
         public Task AddBanAsync(IUser user, int pruneDays = 0, string reason = null, RequestOptions options = null)
             => GuildHelper.AddBanAsync(this, Discord, user.Id, pruneDays, reason, options);
+        /// <inheritdoc />
         public Task AddBanAsync(ulong userId, int pruneDays = 0, string reason = null, RequestOptions options = null)
             => GuildHelper.AddBanAsync(this, Discord, userId, pruneDays, reason, options);
 
+        /// <inheritdoc />
         public Task RemoveBanAsync(IUser user, RequestOptions options = null)
             => GuildHelper.RemoveBanAsync(this, Discord, user.Id, options);
+        /// <inheritdoc />
         public Task RemoveBanAsync(ulong userId, RequestOptions options = null)
             => GuildHelper.RemoveBanAsync(this, Discord, userId, options);
 
         //Channels
+        /// <summary>
+        ///     Gets a channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the channel.</param>
+        /// <returns>
+        ///     A generic channel associated with the specified <paramref name="id" />; <c>null</c> if none is found.
+        /// </returns>
         public SocketGuildChannel GetChannel(ulong id)
         {
             var channel = Discord.State.GetChannel(id) as SocketGuildChannel;
@@ -311,14 +494,73 @@ namespace Discord.WebSocket
                 return channel;
             return null;
         }
+        /// <summary>
+        ///     Gets a text channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the text channel.</param>
+        /// <returns>
+        ///     A text channel associated with the specified <paramref name="id" />; <c>null</c> if none is found.
+        /// </returns>
         public SocketTextChannel GetTextChannel(ulong id)
             => GetChannel(id) as SocketTextChannel;
+        /// <summary>
+        ///     Gets a voice channel in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the voice channel.</param>
+        /// <returns>
+        ///     A voice channel associated with the specified <paramref name="id" />; <c>null</c> if none is found.
+        /// </returns>
         public SocketVoiceChannel GetVoiceChannel(ulong id)
             => GetChannel(id) as SocketVoiceChannel;
+
+        /// <summary>
+        ///     Creates a new text channel in this guild.
+        /// </summary>
+        /// <example>
+        ///     The following example creates a new text channel under an existing category named <c>Wumpus</c> with a set topic.
+        ///     <code lang="cs">
+        ///     var categories = await guild.GetCategoriesAsync();
+        ///     var targetCategory = categories.FirstOrDefault(x => x.Name == "wumpus");
+        ///     if (targetCategory == null) return;
+        ///     await Context.Guild.CreateTextChannelAsync(name, x =>
+        ///     {
+        ///         x.CategoryId = targetCategory.Id;
+        ///         x.Topic = $"This channel was created at {DateTimeOffset.UtcNow} by {user}.";
+        ///     });
+        ///     </code>
+        /// </example>
+        /// <param name="name">The new name for the text channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     text channel.
+        /// </returns>
         public Task<RestTextChannel> CreateTextChannelAsync(string name, Action<TextChannelProperties> func = null, RequestOptions options = null)
             => GuildHelper.CreateTextChannelAsync(this, Discord, name, options, func);
+        /// <summary>
+        ///     Creates a new voice channel in this guild.
+        /// </summary>
+        /// <param name="name">The new name for the voice channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     voice channel.
+        /// </returns>
         public Task<RestVoiceChannel> CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func = null, RequestOptions options = null)
             => GuildHelper.CreateVoiceChannelAsync(this, Discord, name, options, func);
+        /// <summary>
+        ///     Creates a new channel category in this guild.
+        /// </summary>
+        /// <param name="name">The new name for the category.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     category channel.
+        /// </returns>
         public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, RequestOptions options = null)
             => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options);
 
@@ -343,6 +585,14 @@ namespace Discord.WebSocket
             => GuildHelper.CreateIntegrationAsync(this, Discord, id, type, options);
 
         //Invites
+        /// <summary>
+        ///     Gets a collection of all invites in this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     invite metadata, each representing information for an invite found within this guild.
+        /// </returns>
         public Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
             => GuildHelper.GetInvitesAsync(this, Discord, options);
         /// <summary>
@@ -350,18 +600,40 @@ namespace Discord.WebSocket
         /// </summary>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
-        ///     A partial metadata of the vanity invite found within this guild.
+        ///     A task that represents the asynchronous get operation. The task result contains the partial metadata of
+        ///     the vanity invite found within this guild; <c>null</c> if none is found.
         /// </returns>
         public Task<RestInviteMetadata> GetVanityInviteAsync(RequestOptions options = null)
             => GuildHelper.GetVanityInviteAsync(this, Discord, options);
 
         //Roles
+        /// <summary>
+        ///     Gets a role in this guild.
+        /// </summary>
+        /// <param name="id">The snowflake identifier for the role.</param>
+        /// <returns>
+        ///     A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public SocketRole GetRole(ulong id)
         {
             if (_roles.TryGetValue(id, out SocketRole value))
                 return value;
             return null;
         }
+
+        /// <summary>
+        ///     Creates a new role with the provided name.
+        /// </summary>
+        /// <param name="name">The new name for the role.</param>
+        /// <param name="permissions">The guild permission that the role should possess.</param>
+        /// <param name="color">The color of the role.</param>
+        /// <param name="isHoisted">Whether the role is separated from others on the sidebar.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
+        /// <returns>
+        ///     A task that represents the asynchronous creation operation. The task result contains the newly created
+        ///     role.
+        /// </returns>
         public Task<RestRole> CreateRoleAsync(string name, GuildPermissions? permissions = default(GuildPermissions?), Color? color = default(Color?),
             bool isHoisted = false, RequestOptions options = null)
             => GuildHelper.CreateRoleAsync(this, Discord, name, permissions, color, isHoisted, options);
@@ -379,12 +651,27 @@ namespace Discord.WebSocket
         }
 
         //Users
+        /// <summary>
+        ///     Gets a user from this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method retrieves a user found within this guild.
+        ///     <note>
+        ///         This may return <c>null</c> in the WebSocket implementation due to incomplete user collection in
+        ///         large guilds.
+        ///     </note>
+        /// </remarks>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <returns>
+        ///     A guild user associated with the specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public SocketGuildUser GetUser(ulong id)
         {
             if (_members.TryGetValue(id, out SocketGuildUser member))
                 return member;
             return null;
         }
+        /// <inheritdoc />
         public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null)
             => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options);
 
@@ -438,6 +725,7 @@ namespace Discord.WebSocket
             return null;
         }
 
+        /// <inheritdoc />
         public async Task DownloadUsersAsync()
         {
             await Discord.DownloadUsersAsync(new[] { this }).ConfigureAwait(false);
@@ -448,22 +736,53 @@ namespace Discord.WebSocket
         }
 
         //Audit logs
+        /// <summary>
+        ///     Gets the specified number of audit log entries for this guild.
+        /// </summary>
+        /// <param name="limit">The number of audit log entries to fetch.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of the requested audit log entries.
+        /// </returns>
         public IAsyncEnumerable<IReadOnlyCollection<RestAuditLogEntry>> GetAuditLogsAsync(int limit, RequestOptions options = null)
             => GuildHelper.GetAuditLogsAsync(this, Discord, null, limit, options);
 
         //Webhooks
+        /// <summary>
+        ///     Gets a webhook found within this guild.
+        /// </summary>
+        /// <param name="id">The identifier for the webhook.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains the webhook with the
+        ///     specified <paramref name="id"/>; <c>null</c> if none is found.
+        /// </returns>
         public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetWebhookAsync(this, Discord, id, options);
+        /// <summary>
+        ///     Gets a collection of all webhook from this guild.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of webhooks found within the guild.
+        /// </returns>
         public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
             => GuildHelper.GetWebhooksAsync(this, Discord, options);
 
         //Emotes
+        /// <inheritdoc />
         public Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null)
             => GuildHelper.GetEmoteAsync(this, Discord, id, options);
+        /// <inheritdoc />
         public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null)
             => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options);
+        /// <inheritdoc />
+        /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
         public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null)
             => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options);
+        /// <inheritdoc />
         public Task DeleteEmoteAsync(GuildEmote emote, RequestOptions options = null)
             => GuildHelper.DeleteEmoteAsync(this, Discord, emote.Id, options);
 
@@ -576,7 +895,7 @@ namespace Discord.WebSocket
             try
             {
                 var timeoutTask = Task.Delay(15000);
-                if (await Task.WhenAny(promise.Task, timeoutTask) == timeoutTask)
+                if (await Task.WhenAny(promise.Task, timeoutTask).ConfigureAwait(false) == timeoutTask)
                     throw new TimeoutException();
                 return await promise.Task.ConfigureAwait(false);
             }
@@ -650,20 +969,35 @@ namespace Discord.WebSocket
             }
         }
 
+        /// <summary>
+        ///     Gets the name of the guild.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.WebSocket.SocketGuild.Name"/>.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id})";
         internal SocketGuild Clone() => MemberwiseClone() as SocketGuild;
 
         //IGuild
+        /// <inheritdoc />
         ulong? IGuild.AFKChannelId => AFKChannelId;
+        /// <inheritdoc />
         IAudioClient IGuild.AudioClient => null;
+        /// <inheritdoc />
         bool IGuild.Available => true;
+        /// <inheritdoc />
         ulong IGuild.DefaultChannelId => DefaultChannel?.Id ?? 0;
+        /// <inheritdoc />
         ulong? IGuild.EmbedChannelId => EmbedChannelId;
+        /// <inheritdoc />
         ulong? IGuild.SystemChannelId => SystemChannelId;
+        /// <inheritdoc />
         IRole IGuild.EveryoneRole => EveryoneRole;
+        /// <inheritdoc />
         IReadOnlyCollection<IRole> IGuild.Roles => Roles;
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IBan>> IGuild.GetBansAsync(RequestOptions options)
             => await GetBansAsync(options).ConfigureAwait(false);
         /// <inheritdoc/>
@@ -673,60 +1007,84 @@ namespace Discord.WebSocket
         async Task<IBan> IGuild.GetBanAsync(ulong userId, RequestOptions options)
             => await GetBanAsync(userId, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuildChannel>> IGuild.GetChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuildChannel>>(Channels);
+        /// <inheritdoc />
         Task<IGuildChannel> IGuild.GetChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildChannel>(GetChannel(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<ITextChannel>> IGuild.GetTextChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<ITextChannel>>(TextChannels);
+        /// <inheritdoc />
         Task<ITextChannel> IGuild.GetTextChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<ITextChannel>(GetTextChannel(id));
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IVoiceChannel>> IGuild.GetVoiceChannelsAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IVoiceChannel>>(VoiceChannels);
+        /// <inheritdoc />
         Task<IReadOnlyCollection<ICategoryChannel>> IGuild.GetCategoriesAsync(CacheMode mode , RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<ICategoryChannel>>(CategoryChannels);
+        /// <inheritdoc />
         Task<IVoiceChannel> IGuild.GetVoiceChannelAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IVoiceChannel>(GetVoiceChannel(id));
+        /// <inheritdoc />
         Task<IVoiceChannel> IGuild.GetAFKChannelAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IVoiceChannel>(AFKChannel);
+        /// <inheritdoc />
         Task<ITextChannel> IGuild.GetDefaultChannelAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<ITextChannel>(DefaultChannel);
+        /// <inheritdoc />
         Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildChannel>(EmbedChannel);
+        /// <inheritdoc />
         Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<ITextChannel>(SystemChannel);
+        /// <inheritdoc />
         async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options)
             => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IVoiceChannel> IGuild.CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
             => await CreateVoiceChannelAsync(name, func, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
             => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildIntegration>> IGuild.GetIntegrationsAsync(RequestOptions options)
             => await GetIntegrationsAsync(options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IGuildIntegration> IGuild.CreateIntegrationAsync(ulong id, string type, RequestOptions options)
             => await CreateIntegrationAsync(id, type, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IInviteMetadata>> IGuild.GetInvitesAsync(RequestOptions options)
             => await GetInvitesAsync(options).ConfigureAwait(false);
         /// <inheritdoc />
         async Task<IInviteMetadata> IGuild.GetVanityInviteAsync(RequestOptions options)
             => await GetVanityInviteAsync(options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         IRole IGuild.GetRole(ulong id)
             => GetRole(id);
+        /// <inheritdoc />
         async Task<IRole> IGuild.CreateRoleAsync(string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options)
             => await CreateRoleAsync(name, permissions, color, isHoisted, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
         Task<IReadOnlyCollection<IGuildUser>> IGuild.GetUsersAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuildUser>>(Users);
+        /// <inheritdoc />
         Task<IGuildUser> IGuild.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
+        /// <inheritdoc />
         Task<IGuildUser> IGuild.GetCurrentUserAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(CurrentUser);
+        /// <inheritdoc />
         Task<IGuildUser> IGuild.GetOwnerAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(Owner);
 
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IAuditLogEntry>> IGuild.GetAuditLogsAsync(int limit, CacheMode cacheMode, RequestOptions options)
         {
             if (cacheMode == CacheMode.AllowDownload)
@@ -735,9 +1093,11 @@ namespace Discord.WebSocket
                 return ImmutableArray.Create<IAuditLogEntry>();
         }
 
+        /// <inheritdoc />
         async Task<IWebhook> IGuild.GetWebhookAsync(ulong id, RequestOptions options)
-            => await GetWebhookAsync(id, options);
+            => await GetWebhookAsync(id, options).ConfigureAwait(false);
+        /// <inheritdoc />
         async Task<IReadOnlyCollection<IWebhook>> IGuild.GetWebhooksAsync(RequestOptions options)
-            => await GetWebhooksAsync(options);
+            => await GetWebhooksAsync(options).ConfigureAwait(false);
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs b/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
index 6ebd0fa1c..24e46df46 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/MessageCache.cs
@@ -14,7 +14,7 @@ namespace Discord.WebSocket
 
         public IReadOnlyCollection<SocketMessage> Messages => _messages.ToReadOnlyCollection();
 
-        public MessageCache(DiscordSocketClient discord, IChannel channel)
+        public MessageCache(DiscordSocketClient discord)
         {
             _size = discord.MessageCacheSize;
             _messages = new ConcurrentDictionary<ulong, SocketMessage>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(_size * 1.05));
@@ -44,6 +44,8 @@ namespace Discord.WebSocket
                 return result;
             return null;
         }
+
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="limit"/> is less than 0.</exception>
         public IReadOnlyCollection<SocketMessage> GetMany(ulong? fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
         {
             if (limit < 0) throw new ArgumentOutOfRangeException(nameof(limit));
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
index 5442c888a..0767f2ad7 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
@@ -1,4 +1,4 @@
-using Discord.Rest;
+using Discord.Rest;
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
@@ -8,27 +8,80 @@ using Model = Discord.API.Message;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based message.
+    /// </summary>
     public abstract class SocketMessage : SocketEntity<ulong>, IMessage
     {
         private long _timestampTicks;
-        
+
+        /// <summary>
+        ///     Gets the author of this message.
+        /// </summary>
+        /// <returns>
+        ///     A WebSocket-based user object.
+        /// </returns>
         public SocketUser Author { get; }
+        /// <summary>
+        ///     Gets the source channel of the message.
+        /// </summary>
+        /// <returns>
+        ///     A WebSocket-based message channel.
+        /// </returns>
         public ISocketMessageChannel Channel { get; }
+        /// <inheritdoc />
         public MessageSource Source { get; }
 
+        /// <inheritdoc />
         public string Content { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public virtual bool IsTTS => false;
+        /// <inheritdoc />
         public virtual bool IsPinned => false;
+        /// <inheritdoc />
         public virtual DateTimeOffset? EditedTimestamp => null;
+        /// <summary>
+        ///     Returns all attachments included in this message.
+        /// </summary>
+        /// <returns>
+        ///     Collection of attachments.
+        /// </returns>
         public virtual IReadOnlyCollection<Attachment> Attachments => ImmutableArray.Create<Attachment>();
+        /// <summary>
+        ///     Returns all embeds included in this message.
+        /// </summary>
+        /// <returns>
+        ///     Collection of embed objects.
+        /// </returns>
         public virtual IReadOnlyCollection<Embed> Embeds => ImmutableArray.Create<Embed>();
+        /// <summary>
+        ///     Returns the channels mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     Collection of WebSocket-based guild channels.
+        /// </returns>
         public virtual IReadOnlyCollection<SocketGuildChannel> MentionedChannels => ImmutableArray.Create<SocketGuildChannel>();
+        /// <summary>
+        ///     Returns the roles mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     Collection of WebSocket-based roles.
+        /// </returns>
         public virtual IReadOnlyCollection<SocketRole> MentionedRoles => ImmutableArray.Create<SocketRole>();
+        /// <summary>
+        ///     Returns the users mentioned in this message.
+        /// </summary>
+        /// <returns>
+        ///     Collection of WebSocket-based users.
+        /// </returns>
         public virtual IReadOnlyCollection<SocketUser> MentionedUsers => ImmutableArray.Create<SocketUser>();
+        /// <inheritdoc />
         public virtual IReadOnlyCollection<ITag> Tags => ImmutableArray.Create<ITag>();
 
+        /// <inheritdoc />
         public DateTimeOffset Timestamp => DateTimeUtils.FromTicks(_timestampTicks);
 
         internal SocketMessage(DiscordSocketClient discord, ulong id, ISocketMessageChannel channel, SocketUser author, MessageSource source)
@@ -54,20 +107,35 @@ namespace Discord.WebSocket
                 Content = model.Content.Value;
         }
 
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => MessageHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the content of the message.
+        /// </summary>
+        /// <returns>
+        ///     Content of the message.
+        /// </returns>
         public override string ToString() => Content;
         internal SocketMessage Clone() => MemberwiseClone() as SocketMessage;
 
         //IMessage
+        /// <inheritdoc />
         IUser IMessage.Author => Author;
+        /// <inheritdoc />
         IMessageChannel IMessage.Channel => Channel;
+        /// <inheritdoc />
         MessageType IMessage.Type => MessageType.Default;
+        /// <inheritdoc />
         IReadOnlyCollection<IAttachment> IMessage.Attachments => Attachments;
+        /// <inheritdoc />
         IReadOnlyCollection<IEmbed> IMessage.Embeds => Embeds;
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IMessage.MentionedChannelIds => MentionedChannels.Select(x => x.Id).ToImmutableArray();
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IMessage.MentionedRoleIds => MentionedRoles.Select(x => x.Id).ToImmutableArray();
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IMessage.MentionedUserIds => MentionedUsers.Select(x => x.Id).ToImmutableArray();
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketReaction.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketReaction.cs
index e8fa17a35..9c3a5f32b 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketReaction.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketReaction.cs
@@ -1,14 +1,50 @@
-using Model = Discord.API.Gateway.Reaction;
+using Model = Discord.API.Gateway.Reaction;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based reaction object.
+    /// </summary>
     public class SocketReaction : IReaction
     {
+        /// <summary>
+        ///     Gets the ID of the user who added the reaction.
+        /// </summary>
+        /// <returns>
+        ///     A user snowflake identifier associated with the user.
+        /// </returns>
         public ulong UserId { get; }
+        /// <summary>
+        ///     Gets the user who added the reaction if possible.
+        /// </summary>
+        /// <returns>
+        ///     A user object where possible; a value is not always returned.
+        /// </returns>
+        /// <seealso cref="Optional{T}"/>
         public Optional<IUser> User { get; }
+        /// <summary>
+        ///     Gets the ID of the message that has been reacted to.
+        /// </summary>
+        /// <returns>
+        ///     A message snowflake identifier associated with the message.
+        /// </returns>
         public ulong MessageId { get; }
+        /// <summary>
+        ///     Gets the message that has been reacted to if possible.
+        /// </summary>
+        /// <returns>
+        ///     A WebSocket-based message where possible; a value is not always returned.
+        /// </returns>
+        /// <seealso cref="Optional{T}"/>
         public Optional<SocketUserMessage> Message { get; }
+        /// <summary>
+        ///     Gets the channel where the reaction takes place in.
+        /// </summary>
+        /// <returns>
+        ///     A WebSocket-based message channel.
+        /// </returns>
         public ISocketMessageChannel Channel { get; }
+        /// <inheritdoc />
         public IEmote Emote { get; }
 
         internal SocketReaction(ISocketMessageChannel channel, ulong messageId, Optional<SocketUserMessage> message, ulong userId, Optional<IUser> user, IEmote emoji)
@@ -30,6 +66,7 @@ namespace Discord.WebSocket
             return new SocketReaction(channel, model.MessageId, message, model.UserId, user, emote);
         }
 
+        /// <inheritdoc />
         public override bool Equals(object other)
         {
             if (other == null) return false;
@@ -41,6 +78,7 @@ namespace Discord.WebSocket
             return UserId == otherReaction.UserId && MessageId == otherReaction.MessageId && Emote.Equals(otherReaction.Emote);
         }
 
+        /// <inheritdoc />
         public override int GetHashCode()
         {
             unchecked
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketSystemMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketSystemMessage.cs
index e6c67159f..d0ce5025b 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketSystemMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketSystemMessage.cs
@@ -1,11 +1,15 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.Message;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based message sent by the system.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketSystemMessage : SocketMessage, ISystemMessage
     {
+        /// <inheritdoc />
         public MessageType Type { get; private set; }
 
         internal SocketSystemMessage(DiscordSocketClient discord, ulong id, ISocketMessageChannel channel, SocketUser author)
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
index bf817e008..97754da56 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
@@ -9,6 +9,9 @@ using Model = Discord.API.Message;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based message sent by a user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketUserMessage : SocketMessage, IUserMessage
     {
@@ -19,22 +22,32 @@ namespace Discord.WebSocket
         private ImmutableArray<Embed> _embeds;
         private ImmutableArray<ITag> _tags;
         
+        /// <inheritdoc />
         public override bool IsTTS => _isTTS;
+        /// <inheritdoc />
         public override bool IsPinned => _isPinned;
+        /// <inheritdoc />
         public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks);
+        /// <inheritdoc />
         public override IReadOnlyCollection<Attachment> Attachments => _attachments;
+        /// <inheritdoc />
         public override IReadOnlyCollection<Embed> Embeds => _embeds;
+        /// <inheritdoc />
         public override IReadOnlyCollection<ITag> Tags => _tags;
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuildChannel> MentionedChannels => MessageHelper.FilterTagsByValue<SocketGuildChannel>(TagType.ChannelMention, _tags);
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketRole> MentionedRoles => MessageHelper.FilterTagsByValue<SocketRole>(TagType.RoleMention, _tags);
+        /// <inheritdoc />
         public override IReadOnlyCollection<SocketUser> MentionedUsers => MessageHelper.FilterTagsByValue<SocketUser>(TagType.UserMention, _tags);
+        /// <inheritdoc />
         public IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions => _reactions.GroupBy(r => r.Emote).ToDictionary(x => x.Key, x => new ReactionMetadata { ReactionCount = x.Count(), IsMe = x.Any(y => y.UserId == Discord.CurrentUser.Id) });
 
         internal SocketUserMessage(DiscordSocketClient discord, ulong id, ISocketMessageChannel channel, SocketUser author, MessageSource source)
             : base(discord, id, channel, author, source)
         {
         }
-        internal static new SocketUserMessage Create(DiscordSocketClient discord, ClientState state, SocketUser author, ISocketMessageChannel channel, Model model)
+        internal new static SocketUserMessage Create(DiscordSocketClient discord, ClientState state, SocketUser author, ISocketMessageChannel channel, Model model)
         {
             var entity = new SocketUserMessage(discord, model.Id, channel, author, MessageHelper.GetSource(model));
             entity.Update(state, model);
@@ -121,30 +134,40 @@ namespace Discord.WebSocket
             _reactions.Clear();
         }
 
+        /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">Only the author of a message may modify the message.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
         public Task ModifyAsync(Action<MessageProperties> func, RequestOptions options = null)
             => MessageHelper.ModifyAsync(this, Discord, func, options);
 
+        /// <inheritdoc />
         public Task AddReactionAsync(IEmote emote, RequestOptions options = null)
             => MessageHelper.AddReactionAsync(this, emote, Discord, options);
+        /// <inheritdoc />
         public Task RemoveReactionAsync(IEmote emote, IUser user, RequestOptions options = null)
             => MessageHelper.RemoveReactionAsync(this, user, emote, Discord, options);
+        /// <inheritdoc />
         public Task RemoveAllReactionsAsync(RequestOptions options = null)
             => MessageHelper.RemoveAllReactionsAsync(this, Discord, options);
+        /// <inheritdoc />
         public IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IEmote emote, int limit, RequestOptions options = null)
             => MessageHelper.GetReactionUsersAsync(this, emote, limit, Discord, options);
 
+        /// <inheritdoc />
         public Task PinAsync(RequestOptions options = null)
             => MessageHelper.PinAsync(this, Discord, options);
+        /// <inheritdoc />
         public Task UnpinAsync(RequestOptions options = null)
             => MessageHelper.UnpinAsync(this, Discord, options);
 
         public string Resolve(int startIndex, TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name,
             TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name)
             => MentionUtils.Resolve(this, startIndex, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
+        /// <inheritdoc />
         public string Resolve(TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name,
             TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name)
             => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
-
+        
         private string DebuggerDisplay => $"{Author}: {Content} ({Id}{(Attachments.Count > 0 ? $", {Attachments.Count} Attachments" : "")})";
         internal new SocketUserMessage Clone() => MemberwiseClone() as SocketUserMessage;
     }
diff --git a/src/Discord.Net.WebSocket/Entities/Roles/SocketRole.cs b/src/Discord.Net.WebSocket/Entities/Roles/SocketRole.cs
index c366258cc..b5e26ad78 100644
--- a/src/Discord.Net.WebSocket/Entities/Roles/SocketRole.cs
+++ b/src/Discord.Net.WebSocket/Entities/Roles/SocketRole.cs
@@ -1,4 +1,4 @@
-using Discord.Rest;
+using Discord.Rest;
 using System;
 using System.Collections.Generic;  
 using System.Diagnostics;
@@ -8,21 +8,45 @@ using Model = Discord.API.Role;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based role to be given to a guild user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketRole : SocketEntity<ulong>, IRole
     {
+        /// <summary>
+        ///     Gets the guild that owns this role.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="SocketGuild"/> representing the parent guild of this role.
+        /// </returns>
         public SocketGuild Guild { get; }
 
+        /// <inheritdoc />
         public Color Color { get; private set; }
+        /// <inheritdoc />
         public bool IsHoisted { get; private set; }
+        /// <inheritdoc />
         public bool IsManaged { get; private set; }
+        /// <inheritdoc />
         public bool IsMentionable { get; private set; }
+        /// <inheritdoc />
         public string Name { get; private set; }
+        /// <inheritdoc />
         public GuildPermissions Permissions { get; private set; }
+        /// <inheritdoc />
         public int Position { get; private set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <summary>
+        ///     Returns a value that determines if the role is an @everyone role.
+        /// </summary>
+        /// <returns>
+        ///     <c>true</c> if the role is @everyone; otherwise <c>false</c>.
+        /// </returns>
         public bool IsEveryone => Id == Guild.Id;
+        /// <inheritdoc />
         public string Mention => IsEveryone ? "@everyone" : MentionUtils.MentionRole(Id);
         public IEnumerable<SocketGuildUser> Members 
             => Guild.Users.Where(x => x.Roles.Any(r => r.Id == Id));
@@ -49,18 +73,28 @@ namespace Discord.WebSocket
             Permissions = new GuildPermissions(model.Permissions);
         }
 
+        /// <inheritdoc />
         public Task ModifyAsync(Action<RoleProperties> func, RequestOptions options = null)
             => RoleHelper.ModifyAsync(this, Discord, func, options);
+        /// <inheritdoc />
         public Task DeleteAsync(RequestOptions options = null)
             => RoleHelper.DeleteAsync(this, Discord, options);
 
+        /// <summary>
+        ///     Gets the name of the role.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.WebSocket.SocketRole.Name" />.
+        /// </returns>
         public override string ToString() => Name;
         private string DebuggerDisplay => $"{Name} ({Id})";
         internal SocketRole Clone() => MemberwiseClone() as SocketRole;
 
+        /// <inheritdoc />
         public int CompareTo(IRole role) => RoleUtils.Compare(this, role);
 
         //IRole
+        /// <inheritdoc />
         IGuild IRole.Guild => Guild;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/SocketEntity.cs b/src/Discord.Net.WebSocket/Entities/SocketEntity.cs
index c8e14fb6c..f76694e6f 100644
--- a/src/Discord.Net.WebSocket/Entities/SocketEntity.cs
+++ b/src/Discord.Net.WebSocket/Entities/SocketEntity.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 
 namespace Discord.WebSocket
 {
@@ -6,6 +6,7 @@ namespace Discord.WebSocket
         where T : IEquatable<T>
     {
         internal DiscordSocketClient Discord { get; }
+        /// <inheritdoc />
         public T Id { get; }
 
         internal SocketEntity(DiscordSocketClient discord, T id)
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketGlobalUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketGlobalUser.cs
index 3117eb14c..48de7552a 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketGlobalUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketGlobalUser.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using System.Linq;
 using Model = Discord.API.User;
 using PresenceModel = Discord.API.Presence;
@@ -54,7 +54,8 @@ namespace Discord.WebSocket
             Presence = SocketPresence.Create(model);
             DMChannel = state.DMChannels.FirstOrDefault(x => x.Recipient.Id == Id);
         }
-        
+
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Global)";
         internal new SocketGlobalUser Clone() => MemberwiseClone() as SocketGlobalUser;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketGroupUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketGroupUser.cs
index 8d1b360e3..f560aadbb 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketGroupUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketGroupUser.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.User;
 
 namespace Discord.WebSocket
@@ -6,15 +6,28 @@ namespace Discord.WebSocket
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public class SocketGroupUser : SocketUser, IGroupUser
     {
+        /// <summary>
+        ///     Gets the group channel of the user.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="SocketGroupChannel" /> representing the channel of which the user belongs to.
+        /// </returns>
         public SocketGroupChannel Channel { get; }
+        /// <inheritdoc />
         internal override SocketGlobalUser GlobalUser { get; }
 
+        /// <inheritdoc />
         public override bool IsBot { get { return GlobalUser.IsBot; } internal set { GlobalUser.IsBot = value; } }
+        /// <inheritdoc />
         public override string Username { get { return GlobalUser.Username; } internal set { GlobalUser.Username = value; } }
+        /// <inheritdoc />
         public override ushort DiscriminatorValue { get { return GlobalUser.DiscriminatorValue; } internal set { GlobalUser.DiscriminatorValue = value; } }
+        /// <inheritdoc />
         public override string AvatarId { get { return GlobalUser.AvatarId; } internal set { GlobalUser.AvatarId = value; } }
+        /// <inheritdoc />
         internal override SocketPresence Presence { get { return GlobalUser.Presence; } set { GlobalUser.Presence = value; } }
 
+        /// <inheritdoc />
         public override bool IsWebhook => false;
 
         internal SocketGroupUser(SocketGroupChannel channel, SocketGlobalUser globalUser)
@@ -30,15 +43,23 @@ namespace Discord.WebSocket
             return entity;
         }
 
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Group)";
         internal new SocketGroupUser Clone() => MemberwiseClone() as SocketGroupUser;
 
         //IVoiceState
+        /// <inheritdoc />
         bool IVoiceState.IsDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSuppressed => false;
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => null;
+        /// <inheritdoc />
         string IVoiceState.VoiceSessionId => null;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketGuildUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketGuildUser.cs
index 66af20bb6..659a2eeea 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketGuildUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketGuildUser.cs
@@ -1,4 +1,4 @@
-using Discord.Audio;
+using Discord.Audio;
 using Discord.Rest;
 using System;
 using System.Collections.Generic;
@@ -12,6 +12,9 @@ using PresenceModel = Discord.API.Presence;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based guild user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketGuildUser : SocketUser, IGuildUser
     {
@@ -19,33 +22,67 @@ namespace Discord.WebSocket
         private ImmutableArray<ulong> _roleIds;
 
         internal override SocketGlobalUser GlobalUser { get; }
+        /// <summary>
+        ///     Gets the guild the user is in.
+        /// </summary>
         public SocketGuild Guild { get; }
+        /// <inheritdoc />
         public string Nickname { get; private set; }
 
+        /// <inheritdoc />
         public override bool IsBot { get { return GlobalUser.IsBot; } internal set { GlobalUser.IsBot = value; } }
+        /// <inheritdoc />
         public override string Username { get { return GlobalUser.Username; } internal set { GlobalUser.Username = value; } }
+        /// <inheritdoc />
         public override ushort DiscriminatorValue { get { return GlobalUser.DiscriminatorValue; } internal set { GlobalUser.DiscriminatorValue = value; } }
+        /// <inheritdoc />
         public override string AvatarId { get { return GlobalUser.AvatarId; } internal set { GlobalUser.AvatarId = value; } }
+        /// <inheritdoc />
         public GuildPermissions GuildPermissions => new GuildPermissions(Permissions.ResolveGuild(Guild, this));
         internal override SocketPresence Presence { get; set; }
 
+        /// <inheritdoc />
         public override bool IsWebhook => false;
+        /// <inheritdoc />
         public bool IsSelfDeafened => VoiceState?.IsSelfDeafened ?? false;
+        /// <inheritdoc />
         public bool IsSelfMuted => VoiceState?.IsSelfMuted ?? false;
+        /// <inheritdoc />
         public bool IsSuppressed => VoiceState?.IsSuppressed ?? false;
+        /// <inheritdoc />
         public bool IsDeafened => VoiceState?.IsDeafened ?? false;
+        /// <inheritdoc />
         public bool IsMuted => VoiceState?.IsMuted ?? false;
+        /// <inheritdoc />
         public DateTimeOffset? JoinedAt => DateTimeUtils.FromTicks(_joinedAtTicks);
+        /// <summary>
+        ///     Returns a collection of roles that the user possesses.
+        /// </summary>
         public IReadOnlyCollection<SocketRole> Roles 
             => _roleIds.Select(id => Guild.GetRole(id)).Where(x => x != null).ToReadOnlyCollection(() => _roleIds.Length);
+        /// <summary>
+        ///     Returns the voice channel the user is in, or <c>null</c> if none.
+        /// </summary>
         public SocketVoiceChannel VoiceChannel => VoiceState?.VoiceChannel;
+        /// <inheritdoc />
         public string VoiceSessionId => VoiceState?.VoiceSessionId ?? "";
+        /// <summary>
+        ///     Gets the voice connection status of the user if any.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="SocketVoiceState" /> representing the user's voice status; <c>null</c> if the user is not
+        ///     connected to a voice channel.
+        /// </returns>
         public SocketVoiceState? VoiceState => Guild.GetVoiceState(Id);
         public AudioInStream AudioStream => Guild.GetAudioStream(Id);
 
-        /// <summary> The position of the user within the role hierarchy. </summary>
-        /// <remarks> The returned value equal to the position of the highest role the user has, 
-        /// or int.MaxValue if user is the server owner. </remarks>
+        /// <summary>
+        ///     Returns the position of the user within the role hierarchy.
+        /// </summary>
+        /// <remarks>
+        ///     The returned value equal to the position of the highest role the user has, or 
+        ///     <see cref="int.MaxValue"/> if user is the server owner.
+        /// </remarks>
         public int Hierarchy
         {
             get
@@ -119,9 +156,11 @@ namespace Discord.WebSocket
                 roles.Add(roleIds[i]);
             _roleIds = roles.ToImmutable();
         }
-        
+
+        /// <inheritdoc />
         public Task ModifyAsync(Action<GuildUserProperties> func, RequestOptions options = null)
             => UserHelper.ModifyAsync(this, Discord, func, options);
+        /// <inheritdoc />
         public Task KickAsync(string reason = null, RequestOptions options = null)
             => UserHelper.KickAsync(this, Discord, reason, options);
         /// <inheritdoc />
@@ -137,17 +176,23 @@ namespace Discord.WebSocket
         public Task RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null)
             => UserHelper.RemoveRolesAsync(this, Discord, roles, options);
 
+        /// <inheritdoc />
         public ChannelPermissions GetPermissions(IGuildChannel channel)
             => new ChannelPermissions(Permissions.ResolveChannel(Guild, this, channel, GuildPermissions.RawValue));
 
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Guild)";
         internal new SocketGuildUser Clone() => MemberwiseClone() as SocketGuildUser;
 
         //IGuildUser
+        /// <inheritdoc />
         IGuild IGuildUser.Guild => Guild;
+        /// <inheritdoc />
         ulong IGuildUser.GuildId => Guild.Id;
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IGuildUser.RoleIds => _roleIds;
-        
+
         //IVoiceState
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => VoiceChannel;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketPresence.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketPresence.cs
index 7d7ba16ce..4112fd273 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketPresence.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketPresence.cs
@@ -1,13 +1,17 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Model = Discord.API.Presence;
 
 namespace Discord.WebSocket
 {
-    //TODO: C#7 Candidate for record type
+    /// <summary>
+    ///     Represents the WebSocket user's presence status. This may include their online status and their activity.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct SocketPresence : IPresence
     {
+        /// <inheritdoc />
         public UserStatus Status { get; }
+        /// <inheritdoc />
         public IActivity Activity { get; }
 
         internal SocketPresence(UserStatus status, IActivity activity)
@@ -20,6 +24,12 @@ namespace Discord.WebSocket
             return new SocketPresence(model.Status, model.Game?.ToEntity());
         }
 
+        /// <summary>
+        ///     Gets the status of the user.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to <see cref="Discord.WebSocket.SocketPresence.Status" />.
+        /// </returns>
         public override string ToString() => Status.ToString();
         private string DebuggerDisplay => $"{Status}{(Activity != null ? $", {Activity.Name}": "")}";
 
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketSelfUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketSelfUser.cs
index b7c02c2db..ae705109c 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketSelfUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketSelfUser.cs
@@ -1,4 +1,4 @@
-using Discord.Rest;
+using Discord.Rest;
 using System;
 using System.Diagnostics;
 using System.Threading.Tasks;
@@ -6,20 +6,32 @@ using Model = Discord.API.User;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents the logged-in WebSocket-based user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketSelfUser : SocketUser, ISelfUser
     {
+        /// <inheritdoc />
         public string Email { get; private set; }
+        /// <inheritdoc />
         public bool IsVerified { get; private set; }
+        /// <inheritdoc />
         public bool IsMfaEnabled { get; private set; }
         internal override SocketGlobalUser GlobalUser { get; }
 
+        /// <inheritdoc />
         public override bool IsBot { get { return GlobalUser.IsBot; } internal set { GlobalUser.IsBot = value; } }
+        /// <inheritdoc />
         public override string Username { get { return GlobalUser.Username; } internal set { GlobalUser.Username = value; } }
+        /// <inheritdoc />
         public override ushort DiscriminatorValue { get { return GlobalUser.DiscriminatorValue; } internal set { GlobalUser.DiscriminatorValue = value; } }
+        /// <inheritdoc />
         public override string AvatarId { get { return GlobalUser.AvatarId; } internal set { GlobalUser.AvatarId = value; } }
+        /// <inheritdoc />
         internal override SocketPresence Presence { get { return GlobalUser.Presence; } set { GlobalUser.Presence = value; } }
 
+        /// <inheritdoc />
         public override bool IsWebhook => false;
 
         internal SocketSelfUser(DiscordSocketClient discord, SocketGlobalUser globalUser)
@@ -53,10 +65,12 @@ namespace Discord.WebSocket
             }
             return hasGlobalChanges;
         }
-        
+
+        /// <inheritdoc />
         public Task ModifyAsync(Action<SelfUserProperties> func, RequestOptions options = null)
             => UserHelper.ModifyAsync(this, Discord, func, options);
 
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Self)";
         internal new SocketSelfUser Clone() => MemberwiseClone() as SocketSelfUser;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketUnknownUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketUnknownUser.cs
index c7f6cb846..e6ce0137e 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketUnknownUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketUnknownUser.cs
@@ -1,21 +1,35 @@
-using System;
+using System;
 using System.Diagnostics;
 using Model = Discord.API.User;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based user that is yet to be recognized by the client.
+    /// </summary>
+    /// <remarks>
+    ///     A user may not be recognized due to the user missing from the cache or failed to be recognized properly.
+    /// </remarks>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketUnknownUser : SocketUser
     {
+        /// <inheritdoc />
         public override string Username { get; internal set; }
+        /// <inheritdoc />
         public override ushort DiscriminatorValue { get; internal set; }
+        /// <inheritdoc />
         public override string AvatarId { get; internal set; }
+        /// <inheritdoc />
         public override bool IsBot { get; internal set; }
-
+        
+        /// <inheritdoc />
         public override bool IsWebhook => false;
 
         internal override SocketPresence Presence { get { return new SocketPresence(UserStatus.Offline, null); } set { } }
-        internal override SocketGlobalUser GlobalUser { get { throw new NotSupportedException(); } }
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">This field is not supported for an unknown user.</exception>
+        internal override SocketGlobalUser GlobalUser =>
+            throw new NotSupportedException();
 
         internal SocketUnknownUser(DiscordSocketClient discord, ulong id)
             : base(discord, id)
@@ -28,6 +42,7 @@ namespace Discord.WebSocket
             return entity;
         }
 
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Unknown)";
         internal new SocketUnknownUser Clone() => MemberwiseClone() as SocketUnknownUser;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
index 00899d47e..9a101cddb 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
@@ -1,24 +1,39 @@
 using Discord.Rest;
 using System;
+using System.Diagnostics;
 using System.Threading.Tasks;
 using Model = Discord.API.User;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based user.
+    /// </summary>
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public abstract class SocketUser : SocketEntity<ulong>, IUser
     {
+        /// <inheritdoc />
         public abstract bool IsBot { get; internal set; }
+        /// <inheritdoc />
         public abstract string Username { get; internal set; }
+        /// <inheritdoc />
         public abstract ushort DiscriminatorValue { get; internal set; }
+        /// <inheritdoc />
         public abstract string AvatarId { get; internal set; }
+        /// <inheritdoc />
         public abstract bool IsWebhook { get; }
         internal abstract SocketGlobalUser GlobalUser { get; }
         internal abstract SocketPresence Presence { get; set; }
 
+        /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
+        /// <inheritdoc />
         public string Discriminator => DiscriminatorValue.ToString("D4");
+        /// <inheritdoc />
         public string Mention => MentionUtils.MentionUser(Id);
+        /// <inheritdoc />
         public IActivity Activity => Presence.Activity;
+        /// <inheritdoc />
         public UserStatus Status => Presence.Status;
 
         internal SocketUser(DiscordSocketClient discord, ulong id)
@@ -55,15 +70,24 @@ namespace Discord.WebSocket
             return hasChanges;
         }
 
+        /// <inheritdoc />
         public async Task<IDMChannel> GetOrCreateDMChannelAsync(RequestOptions options = null)
-            => GlobalUser.DMChannel ?? await UserHelper.CreateDMChannelAsync(this, Discord, options) as IDMChannel;
+            => GlobalUser.DMChannel ?? await UserHelper.CreateDMChannelAsync(this, Discord, options).ConfigureAwait(false) as IDMChannel;
 
+        /// <inheritdoc />
         public string GetAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128)
             => CDN.GetUserAvatarUrl(Id, AvatarId, size, format);
 
+        /// <inheritdoc />
         public string GetDefaultAvatarUrl()
             => CDN.GetDefaultUserAvatarUrl(DiscriminatorValue);
 
+        /// <summary>
+        ///     Gets the full name of the user (e.g. Example#0001).
+        /// </summary>
+        /// <returns>
+        ///     The full name of the user.
+        /// </returns>
         public override string ToString() => $"{Username}#{Discriminator}";
         private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")})";
         internal SocketUser Clone() => MemberwiseClone() as SocketUser;
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketVoiceState.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketVoiceState.cs
index 480103326..3e5d1c3b7 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketVoiceState.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketVoiceState.cs
@@ -1,13 +1,18 @@
-using System;
+using System;
 using System.Diagnostics;
 using Model = Discord.API.VoiceState;
 
 namespace Discord.WebSocket
 {
-    //TODO: C#7 Candidate for record type
+    /// <summary>
+    ///     Represents a WebSocket user's voice connection status.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct SocketVoiceState : IVoiceState
     {
+        /// <summary>
+        ///     Initializes a default <see cref="SocketVoiceState"/> with everything set to <c>null</c> or <c>false</c>.
+        /// </summary>
         public static readonly SocketVoiceState Default = new SocketVoiceState(null, null, false, false, false, false, false);
 
         [Flags]
@@ -22,14 +27,23 @@ namespace Discord.WebSocket
         }
 
         private readonly Flags _voiceStates;
-        
+
+        /// <summary>
+        ///     Gets the voice channel that the user is currently in; or <c>null</c> if none.
+        /// </summary>
         public SocketVoiceChannel VoiceChannel { get; }
+        /// <inheritdoc />
         public string VoiceSessionId { get; }
 
+        /// <inheritdoc />
         public bool IsMuted => (_voiceStates & Flags.Muted) != 0;
+        /// <inheritdoc />
         public bool IsDeafened => (_voiceStates & Flags.Deafened) != 0;
+        /// <inheritdoc />
         public bool IsSuppressed => (_voiceStates & Flags.Suppressed) != 0;
+        /// <inheritdoc />
         public bool IsSelfMuted => (_voiceStates & Flags.SelfMuted) != 0;
+        /// <inheritdoc />
         public bool IsSelfDeafened => (_voiceStates & Flags.SelfDeafened) != 0;
 
         internal SocketVoiceState(SocketVoiceChannel voiceChannel, string sessionId, bool isSelfMuted, bool isSelfDeafened, bool isMuted, bool isDeafened, bool isSuppressed)
@@ -55,10 +69,17 @@ namespace Discord.WebSocket
             return new SocketVoiceState(voiceChannel, model.SessionId, model.SelfMute, model.SelfDeaf, model.Mute, model.Deaf, model.Suppress);
         }
 
+        /// <summary>
+        ///     Gets the name of this voice channel.
+        /// </summary>
+        /// <returns>
+        ///     A string that resolves to name of this voice channel; otherwise "Unknown".
+        /// </returns>
         public override string ToString() => VoiceChannel?.Name ?? "Unknown";
         private string DebuggerDisplay => $"{VoiceChannel?.Name ?? "Unknown"} ({_voiceStates})";
         internal SocketVoiceState Clone() => this;
 
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => VoiceChannel;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketWebhookUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketWebhookUser.cs
index dd80648d2..3169be682 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketWebhookUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketWebhookUser.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Diagnostics;
@@ -7,21 +7,32 @@ using Model = Discord.API.User;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based webhook user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketWebhookUser : SocketUser, IWebhookUser
     {
+        /// <summary> Gets the guild of this webhook. </summary>
         public SocketGuild Guild { get; }
+        /// <inheritdoc />
         public ulong WebhookId { get; }
 
+        /// <inheritdoc />
         public override string Username { get; internal set; }
+        /// <inheritdoc />
         public override ushort DiscriminatorValue { get; internal set; }
+        /// <inheritdoc />
         public override string AvatarId { get; internal set; }
+        /// <inheritdoc />
         public override bool IsBot { get; internal set; }
 
+        /// <inheritdoc />
         public override bool IsWebhook => true;
 
         internal override SocketPresence Presence { get { return new SocketPresence(UserStatus.Offline, null); } set { } }
-        internal override SocketGlobalUser GlobalUser { get { throw new NotSupportedException(); } }
+        internal override SocketGlobalUser GlobalUser => 
+            throw new NotSupportedException();
 
         internal SocketWebhookUser(SocketGuild guild, ulong id, ulong webhookId)
             : base(guild.Discord, id)
@@ -36,51 +47,70 @@ namespace Discord.WebSocket
             return entity;
         }
 
+        private string DebuggerDisplay => $"{Username}#{Discriminator} ({Id}{(IsBot ? ", Bot" : "")}, Webhook)";
         internal new SocketWebhookUser Clone() => MemberwiseClone() as SocketWebhookUser;
 
 
         //IGuildUser
+        /// <inheritdoc />
         IGuild IGuildUser.Guild => Guild;
+        /// <inheritdoc />
         ulong IGuildUser.GuildId => Guild.Id;
+        /// <inheritdoc />
         IReadOnlyCollection<ulong> IGuildUser.RoleIds => ImmutableArray.Create<ulong>();
+        /// <inheritdoc />
         DateTimeOffset? IGuildUser.JoinedAt => null;
+        /// <inheritdoc />
         string IGuildUser.Nickname => null;
+        /// <inheritdoc />
         GuildPermissions IGuildUser.GuildPermissions => GuildPermissions.Webhook;
 
+        /// <inheritdoc />
         ChannelPermissions IGuildUser.GetPermissions(IGuildChannel channel) => Permissions.ToChannelPerms(channel, GuildPermissions.Webhook.RawValue);
-        Task IGuildUser.KickAsync(string reason, RequestOptions options)
-        {
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Webhook users cannot be kicked.</exception>
+        Task IGuildUser.KickAsync(string reason, RequestOptions options) => 
             throw new NotSupportedException("Webhook users cannot be kicked.");
-        }
-        Task IGuildUser.ModifyAsync(Action<GuildUserProperties> func, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Webhook users cannot be modified.</exception>
+        Task IGuildUser.ModifyAsync(Action<GuildUserProperties> func, RequestOptions options) => 
             throw new NotSupportedException("Webhook users cannot be modified.");
-        }
 
-        Task IGuildUser.AddRoleAsync(IRole role, RequestOptions options)
-        {
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Roles are not supported on webhook users.</exception>
+        Task IGuildUser.AddRoleAsync(IRole role, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Roles are not supported on webhook users.</exception>
+        Task IGuildUser.AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.RemoveRoleAsync(IRole role, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Roles are not supported on webhook users.</exception>
+        Task IGuildUser.RemoveRoleAsync(IRole role, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
-        Task IGuildUser.RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options)
-        {
+
+        /// <inheritdoc />
+        /// <exception cref="NotSupportedException">Roles are not supported on webhook users.</exception>
+        Task IGuildUser.RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options) => 
             throw new NotSupportedException("Roles are not supported on webhook users.");
-        }
 
         //IVoiceState
+        /// <inheritdoc />
         bool IVoiceState.IsDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfDeafened => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSelfMuted => false;
+        /// <inheritdoc />
         bool IVoiceState.IsSuppressed => false;
+        /// <inheritdoc />
         IVoiceChannel IVoiceState.VoiceChannel => null;
+        /// <inheritdoc />
         string IVoiceState.VoiceSessionId => null;
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Voice/SocketVoiceServer.cs b/src/Discord.Net.WebSocket/Entities/Voice/SocketVoiceServer.cs
index 57abf1d03..c5f13b1a9 100644
--- a/src/Discord.Net.WebSocket/Entities/Voice/SocketVoiceServer.cs
+++ b/src/Discord.Net.WebSocket/Entities/Voice/SocketVoiceServer.cs
@@ -2,12 +2,33 @@ using System.Diagnostics;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based voice server.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketVoiceServer
     {
-        public Cacheable<IGuild, ulong> Guild { get; private set; }
-        public string Endpoint { get; private set; }
-        public string Token { get; private set; }
+        /// <summary>
+        ///     Gets the guild associated with the voice server.
+        /// </summary>
+        /// <returns>
+        ///     A cached entity of the guild.
+        /// </returns>
+        public Cacheable<IGuild, ulong> Guild { get; }
+        /// <summary>
+        ///     Gets the endpoint URL of the voice server host.
+        /// </summary>
+        /// <returns>
+        ///     An URL representing the voice server host.
+        /// </returns>
+        public string Endpoint { get; }
+        /// <summary>
+        /// 	Gets the voice connection token.
+        /// </summary>
+        /// <returns>
+        /// 	A voice connection token.
+        /// </returns>
+        public string Token { get; }
 
         internal SocketVoiceServer(Cacheable<IGuild, ulong> guild, string endpoint, string token)
         {
diff --git a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClientProvider.cs b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClientProvider.cs
index 2d66d5900..bc580c410 100644
--- a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClientProvider.cs
+++ b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClientProvider.cs
@@ -7,6 +7,7 @@ namespace Discord.Net.WebSockets
     {
         public static readonly WebSocketProvider Instance = Create();
 
+        /// <exception cref="PlatformNotSupportedException">The default WebSocketProvider is not supported on this platform.</exception>
         public static WebSocketProvider Create(IWebProxy proxy = null)
         {
             return () =>
diff --git a/src/Discord.Net.Webhook/DiscordWebhookClient.cs b/src/Discord.Net.Webhook/DiscordWebhookClient.cs
index 67a5462be..16841e936 100644
--- a/src/Discord.Net.Webhook/DiscordWebhookClient.cs
+++ b/src/Discord.Net.Webhook/DiscordWebhookClient.cs
@@ -7,6 +7,7 @@ using Discord.Rest;
 
 namespace Discord.Webhook
 {
+    /// <summary> A client responsible for connecting as a Webhook. </summary>
     public class DiscordWebhookClient : IDisposable
     {
         public event Func<LogMessage, Task> Log { add { _logEvent.Add(value); } remove { _logEvent.Remove(value); } }
@@ -19,14 +20,14 @@ namespace Discord.Webhook
         internal API.DiscordRestApiClient ApiClient { get; }
         internal LogManager LogManager { get; }
 
-        /// <summary> Creates a new Webhook discord client. </summary>
+        /// <summary> Creates a new Webhook Discord client. </summary>
         public DiscordWebhookClient(IWebhook webhook)
             : this(webhook.Id, webhook.Token, new DiscordRestConfig()) {  }
-        /// <summary> Creates a new Webhook discord client. </summary>
+        /// <summary> Creates a new Webhook Discord client. </summary>
         public DiscordWebhookClient(ulong webhookId, string webhookToken)
             : this(webhookId, webhookToken, new DiscordRestConfig()) { }
 
-        /// <summary> Creates a new Webhook discord client. </summary>
+        /// <summary> Creates a new Webhook Discord client. </summary>
         public DiscordWebhookClient(ulong webhookId, string webhookToken, DiscordRestConfig config)
             : this(config)
         {
@@ -34,7 +35,7 @@ namespace Discord.Webhook
             ApiClient.LoginAsync(TokenType.Webhook, webhookToken).GetAwaiter().GetResult();
             Webhook = WebhookClientHelper.GetWebhookAsync(this, webhookId).GetAwaiter().GetResult();
         }
-        /// <summary> Creates a new Webhook discord client. </summary>
+        /// <summary> Creates a new Webhook Discord client. </summary>
         public DiscordWebhookClient(IWebhook webhook, DiscordRestConfig config)
             : this(config)
         {
@@ -61,18 +62,19 @@ namespace Discord.Webhook
         }
         private static API.DiscordRestApiClient CreateApiClient(DiscordRestConfig config)
             => new API.DiscordRestApiClient(config.RestClientProvider, DiscordRestConfig.UserAgent);
-        
-        /// <summary> Sends a message using to the channel for this webhook. Returns the ID of the created message. </summary>
+        /// <summary> Sends a message using to the channel for this webhook. </summary>
+        /// <returns> Returns the ID of the created message. </returns>
         public Task<ulong> SendMessageAsync(string text = null, bool isTTS = false, IEnumerable<Embed> embeds = null,
             string username = null, string avatarUrl = null, RequestOptions options = null)
             => WebhookClientHelper.SendMessageAsync(this, text, isTTS, embeds, username, avatarUrl, options);
 
-        /// <summary> Send a message to the channel for this webhook with an attachment. Returns the ID of the created message. </summary>
+        /// <summary> Sends a message to the channel for this webhook with an attachment. </summary>
+        /// <returns> Returns the ID of the created message. </returns>
         public Task<ulong> SendFileAsync(string filePath, string text, bool isTTS = false,
             IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, RequestOptions options = null)
             => WebhookClientHelper.SendFileAsync(this, filePath, text, isTTS, embeds, username, avatarUrl, options);
-
-        /// <summary> Send a message to the channel for this webhook with an attachment. Returns the ID of the created message. </summary>
+        /// <summary> Sends a message to the channel for this webhook with an attachment. </summary>
+        /// <returns> Returns the ID of the created message. </returns>
         public Task<ulong> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false,
             IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, RequestOptions options = null)
             => WebhookClientHelper.SendFileAsync(this, stream, filename, text, isTTS, embeds, username, avatarUrl, options);
diff --git a/src/Discord.Net.Webhook/Entities/Webhooks/RestInternalWebhook.cs b/src/Discord.Net.Webhook/Entities/Webhooks/RestInternalWebhook.cs
index cd35d731c..60cb89ee2 100644
--- a/src/Discord.Net.Webhook/Entities/Webhooks/RestInternalWebhook.cs
+++ b/src/Discord.Net.Webhook/Entities/Webhooks/RestInternalWebhook.cs
@@ -49,7 +49,7 @@ namespace Discord.Webhook
 
         public async Task ModifyAsync(Action<WebhookProperties> func, RequestOptions options = null)
         {
-            var model = await WebhookClientHelper.ModifyAsync(_client, func, options);
+            var model = await WebhookClientHelper.ModifyAsync(_client, func, options).ConfigureAwait(false);
             Update(model);
         }
 
diff --git a/src/Discord.Net.Webhook/WebhookClientHelper.cs b/src/Discord.Net.Webhook/WebhookClientHelper.cs
index d3cac9703..a02cb3e2f 100644
--- a/src/Discord.Net.Webhook/WebhookClientHelper.cs
+++ b/src/Discord.Net.Webhook/WebhookClientHelper.cs
@@ -12,11 +12,12 @@ namespace Discord.Webhook
 {
     internal static class WebhookClientHelper
     {
+        /// <exception cref="InvalidOperationException">Could not find a webhook with the supplied credentials.</exception>
         public static async Task<RestInternalWebhook> GetWebhookAsync(DiscordWebhookClient client, ulong webhookId)
         {
-            var model = await client.ApiClient.GetWebhookAsync(webhookId);
+            var model = await client.ApiClient.GetWebhookAsync(webhookId).ConfigureAwait(false);
             if (model == null)
-                throw new InvalidOperationException("Could not find a webhook for the supplied credentials.");
+                throw new InvalidOperationException("Could not find a webhook with the supplied credentials.");
             return RestInternalWebhook.Create(client, model);
         }
         public static async Task<ulong> SendMessageAsync(DiscordWebhookClient client, 
diff --git a/test/Discord.Net.Tests/AnalyzerTests/GuildAccessTests.cs b/test/Discord.Net.Tests/AnalyzerTests/GuildAccessTests.cs
index 073cc1de7..4cb5cefcb 100644
--- a/test/Discord.Net.Tests/AnalyzerTests/GuildAccessTests.cs
+++ b/test/Discord.Net.Tests/AnalyzerTests/GuildAccessTests.cs
@@ -1,8 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
-using System.Linq;
-using System.Threading.Tasks;
+using System;
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Diagnostics;
 using Discord.Analyzers;
diff --git a/test/Discord.Net.Tests/AnalyzerTests/Helpers/DiagnosticVerifier.Helper.cs b/test/Discord.Net.Tests/AnalyzerTests/Helpers/DiagnosticVerifier.Helper.cs
index 7a8eb2e9c..99654f12c 100644
--- a/test/Discord.Net.Tests/AnalyzerTests/Helpers/DiagnosticVerifier.Helper.cs
+++ b/test/Discord.Net.Tests/AnalyzerTests/Helpers/DiagnosticVerifier.Helper.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
@@ -7,7 +7,6 @@ using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
 using Microsoft.CodeAnalysis.Diagnostics;
 using Microsoft.CodeAnalysis.Text;
-using Discord;
 using Discord.Commands;
 
 namespace TestHelper
diff --git a/test/Discord.Net.Tests/AnalyzerTests/Verifiers/DiagnosticVerifier.cs b/test/Discord.Net.Tests/AnalyzerTests/Verifiers/DiagnosticVerifier.cs
index 498e5ef27..3564093f8 100644
--- a/test/Discord.Net.Tests/AnalyzerTests/Verifiers/DiagnosticVerifier.cs
+++ b/test/Discord.Net.Tests/AnalyzerTests/Verifiers/DiagnosticVerifier.cs
@@ -1,8 +1,7 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using Microsoft.CodeAnalysis;
-using Microsoft.CodeAnalysis.CSharp;
 using Microsoft.CodeAnalysis.Diagnostics;
 //using Microsoft.VisualStudio.TestTools.UnitTesting;
 using Xunit;
@@ -104,7 +103,7 @@ namespace TestHelper
         /// <param name="expectedResults">Diagnostic Results that should have appeared in the code</param>
         private static void VerifyDiagnosticResults(IEnumerable<Diagnostic> actualResults, DiagnosticAnalyzer analyzer, params DiagnosticResult[] expectedResults)
         {
-            int expectedCount = expectedResults.Count();
+            int expectedCount = expectedResults.Length;
             int actualCount = actualResults.Count();
 
             if (expectedCount != actualCount)
diff --git a/test/Discord.Net.Tests/Net/HttpMixin.cs b/test/Discord.Net.Tests/Net/HttpMixin.cs
index c4a78ce0b..6cde2776b 100644
--- a/test/Discord.Net.Tests/Net/HttpMixin.cs
+++ b/test/Discord.Net.Tests/Net/HttpMixin.cs
@@ -9,7 +9,6 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
-using System.Linq;
 using System.Net;
 using System.Reactive.Linq;
 using System.Reactive.Subjects;
@@ -142,4 +141,4 @@ namespace Discord.Net
             return stream.WriteAsync(data, start, length).ToObservable();
         }
     }
-}
\ No newline at end of file
+}
diff --git a/test/Discord.Net.Tests/Tests.Channels.cs b/test/Discord.Net.Tests/Tests.Channels.cs
index 46e28b9da..890cacbf1 100644
--- a/test/Discord.Net.Tests/Tests.Channels.cs
+++ b/test/Discord.Net.Tests/Tests.Channels.cs
@@ -1,5 +1,4 @@
 using Discord.Rest;
-using System;
 using System.Linq;
 using System.Threading.Tasks;
 using Xunit;
@@ -171,15 +170,15 @@ namespace Discord
             // 2 categories
             Assert.Equal(2, categories.Length);
 
-            var cat1 = categories.Where(x => x.Name == "cat1").FirstOrDefault();
-            var cat2 = categories.Where(x => x.Name == "cat2").FirstOrDefault();
+            var cat1 = categories.FirstOrDefault(x => x.Name == "cat1");
+            var cat2 = categories.FirstOrDefault(x => x.Name == "cat2");
 
             Assert.NotNull(cat1);
             Assert.NotNull(cat2);
 
             // get text1, text2, ensure they have category id == cat1
-            var text1 = allChannels.Where(x => x.Name == "text1").FirstOrDefault() as RestTextChannel;
-            var text2 = allChannels.Where(x => x.Name == "text2").FirstOrDefault() as RestTextChannel;
+            var text1 = allChannels.FirstOrDefault(x => x.Name == "text1") as RestTextChannel;
+            var text2 = allChannels.FirstOrDefault(x => x.Name == "text2") as RestTextChannel;
 
             Assert.NotNull(text1);
             Assert.NotNull(text2);
@@ -197,8 +196,8 @@ namespace Discord
             Assert.Equal(text2Cat.Name, cat1.Name);
 
             // do the same for the voice channels
-            var voice1 = allChannels.Where(x => x.Name == "voice1").FirstOrDefault() as RestVoiceChannel;
-            var voice3 = allChannels.Where(x => x.Name == "voice3").FirstOrDefault() as RestVoiceChannel;
+            var voice1 = allChannels.FirstOrDefault(x => x.Name == "voice1") as RestVoiceChannel;
+            var voice3 = allChannels.FirstOrDefault(x => x.Name == "voice3") as RestVoiceChannel;
 
             Assert.NotNull(voice1);
             Assert.NotNull(voice3);
diff --git a/test/Discord.Net.Tests/Tests.GuildPermissions.cs b/test/Discord.Net.Tests/Tests.GuildPermissions.cs
index bbd6621b5..f49f431b5 100644
--- a/test/Discord.Net.Tests/Tests.GuildPermissions.cs
+++ b/test/Discord.Net.Tests/Tests.GuildPermissions.cs
@@ -31,11 +31,11 @@ namespace Discord
             copy = GuildPermissions.None.Modify();
             Assert.Equal(GuildPermissions.None.RawValue, copy.RawValue);
 
-            // test modify with no paramters on all permissions
+            // test modify with no parameters on all permissions
             copy = GuildPermissions.All.Modify();
             Assert.Equal(GuildPermissions.All.RawValue, copy.RawValue);
 
-            // test modify with no paramters on webhook permissions
+            // test modify with no parameters on webhook permissions
             copy = GuildPermissions.Webhook.Modify();
             Assert.Equal(GuildPermissions.Webhook.RawValue, copy.RawValue);
 
diff --git a/test/Discord.Net.Tests/Tests.Migrations.cs b/test/Discord.Net.Tests/Tests.Migrations.cs
index 23e55a737..2bd36220a 100644
--- a/test/Discord.Net.Tests/Tests.Migrations.cs
+++ b/test/Discord.Net.Tests/Tests.Migrations.cs
@@ -19,7 +19,7 @@ namespace Discord
                 if (client == null)
                 {
                     client = new DiscordRestClient();
-                    await client.LoginAsync(TokenType.Bot, _config.Token, false).ConfigureAwait(false);
+                    await client.LoginAsync(TokenType.Bot, _config.Token).ConfigureAwait(false);
                     guild = await client.GetGuildAsync(_config.GuildId);
                 }
 
diff --git a/test/Discord.Net.Tests/Tests.Permissions.cs b/test/Discord.Net.Tests/Tests.Permissions.cs
index 2f72f272d..239d0862e 100644
--- a/test/Discord.Net.Tests/Tests.Permissions.cs
+++ b/test/Discord.Net.Tests/Tests.Permissions.cs
@@ -1,4 +1,3 @@
-using System;
 using System.Threading.Tasks;
 using Xunit;
 

From 00717cf4812b0e1388c4fbd3f266f1bfab80d134 Mon Sep 17 00:00:00 2001
From: advorange <advorange@live.com>
Date: Tue, 2 Oct 2018 13:26:35 -0700
Subject: [PATCH 20/59] Implemented GetVoiceRegionsAsync on IGuild. (#1166)

---
 src/Discord.Net.Core/Entities/Guilds/IGuild.cs   | 10 ++++++++++
 .../Entities/Guilds/GuildHelper.cs               |  8 ++++++++
 .../Entities/Guilds/RestGuild.cs                 | 15 +++++++++++++++
 .../Entities/Guilds/SocketGuild.cs               | 16 ++++++++++++++++
 4 files changed, 49 insertions(+)

diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
index 8f9108d95..9b91b9440 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
@@ -467,6 +467,16 @@ namespace Discord
         /// </returns>
         Task<ICategoryChannel> CreateCategoryAsync(string name, RequestOptions options = null);
 
+        /// <summary>
+        ///     Gets a collection of all the voice regions this guild can access.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     voice regions the guild can access.
+        /// </returns>
+        Task<IReadOnlyCollection<IVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null);
+
         Task<IReadOnlyCollection<IGuildIntegration>> GetIntegrationsAsync(RequestOptions options = null);
         Task<IGuildIntegration> CreateIntegrationAsync(ulong id, string type, RequestOptions options = null);
 
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index 823d41a05..b8b66f802 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -192,6 +192,14 @@ namespace Discord.Rest
             return RestCategoryChannel.Create(client, guild, model);
         }
 
+        //Voice Regions
+        public static async Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(IGuild guild, BaseDiscordClient client,
+            RequestOptions options)
+        {
+            var models = await client.ApiClient.GetGuildVoiceRegionsAsync(guild.Id, options).ConfigureAwait(false);
+            return models.Select(x => RestVoiceRegion.Create(client, x)).ToImmutableArray();
+        }
+
         //Integrations
         public static async Task<IReadOnlyCollection<RestGuildIntegration>> GetIntegrationsAsync(IGuild guild, BaseDiscordClient client,
             RequestOptions options)
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index fda9b609d..9c4ecd848 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -443,6 +443,17 @@ namespace Discord.Rest
         public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, RequestOptions options = null)
             => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options);
 
+        /// <summary>
+        ///     Gets a collection of all the voice regions this guild can access.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     voice regions the guild can access.
+        /// </returns>
+        public Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
+            => GuildHelper.GetVoiceRegionsAsync(this, Discord, options);
+
         //Integrations
         public Task<IReadOnlyCollection<RestGuildIntegration>> GetIntegrationsAsync(RequestOptions options = null)
             => GuildHelper.GetIntegrationsAsync(this, Discord, options);
@@ -758,6 +769,10 @@ namespace Discord.Rest
         async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
             => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
+        async Task<IReadOnlyCollection<IVoiceRegion>> IGuild.GetVoiceRegionsAsync(RequestOptions options)
+            => await GetVoiceRegionsAsync(options).ConfigureAwait(false);
+
         /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildIntegration>> IGuild.GetIntegrationsAsync(RequestOptions options)
             => await GetIntegrationsAsync(options).ConfigureAwait(false);
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index 06b048872..b4f87e12a 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -578,6 +578,18 @@ namespace Discord.WebSocket
             return null;
         }
 
+        //Voice Regions
+        /// <summary>
+        ///     Gets a collection of all the voice regions this guild can access.
+        /// </summary>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection of
+        ///     voice regions the guild can access.
+        /// </returns>
+        public Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
+            => GuildHelper.GetVoiceRegionsAsync(this, Discord, options);
+
         //Integrations
         public Task<IReadOnlyCollection<RestGuildIntegration>> GetIntegrationsAsync(RequestOptions options = null)
             => GuildHelper.GetIntegrationsAsync(this, Discord, options);
@@ -1050,6 +1062,10 @@ namespace Discord.WebSocket
         async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
             => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
+        async Task<IReadOnlyCollection<IVoiceRegion>> IGuild.GetVoiceRegionsAsync(RequestOptions options)
+            => await GetVoiceRegionsAsync(options).ConfigureAwait(false);
+
         /// <inheritdoc />
         async Task<IReadOnlyCollection<IGuildIntegration>> IGuild.GetIntegrationsAsync(RequestOptions options)
             => await GetIntegrationsAsync(options).ConfigureAwait(false);

From 8df2c1a1fbc0478f3af6398b705513ad6e8ca20a Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Tue, 9 Oct 2018 19:26:57 -0400
Subject: [PATCH 21/59] fix: don't assume the member will always be included on
 MESSAGE_CREATE (#1167)

* fix: don't assume the member will always be included on MESSAGE_CREATE

This resolves #1153.

Member objects are only included on a message when the user has
transitioned from an offline state to an online state (i think?), so
this change will fall back to the prior behavior, where we just create
an incomplete member object for these states.

* lint: use a ternary in place of an if/else block
---
 src/Discord.Net.WebSocket/DiscordSocketClient.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
index 81538e6e7..3d260d1a6 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
@@ -1158,7 +1158,11 @@ namespace Discord.WebSocket
                                         if (author == null)
                                         {
                                             if (guild != null)
-                                                author = guild.AddOrUpdateUser(data.Member.Value); //per g250k, we can create an entire member now
+                                            {
+                                                author = data.Member.IsSpecified // member isn't always included, but use it when we can
+                                                    ? guild.AddOrUpdateUser(data.Member.Value)
+                                                    : guild.AddOrUpdateUser(data.Author.Value); // user has no guild-specific data
+                                            }
                                             else if (channel is SocketGroupChannel)
                                                 author = (channel as SocketGroupChannel).GetOrAddUser(data.Author.Value);
                                             else

From f3b9f358994b4f6ec3b8c78cd6f1eddaf79888fe Mon Sep 17 00:00:00 2001
From: Rithari <rithari@outlook.com>
Date: Fri, 12 Oct 2018 22:19:03 +0200
Subject: [PATCH 22/59] Add check for bot messages.

Added a check so bot messages do not trigger any commands involuntariy.
---
 docs/guides/commands/samples/intro/command_handler.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/guides/commands/samples/intro/command_handler.cs b/docs/guides/commands/samples/intro/command_handler.cs
index e4531fa41..efb31f9b9 100644
--- a/docs/guides/commands/samples/intro/command_handler.cs
+++ b/docs/guides/commands/samples/intro/command_handler.cs
@@ -35,9 +35,10 @@ public class CommandHandler
         // Create a number to track where the prefix ends and the command begins
         int argPos = 0;
 
-        // Determine if the message is a command based on the prefix
+        // Determine if the message is a command based on the prefix and make sure no bots trigger commands
         if (!(message.HasCharPrefix('!', ref argPos) || 
-            message.HasMentionPrefix(_client.CurrentUser, ref argPos)))
+            message.HasMentionPrefix(_client.CurrentUser, ref argPos)) ||
+            message.Author.IsBot)
             return;
 
         // Create a WebSocket-based command context based on the message
@@ -60,4 +61,4 @@ public class CommandHandler
         // if (!result.IsSuccess)
         // await context.Channel.SendMessageAsync(result.ErrorReason);
     }
-}
\ No newline at end of file
+}

From 96fbb43f770bbd6b98a9b7fda9b7e0109d8738a6 Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Fri, 19 Oct 2018 16:41:27 -0400
Subject: [PATCH 23/59] docs: Update joining_audio.cs (#1176)

---
 docs/guides/voice/samples/joining_audio.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/guides/voice/samples/joining_audio.cs b/docs/guides/voice/samples/joining_audio.cs
index 4cec67540..3abbfb632 100644
--- a/docs/guides/voice/samples/joining_audio.cs
+++ b/docs/guides/voice/samples/joining_audio.cs
@@ -1,4 +1,5 @@
-[Command("join")]
+// The command's Run Mode MUST be set to RunMode.Async, otherwise, being connected to a voice channel will block the gateway thread.
+[Command("join", RunMode = RunMode.Async)] 
 public async Task JoinChannel(IVoiceChannel channel = null)
 {
     // Get the audio channel

From 10f67a8098f124fbf211d584f50699e9127136cd Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Fri, 19 Oct 2018 17:18:59 -0400
Subject: [PATCH 24/59]  feature: consolidate all results into CommandExecuted 
 (#1164)

* feature: consolidate all results into CommandExecuted

This resolves #694.

This is a breaking change!
- changes the signature of CommandExecuted from (CommandInfo, ...) to
(Optional<CommandInfo>, ...), since we are now including Search result
failures in the event (and a command isn't accessible yet).

* lint: remove unfinished thoughts
---
 src/Discord.Net.Commands/CommandService.cs | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/Discord.Net.Commands/CommandService.cs b/src/Discord.Net.Commands/CommandService.cs
index 11f4ce276..432b75f27 100644
--- a/src/Discord.Net.Commands/CommandService.cs
+++ b/src/Discord.Net.Commands/CommandService.cs
@@ -49,8 +49,8 @@ namespace Discord.Commands
         ///         Should the command encounter any of the aforementioned error, this event will not be raised.
         ///     </para>
         /// </remarks>
-        public event Func<CommandInfo, ICommandContext, IResult, Task> CommandExecuted { add { _commandExecutedEvent.Add(value); } remove { _commandExecutedEvent.Remove(value); } }
-        internal readonly AsyncEvent<Func<CommandInfo, ICommandContext, IResult, Task>> _commandExecutedEvent = new AsyncEvent<Func<CommandInfo, ICommandContext, IResult, Task>>();
+        public event Func<Optional<CommandInfo>, ICommandContext, IResult, Task> CommandExecuted { add { _commandExecutedEvent.Add(value); } remove { _commandExecutedEvent.Remove(value); } }
+        internal readonly AsyncEvent<Func<Optional<CommandInfo>, ICommandContext, IResult, Task>> _commandExecutedEvent = new AsyncEvent<Func<Optional<CommandInfo>, ICommandContext, IResult, Task>>();
 
         private readonly SemaphoreSlim _moduleLock;
         private readonly ConcurrentDictionary<Type, ModuleInfo> _typedModuleDefs;
@@ -512,7 +512,11 @@ namespace Discord.Commands
 
             var searchResult = Search(input);
             if (!searchResult.IsSuccess)
+            {
+                await _commandExecutedEvent.InvokeAsync(Optional.Create<CommandInfo>(), context, searchResult).ConfigureAwait(false);
                 return searchResult;
+            }
+                
 
             var commands = searchResult.Commands;
             var preconditionResults = new Dictionary<CommandMatch, PreconditionResult>();
@@ -532,6 +536,8 @@ namespace Discord.Commands
                 var bestCandidate = preconditionResults
                     .OrderByDescending(x => x.Key.Command.Priority)
                     .FirstOrDefault(x => !x.Value.IsSuccess);
+
+                await _commandExecutedEvent.InvokeAsync(bestCandidate.Key.Command, context, bestCandidate.Value).ConfigureAwait(false);
                 return bestCandidate.Value;
             }
 
@@ -589,12 +595,17 @@ namespace Discord.Commands
                 //All parses failed, return the one from the highest priority command, using score as a tie breaker
                 var bestMatch = parseResults
                     .FirstOrDefault(x => !x.Value.IsSuccess);
+
+                await _commandExecutedEvent.InvokeAsync(bestMatch.Key.Command, context, bestMatch.Value).ConfigureAwait(false);
                 return bestMatch.Value;
             }
 
             //If we get this far, at least one parse was successful. Execute the most likely overload.
             var chosenOverload = successfulParses[0];
-            return await chosenOverload.Key.ExecuteAsync(context, chosenOverload.Value, services).ConfigureAwait(false);
+            var result = await chosenOverload.Key.ExecuteAsync(context, chosenOverload.Value, services).ConfigureAwait(false);
+            if (!result.IsSuccess) // succesful results raise the event in CommandInfo#ExecuteInternalAsync (have to raise it there b/c deffered execution)
+                await _commandExecutedEvent.InvokeAsync(chosenOverload.Key.Command, context, result);
+            return result;
         }
     }
 }

From d30d12246d5173321c2556cf65d3c69da230cb8c Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Fri, 19 Oct 2018 14:20:41 -0700
Subject: [PATCH 25/59] Update Guild and Message Models (#1165)

* Add ExplicitContentFilter property to Guild

* re-order properties to match order listed on api docs

* re-order SystemChannelId to match api docs

* Implement ApplicationId in Guild model

* Add ExplicitContentFilter property to Guild

* re-order properties to match order listed on api docs

* re-order SystemChannelId to match api docs

* Implement ApplicationId in Guild model

* Improve xmldoc for IGuild ExplicitContentFilter

* Update xmldoc

* docs "Id" -> "ID"

* rename Test.GuildPermissions to a more general Test.Guilds

* Add ExplicitContentFilter to GuildProperties

* Add a test for ExplicitContentFilterLevel modification behavior

* Implement ModifyAsync behavior

* simplify ExplicitContentFilter test

* Add RestGuild ApplicationId inheritdoc

* Implement message Activity and Application model update

* RestMessage Application and Activity implementation

* add ToString to MessageApplication

* Add IconUrl property to MessageApplication

* clean up whitespace

* another excessive whitespace removal
---
 .../Guilds/ExplicitContentFilterLevel.cs      | 13 ++++++
 .../Entities/Guilds/GuildProperties.cs        |  4 ++
 .../Entities/Guilds/IGuild.cs                 | 14 ++++++
 .../Entities/Messages/IMessage.cs             | 20 +++++++++
 .../Entities/Messages/MessageActivity.cs      | 27 ++++++++++++
 .../Entities/Messages/MessageActivityType.cs  | 16 +++++++
 .../Entities/Messages/MessageApplication.cs   | 43 +++++++++++++++++++
 src/Discord.Net.Rest/API/Common/Guild.cs      | 14 +++---
 src/Discord.Net.Rest/API/Common/Message.cs    |  6 +++
 .../API/Common/MessageActivity.cs             | 17 ++++++++
 .../API/Common/MessageApplication.cs          | 38 ++++++++++++++++
 .../API/Rest/ModifyGuildParams.cs             |  4 +-
 .../Entities/Guilds/GuildHelper.cs            |  6 ++-
 .../Entities/Guilds/RestGuild.cs              |  6 +++
 .../Entities/Messages/RestMessage.cs          | 27 ++++++++++++
 .../Entities/Guilds/SocketGuild.cs            |  6 +++
 .../Entities/Messages/SocketMessage.cs        | 30 +++++++++++++
 ...ts.GuildPermissions.cs => Tests.Guilds.cs} | 19 +++++++-
 18 files changed, 302 insertions(+), 8 deletions(-)
 create mode 100644 src/Discord.Net.Core/Entities/Guilds/ExplicitContentFilterLevel.cs
 create mode 100644 src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
 create mode 100644 src/Discord.Net.Core/Entities/Messages/MessageActivityType.cs
 create mode 100644 src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
 create mode 100644 src/Discord.Net.Rest/API/Common/MessageActivity.cs
 create mode 100644 src/Discord.Net.Rest/API/Common/MessageApplication.cs
 rename test/Discord.Net.Tests/{Tests.GuildPermissions.cs => Tests.Guilds.cs} (94%)

diff --git a/src/Discord.Net.Core/Entities/Guilds/ExplicitContentFilterLevel.cs b/src/Discord.Net.Core/Entities/Guilds/ExplicitContentFilterLevel.cs
new file mode 100644
index 000000000..54c0bdafe
--- /dev/null
+++ b/src/Discord.Net.Core/Entities/Guilds/ExplicitContentFilterLevel.cs
@@ -0,0 +1,13 @@
+namespace Discord
+{
+    public enum ExplicitContentFilterLevel
+    {
+        /// <summary> No messages will be scanned. </summary>
+        Disabled = 0,
+        /// <summary> Scans messages from all guild members that do not have a role. </summary>
+        /// <remarks> Recommented option for servers that use roles for trusted membership. </remarks>
+        MembersWithoutRoles = 1,
+        /// <summary> Scan messages sent by all guild members. </summary>
+        AllMembers = 2
+    }
+}
diff --git a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
index 0ffe8db35..e6d21a463 100644
--- a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
@@ -66,5 +66,9 @@ namespace Discord
         ///     Gets or sets the ID of the owner of this guild.
         /// </summary>
         public Optional<ulong> OwnerId { get; set; }
+        /// <summary>
+        ///     Gets or sets the explicit content filter level of this guild.
+        /// </summary>
+        public Optional<ExplicitContentFilterLevel> ExplicitContentFilter { get; set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
index 9b91b9440..c321cd2e3 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
@@ -53,6 +53,13 @@ namespace Discord
         /// </returns>
         VerificationLevel VerificationLevel { get; }
         /// <summary>
+        ///     Gets the level of content filtering applied to user's content in a Guild.
+        /// </summary>
+        /// <returns>
+        ///     The level of explicit content filtering.
+        /// </returns>
+        ExplicitContentFilterLevel ExplicitContentFilter { get; }
+        /// <summary>
         ///     Gets the ID of this guild's icon.
         /// </summary>
         /// <returns>
@@ -141,6 +148,13 @@ namespace Discord
         /// </returns>
         ulong OwnerId { get; }
         /// <summary>
+        ///     Gets the application ID of the guild creator if it is bot-created.
+        /// </summary>
+        /// <returns>
+        ///     A <see cref="ulong"/> representing the snowflake identifier of the application ID that created this guild, or <c>null</c> if it was not bot-created.
+        /// </returns>
+        ulong? ApplicationId { get; }
+        /// <summary>
         ///     Gets the ID of the region hosting this guild's voice channels.
         /// </summary>
         /// <returns>
diff --git a/src/Discord.Net.Core/Entities/Messages/IMessage.cs b/src/Discord.Net.Core/Entities/Messages/IMessage.cs
index 87754eecd..33e019419 100644
--- a/src/Discord.Net.Core/Entities/Messages/IMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IMessage.cs
@@ -100,5 +100,25 @@ namespace Discord
         ///     A read-only collection of user IDs.
         /// </returns>
         IReadOnlyCollection<ulong> MentionedUserIds { get; }
+        /// <summary>
+        ///     Returns the Activity associated with a message.
+        /// </summary>
+        /// <remarks>
+        ///     Sent with Rich Presence-related chat embeds.
+        /// </remarks>
+        /// <returns>
+        ///     A message's activity, if any is associated.
+        /// </returns>
+        MessageActivity Activity { get; }
+        /// <summary>
+        ///     Returns the Application associated with a messsage.
+        /// </summary>
+        /// <remarks>
+        ///     Sent with Rich-Presence-related chat embeds.
+        /// </remarks>
+        /// <returns>
+        ///     A message's application, if any is associated.
+        /// </returns>
+        MessageApplication Application { get; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs b/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
new file mode 100644
index 000000000..d19e6a8e9
--- /dev/null
+++ b/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord
+{
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
+    public class MessageActivity
+    {
+        /// <summary>
+        ///     Gets the type of activity of this message.
+        /// </summary>
+        public MessageActivityType Type { get; set; }
+        /// <summary>
+        ///     Gets the party ID of this activity, if any.
+        /// </summary>
+        public string PartyId { get; set; }
+
+        private string DebuggerDisplay
+            => $"{Type}{(string.IsNullOrWhiteSpace(PartyId) ? "" : $" {PartyId}")}";
+
+        public override string ToString() => DebuggerDisplay;
+    }
+}
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageActivityType.cs b/src/Discord.Net.Core/Entities/Messages/MessageActivityType.cs
new file mode 100644
index 000000000..68b99a9c1
--- /dev/null
+++ b/src/Discord.Net.Core/Entities/Messages/MessageActivityType.cs
@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord
+{
+    public enum MessageActivityType
+    {
+        Join = 1,
+        Spectate = 2,
+        Listen = 3,
+        JoinRequest = 5
+    }
+}
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs b/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
new file mode 100644
index 000000000..960d1700f
--- /dev/null
+++ b/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
@@ -0,0 +1,43 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord
+{
+    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
+    public class MessageApplication
+    {
+        /// <summary>
+        ///     Gets the snowflake ID of the application.
+        /// </summary>
+        public ulong Id { get; set; }
+        /// <summary>
+        ///     Gets the ID of the embed's image asset.
+        /// </summary>
+        public string CoverImage { get; set; }
+        /// <summary>
+        ///     Gets the application's description.
+        /// </summary>
+        public string Description { get; set; }
+        /// <summary>
+        ///     Gets the ID of the application's icon.
+        /// </summary>
+        public string Icon { get; set; }
+        /// <summary>
+        ///     Gets the Url of the application's icon.
+        /// </summary>
+        public string IconUrl
+            => $"https://cdn.discordapp.com/app-icons/{Id}/{Icon}";
+        /// <summary>
+        ///     Gets the name of the application.
+        /// </summary>
+        public string Name { get; set; }
+        private string DebuggerDisplay
+            => $"{Name} ({Id}): {Description}";
+        public override string ToString()
+            => DebuggerDisplay;
+    }
+}
diff --git a/src/Discord.Net.Rest/API/Common/Guild.cs b/src/Discord.Net.Rest/API/Common/Guild.cs
index 0ca1bc236..a84b55a93 100644
--- a/src/Discord.Net.Rest/API/Common/Guild.cs
+++ b/src/Discord.Net.Rest/API/Common/Guild.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
@@ -25,10 +25,12 @@ namespace Discord.API
         public bool EmbedEnabled { get; set; }
         [JsonProperty("embed_channel_id")]
         public ulong? EmbedChannelId { get; set; }
-        [JsonProperty("system_channel_id")]
-        public ulong? SystemChannelId { get; set; }
         [JsonProperty("verification_level")]
         public VerificationLevel VerificationLevel { get; set; }
+        [JsonProperty("default_message_notifications")]
+        public DefaultMessageNotifications DefaultMessageNotifications { get; set; }
+        [JsonProperty("explicit_content_filter")]
+        public ExplicitContentFilterLevel ExplicitContentFilter { get; set; }
         [JsonProperty("voice_states")]
         public VoiceState[] VoiceStates { get; set; }
         [JsonProperty("roles")]
@@ -39,7 +41,9 @@ namespace Discord.API
         public string[] Features { get; set; }
         [JsonProperty("mfa_level")]
         public MfaLevel MfaLevel { get; set; }
-        [JsonProperty("default_message_notifications")]
-        public DefaultMessageNotifications DefaultMessageNotifications { get; set; }
+        [JsonProperty("application_id")]
+        public ulong? ApplicationId { get; set; }
+        [JsonProperty("system_channel_id")]
+        public ulong? SystemChannelId { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/API/Common/Message.cs b/src/Discord.Net.Rest/API/Common/Message.cs
index 229249ccf..10bdbe568 100644
--- a/src/Discord.Net.Rest/API/Common/Message.cs
+++ b/src/Discord.Net.Rest/API/Common/Message.cs
@@ -44,5 +44,11 @@ namespace Discord.API
         public Optional<bool> Pinned { get; set; }
         [JsonProperty("reactions")]
         public Optional<Reaction[]> Reactions { get; set; }
+        // sent with Rich Presence-related chat embeds
+        [JsonProperty("activity")]
+        public Optional<MessageActivity> Activity { get; set; }
+        // sent with Rich Presence-related chat embeds
+        [JsonProperty("application")]
+        public Optional<MessageApplication> Application { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/API/Common/MessageActivity.cs b/src/Discord.Net.Rest/API/Common/MessageActivity.cs
new file mode 100644
index 000000000..701f6fc03
--- /dev/null
+++ b/src/Discord.Net.Rest/API/Common/MessageActivity.cs
@@ -0,0 +1,17 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord.API
+{
+    public class MessageActivity
+    {
+        [JsonProperty("type")]
+        public Optional<MessageActivityType> Type { get; set; }
+        [JsonProperty("party_id")]
+        public Optional<string> PartyId { get; set; }
+    }
+}
diff --git a/src/Discord.Net.Rest/API/Common/MessageApplication.cs b/src/Discord.Net.Rest/API/Common/MessageApplication.cs
new file mode 100644
index 000000000..7302185ad
--- /dev/null
+++ b/src/Discord.Net.Rest/API/Common/MessageApplication.cs
@@ -0,0 +1,38 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Discord.API
+{
+    public class MessageApplication
+    {
+        /// <summary>
+        ///     Gets the snowflake ID of the application.
+        /// </summary>
+        [JsonProperty("id")]
+        public ulong Id { get; set; }
+        /// <summary>
+        ///     Gets the ID of the embed's image asset.
+        /// </summary>
+        [JsonProperty("cover_image")]
+        public string CoverImage { get; set; }
+        /// <summary>
+        ///     Gets the application's description.
+        /// </summary>
+        [JsonProperty("description")]
+        public string Description { get; set; }
+        /// <summary>
+        ///     Gets the ID of the application's icon.
+        /// </summary>
+        [JsonProperty("icon")]
+        public string Icon { get; set; }
+        /// <summary>
+        ///     Gets the name of the application.
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+    }
+}
diff --git a/src/Discord.Net.Rest/API/Rest/ModifyGuildParams.cs b/src/Discord.Net.Rest/API/Rest/ModifyGuildParams.cs
index 8de10f534..ba70c58d6 100644
--- a/src/Discord.Net.Rest/API/Rest/ModifyGuildParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/ModifyGuildParams.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API.Rest
@@ -28,5 +28,7 @@ namespace Discord.API.Rest
         public Optional<ulong?> AfkChannelId { get; set; }
         [JsonProperty("owner_id")]
         public Optional<ulong> OwnerId { get; set; }
+        [JsonProperty("explicit_content_filter")]
+        public Optional<ExplicitContentFilterLevel> ExplicitContentFilter { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index b8b66f802..7b77dafc7 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -32,7 +32,8 @@ namespace Discord.Rest
                 Icon = args.Icon.IsSpecified ? args.Icon.Value?.ToModel() : Optional.Create<ImageModel?>(),
                 Name = args.Name,
                 Splash = args.Splash.IsSpecified ? args.Splash.Value?.ToModel() : Optional.Create<ImageModel?>(),
-                VerificationLevel = args.VerificationLevel
+                VerificationLevel = args.VerificationLevel,
+                ExplicitContentFilter = args.ExplicitContentFilter
             };
 
             if (args.AfkChannel.IsSpecified)
@@ -60,6 +61,9 @@ namespace Discord.Rest
             if (!apiArgs.Icon.IsSpecified && guild.IconId != null)
                 apiArgs.Icon = new ImageModel(guild.IconId);
 
+            if (args.ExplicitContentFilter.IsSpecified)
+                apiArgs.ExplicitContentFilter = args.ExplicitContentFilter.Value;
+
             return await client.ApiClient.ModifyGuildAsync(guild.Id, apiArgs, options).ConfigureAwait(false);
         }
         /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index 9c4ecd848..8cd81f218 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -32,6 +32,8 @@ namespace Discord.Rest
         public MfaLevel MfaLevel { get; private set; }
         /// <inheritdoc />
         public DefaultMessageNotifications DefaultMessageNotifications { get; private set; }
+        /// <inheritdoc />
+        public ExplicitContentFilterLevel ExplicitContentFilter { get; private set; }
 
         /// <inheritdoc />
         public ulong? AFKChannelId { get; private set; }
@@ -48,6 +50,8 @@ namespace Discord.Rest
         /// <inheritdoc />
         public string SplashId { get; private set; }
         internal bool Available { get; private set; }
+        /// <inheritdoc />
+        public ulong? ApplicationId { get; private set; }
 
         /// <inheritdoc />
         public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
@@ -98,6 +102,8 @@ namespace Discord.Rest
             VerificationLevel = model.VerificationLevel;
             MfaLevel = model.MfaLevel;
             DefaultMessageNotifications = model.DefaultMessageNotifications;
+            ExplicitContentFilter = model.ExplicitContentFilter;
+            ApplicationId = model.ApplicationId;
 
             if (model.Emojis != null)
             {
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs b/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
index a4ecf3647..fae1aff99 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestMessage.cs
@@ -55,6 +55,10 @@ namespace Discord.Rest
 
         /// <inheritdoc />
         public DateTimeOffset Timestamp => DateTimeUtils.FromTicks(_timestampTicks);
+        /// <inheritdoc />
+        public MessageActivity Activity { get; private set; }
+        /// <inheritdoc />
+        public MessageApplication Application { get; private set; }
 
         internal RestMessage(BaseDiscordClient discord, ulong id, IMessageChannel channel, IUser author, MessageSource source)
             : base(discord, id)
@@ -77,6 +81,29 @@ namespace Discord.Rest
 
             if (model.Content.IsSpecified)
                 Content = model.Content.Value;
+
+            if (model.Application.IsSpecified)
+            {
+                // create a new Application from the API model
+                Application = new MessageApplication()
+                {
+                    Id = model.Application.Value.Id,
+                    CoverImage = model.Application.Value.CoverImage,
+                    Description = model.Application.Value.Description,
+                    Icon = model.Application.Value.Icon,
+                    Name = model.Application.Value.Name
+                };
+            }
+
+            if (model.Activity.IsSpecified)
+            {
+                // create a new Activity from the API model
+                Activity = new MessageActivity()
+                {
+                    Type = model.Activity.Value.Type.Value,
+                    PartyId = model.Activity.Value.PartyId.Value
+                };
+            }
         }
 
         /// <inheritdoc />
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index b4f87e12a..ce8cd08de 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -50,6 +50,8 @@ namespace Discord.WebSocket
         public MfaLevel MfaLevel { get; private set; }
         /// <inheritdoc />
         public DefaultMessageNotifications DefaultMessageNotifications { get; private set; }
+        /// <inheritdoc />
+        public ExplicitContentFilterLevel ExplicitContentFilter { get; private set; }
         /// <summary>
         ///     Gets the number of members.
         /// </summary>
@@ -73,6 +75,8 @@ namespace Discord.WebSocket
         internal bool IsAvailable { get; private set; }
         /// <summary> Indicates whether the client is connected to this guild. </summary>
         public bool IsConnected { get; internal set; }
+        /// <inheritdoc />
+        public ulong? ApplicationId { get; internal set; }
 
         internal ulong? AFKChannelId { get; private set; }
         internal ulong? EmbedChannelId { get; private set; }
@@ -346,6 +350,8 @@ namespace Discord.WebSocket
             VerificationLevel = model.VerificationLevel;
             MfaLevel = model.MfaLevel;
             DefaultMessageNotifications = model.DefaultMessageNotifications;
+            ExplicitContentFilter = model.ExplicitContentFilter;
+            ApplicationId = model.ApplicationId;
 
             if (model.Emojis != null)
             {
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
index 0767f2ad7..2cfcee270 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketMessage.cs
@@ -43,6 +43,13 @@ namespace Discord.WebSocket
         public virtual bool IsPinned => false;
         /// <inheritdoc />
         public virtual DateTimeOffset? EditedTimestamp => null;
+
+        /// <inheritdoc />
+        public MessageActivity Activity { get; private set; }
+
+        /// <inheritdoc />
+        public MessageApplication Application { get; private set; }
+
         /// <summary>
         ///     Returns all attachments included in this message.
         /// </summary>
@@ -105,6 +112,29 @@ namespace Discord.WebSocket
 
             if (model.Content.IsSpecified)
                 Content = model.Content.Value;
+
+            if (model.Application.IsSpecified)
+            {
+                // create a new Application from the API model
+                Application = new MessageApplication()
+                {
+                    Id = model.Application.Value.Id,
+                    CoverImage = model.Application.Value.CoverImage,
+                    Description = model.Application.Value.Description,
+                    Icon = model.Application.Value.Icon,
+                    Name = model.Application.Value.Name
+                };
+            }
+
+            if (model.Activity.IsSpecified)
+            {
+                // create a new Activity from the API model
+                Activity = new MessageActivity()
+                {
+                    Type = model.Activity.Value.Type.Value,
+                    PartyId = model.Activity.Value.PartyId.Value
+                };
+            }
         }
 
         /// <inheritdoc />
diff --git a/test/Discord.Net.Tests/Tests.GuildPermissions.cs b/test/Discord.Net.Tests/Tests.Guilds.cs
similarity index 94%
rename from test/Discord.Net.Tests/Tests.GuildPermissions.cs
rename to test/Discord.Net.Tests/Tests.Guilds.cs
index f49f431b5..09e3d044d 100644
--- a/test/Discord.Net.Tests/Tests.GuildPermissions.cs
+++ b/test/Discord.Net.Tests/Tests.Guilds.cs
@@ -5,8 +5,25 @@ using Xunit;
 
 namespace Discord
 {
-    public class GuidPermissionsTests
+    public partial class Tests
     {
+        /// <summary>
+        ///     Tests the behavior of modifying the ExplicitContentFilter property of a Guild.
+        /// </summary>
+        [Fact]
+        public async Task TestExplicitContentFilter()
+        {
+            foreach (var level in Enum.GetValues(typeof(ExplicitContentFilterLevel)))
+            {
+                await _guild.ModifyAsync(x => x.ExplicitContentFilter = (ExplicitContentFilterLevel)level);
+                await _guild.UpdateAsync();
+                Assert.Equal(level, _guild.ExplicitContentFilter);
+            }
+        }
+
+        /// <summary>
+        ///     Tests the behavior of the GuildPermissions class.
+        /// </summary>
         [Fact]
         public Task TestGuildPermission()
         {

From 5ea1fb374e1fdb65d4410a5744434fbc01b39543 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sat, 20 Oct 2018 05:21:37 +0800
Subject: [PATCH 26/59] Add SyncPermissionsAsync to Sync Child Channels with
 its Parent (#1159)

* Initial implementation

* Adjust according to comments

See: https://github.com/RogueException/Discord.Net/pull/1159/files/6e76b45713ae95cf6fdfb96b57ed7095f6b6cc59#diff-58466c35787d448266d026692e467baa
---
 .../Entities/Channels/INestedChannel.cs         |  5 +++++
 src/Discord.Net.Rest/API/Common/Overwrite.cs    |  2 +-
 .../API/Rest/ModifyGuildChannelParams.cs        |  4 +++-
 .../Entities/Channels/ChannelHelper.cs          | 17 +++++++++++++++++
 .../Entities/Channels/RestTextChannel.cs        |  2 ++
 .../Entities/Channels/RestVoiceChannel.cs       |  2 ++
 .../Entities/Channels/SocketTextChannel.cs      |  2 ++
 .../Entities/Channels/SocketVoiceChannel.cs     |  2 ++
 8 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
index 22182a4ca..6719f91d4 100644
--- a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
@@ -25,5 +25,10 @@ namespace Discord
         ///     representing the parent of this channel; <c>null</c> if none is set.
         /// </returns>
         Task<ICategoryChannel> GetCategoryAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
+
+        /// <summary>
+        ///     Syncs the permissions of this nested channel with its parent's.
+        /// </summary>
+        Task SyncPermissionsAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Rest/API/Common/Overwrite.cs b/src/Discord.Net.Rest/API/Common/Overwrite.cs
index 1ba836127..1f3548a1c 100644
--- a/src/Discord.Net.Rest/API/Common/Overwrite.cs
+++ b/src/Discord.Net.Rest/API/Common/Overwrite.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API
diff --git a/src/Discord.Net.Rest/API/Rest/ModifyGuildChannelParams.cs b/src/Discord.Net.Rest/API/Rest/ModifyGuildChannelParams.cs
index 120eeb3a8..e5e8a4632 100644
--- a/src/Discord.Net.Rest/API/Rest/ModifyGuildChannelParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/ModifyGuildChannelParams.cs
@@ -1,4 +1,4 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using Newtonsoft.Json;
 
 namespace Discord.API.Rest
@@ -12,5 +12,7 @@ namespace Discord.API.Rest
         public Optional<int> Position { get; set; }
         [JsonProperty("parent_id")]
         public Optional<ulong?> CategoryId { get; set; }
+        [JsonProperty("permission_overwrites")]
+        public Optional<Overwrite[]> Overwrites { get; set; }
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
index 716f3beaf..65b4869b8 100644
--- a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
@@ -348,6 +348,23 @@ namespace Discord.Rest
             var model = await client.ApiClient.GetChannelAsync(channel.CategoryId.Value, options).ConfigureAwait(false);
             return RestCategoryChannel.Create(client, model) as ICategoryChannel;
         }
+        public static async Task SyncPermissionsAsync(INestedChannel channel, BaseDiscordClient client, RequestOptions options)
+        {
+            var category = await GetCategoryAsync(channel, client, options).ConfigureAwait(false);
+            if (category == null) throw new InvalidOperationException("This channel does not have a parent channel.");
+
+            var apiArgs = new ModifyGuildChannelParams
+            {
+                Overwrites = category.PermissionOverwrites
+                    .Select(overwrite => new API.Overwrite{
+                        TargetId = overwrite.TargetId,
+                        TargetType = overwrite.TargetType,
+                        Allow = overwrite.Permissions.AllowValue,
+                        Deny = overwrite.Permissions.DenyValue
+                    }).ToArray()
+            };
+            await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false);
+        }
 
         //Helpers
         private static IUser GetAuthor(BaseDiscordClient client, IGuild guild, UserModel model, ulong? webhookId)
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
index 4ccd35a3a..beeb8de19 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
@@ -201,6 +201,8 @@ namespace Discord.Rest
         /// </returns>
         public Task<ICategoryChannel> GetCategoryAsync(RequestOptions options = null)
             => ChannelHelper.GetCategoryAsync(this, Discord, options);
+        public Task SyncPermissionsAsync(RequestOptions options = null)
+            => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
 
         private string DebuggerDisplay => $"{Name} ({Id}, Text)";
 
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
index 7f0295c18..1a2c5ceae 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
@@ -57,6 +57,8 @@ namespace Discord.Rest
         /// </returns>
         public Task<ICategoryChannel> GetCategoryAsync(RequestOptions options = null)
             => ChannelHelper.GetCategoryAsync(this, Discord, options);
+        public Task SyncPermissionsAsync(RequestOptions options = null)
+            => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
 
         private string DebuggerDisplay => $"{Name} ({Id}, Voice)";
 
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
index 8faf1c6eb..acd868020 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
@@ -31,6 +31,8 @@ namespace Discord.WebSocket
         /// </returns>
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
+        public Task SyncPermissionsAsync(RequestOptions options = null)
+            => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
 
         private bool _nsfw;
         /// <inheritdoc />
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
index 07977e5e0..dd71416db 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
@@ -30,6 +30,8 @@ namespace Discord.WebSocket
         /// </returns>
         public ICategoryChannel Category
             => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
+        public Task SyncPermissionsAsync(RequestOptions options = null)
+            => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
 
         /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuildUser> Users

From fe07a83f1f5f8da9886f426fe21f038b61693123 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Fri, 19 Oct 2018 17:22:02 -0400
Subject: [PATCH 27/59] fix: strip trailing slash from ratelimit bucket IDs
 (#1163)

* fix: strip trailing slash from ratelimit bucket IDs

This resolves #1125.

fixes a bug where some ratelimit buckets would include a trailing slash,
while others wouldn't; this would cause them to be treated as separate
ratelimits, even though they are the same

ideally this fix should change the ratelimit generator, but that code is
pretty complicated and this was an easier fix that seems less likely to
break things in the future.

tested against normal bot function, all routes are assigned the proper
buckets from my testing, so this should be good to go.

* lint: use more performant algorithm, operate on StringBuilder
---
 src/Discord.Net.Rest/DiscordRestApiClient.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 36406bfea..284a51756 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -1,3 +1,4 @@
+
 #pragma warning disable CS1591
 using Discord.API.Rest;
 using Discord.Net;
@@ -1426,8 +1427,11 @@ namespace Discord.API
 
                     lastIndex = rightIndex + 1;
                 }
+                if (builder[builder.Length - 1] == '/')
+                    builder.Remove(builder.Length - 1, 1);
 
                 format = builder.ToString();
+
                 return x => string.Format(format, x.ToArray());
             }
             catch (Exception ex)

From 88e66860a6c3131f0a012e5f3a9fa80ca3c55ff1 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Fri, 19 Oct 2018 17:29:45 -0400
Subject: [PATCH 28/59] docs: update command sample to use CommandExecuted, Log

---
 .../Services/CommandHandlingService.cs        | 27 ++++++++++++++++---
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/samples/02_commands_framework/Services/CommandHandlingService.cs b/samples/02_commands_framework/Services/CommandHandlingService.cs
index fc253eed3..ca7af2774 100644
--- a/samples/02_commands_framework/Services/CommandHandlingService.cs
+++ b/samples/02_commands_framework/Services/CommandHandlingService.cs
@@ -20,6 +20,8 @@ namespace _02_commands_framework.Services
             _discord = services.GetRequiredService<DiscordSocketClient>();
             _services = services;
 
+            _commands.CommandExecuted += CommandExecutedAsync;
+            _commands.Log += LogAsync;
             _discord.MessageReceived += MessageReceivedAsync;
         }
 
@@ -39,11 +41,28 @@ namespace _02_commands_framework.Services
             if (!message.HasMentionPrefix(_discord.CurrentUser, ref argPos)) return;
 
             var context = new SocketCommandContext(_discord, message);
-            var result = await _commands.ExecuteAsync(context, argPos, _services);
+            await _commands.ExecuteAsync(context, argPos, _services); // we will handle the result in CommandExecutedAsync
+        }
+
+        public async Task CommandExecutedAsync(Optional<CommandInfo> command, ICommandContext context, IResult result)
+        {
+            // command is unspecified when there was a search failure (command not found); we don't care about these errors
+            if (!command.IsSpecified)
+                return;
+
+            // the command was succesful, we don't care about this result, unless we want to log that a command succeeded.
+            if (result.IsSuccess)
+                return;
+
+            // the command failed, let's notify the user that something happened.
+            await context.Channel.SendMessageAsync($"error: {result.ToString()}");
+        }
+
+        private Task LogAsync(LogMessage log)
+        {
+            Console.WriteLine(log.ToString());
 
-            if (result.Error.HasValue &&
-                result.Error.Value != CommandError.UnknownCommand) // it's bad practice to send 'unknown command' errors
-                await context.Channel.SendMessageAsync(result.ToString());
+            return Task.CompletedTask;
         }
     }
 }

From c7e7f7e51a0afc3c539d1b7876b2341701f731ff Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Fri, 19 Oct 2018 17:52:36 -0400
Subject: [PATCH 29/59] docs: add explanation to RunMode.Async in voice docs

---
 docs/guides/voice/sending-voice.md | 69 +++++++++++++++++-------------
 1 file changed, 39 insertions(+), 30 deletions(-)

diff --git a/docs/guides/voice/sending-voice.md b/docs/guides/voice/sending-voice.md
index c30805836..476f2f42e 100644
--- a/docs/guides/voice/sending-voice.md
+++ b/docs/guides/voice/sending-voice.md
@@ -11,16 +11,16 @@ Information is not guaranteed to be accurate.
 
 ## Installing
 
-Audio requires two native libraries, `libsodium` and `opus`. 
-Both of these libraries must be placed in the runtime directory of your 
-bot. (When developing on .NET Framework, this would be `bin/debug`, 
-when developing on .NET Core, this is where you execute `dotnet run` 
+Audio requires two native libraries, `libsodium` and `opus`.
+Both of these libraries must be placed in the runtime directory of your
+bot. (When developing on .NET Framework, this would be `bin/debug`,
+when developing on .NET Core, this is where you execute `dotnet run`
 from; typically the same directory as your csproj).
 
-For Windows Users, precompiled binaries are available for your 
+For Windows Users, precompiled binaries are available for your
 convienence [here](https://discord.foxbot.me/binaries/).
 
-For Linux Users, you will need to compile [Sodium] and [Opus] from 
+For Linux Users, you will need to compile [Sodium] and [Opus] from
 source, or install them from your package manager.
 
 [Sodium]: https://download.libsodium.org/libsodium/releases/
@@ -28,7 +28,7 @@ source, or install them from your package manager.
 
 ## Joining a Channel
 
-Joining a channel is the first step to sending audio, and will return 
+Joining a channel is the first step to sending audio, and will return
 an [IAudioClient] to send data with.
 
 To join a channel, simply await [ConnectAsync] on any instance of an
@@ -36,67 +36,76 @@ To join a channel, simply await [ConnectAsync] on any instance of an
 
 [!code-csharp[Joining a Channel](samples/joining_audio.cs)]
 
-The client will sustain a connection to this channel until it is 
+>[!WARNING]
+>Commands which mutate voice states, such as those where you join/leave
+>an audio channel, or send audio, should use [RunMode.Async]. RunMode.Async
+>is necessary to prevent a feedback loop which will deadlock clients
+>in their default configuration. If you know that you're running your
+>commands in a different task than the gateway task, RunMode.Async is
+>not required.
+
+The client will sustain a connection to this channel until it is
 kicked, disconnected from Discord, or told to disconnect.
 
-It should be noted that voice connections are created on a per-guild 
-basis; only one audio connection may be open by the bot in a single 
-guild. To switch channels within a guild, invoke [ConnectAsync] on 
+It should be noted that voice connections are created on a per-guild
+basis; only one audio connection may be open by the bot in a single
+guild. To switch channels within a guild, invoke [ConnectAsync] on
 another voice channel in the guild.
 
 [IAudioClient]: xref:Discord.Audio.IAudioClient
 [ConnectAsync]: xref:Discord.IAudioChannel.ConnectAsync*
+[RunMode.Async]: xref:Discord.Commands.RunMode
 
 ## Transmitting Audio
 
 ### With FFmpeg
 
-[FFmpeg] is an open source, highly versatile AV-muxing tool. This is 
+[FFmpeg] is an open source, highly versatile AV-muxing tool. This is
 the recommended method of transmitting audio.
 
-Before you begin, you will need to have a version of FFmpeg downloaded 
-and placed somewhere in your PATH (or alongside the bot, in the same 
-location as libsodium and opus). Windows binaries are available on 
+Before you begin, you will need to have a version of FFmpeg downloaded
+and placed somewhere in your PATH (or alongside the bot, in the same
+location as libsodium and opus). Windows binaries are available on
 [FFmpeg's download page].
 
 [FFmpeg]: https://ffmpeg.org/
 [FFmpeg's download page]: https://ffmpeg.org/download.html
 
-First, you will need to create a Process that starts FFmpeg. An 
-example of how to do this is included below, though it is important 
+First, you will need to create a Process that starts FFmpeg. An
+example of how to do this is included below, though it is important
 that you return PCM at 48000hz.
 
 >[!NOTE]
->As of the time of this writing, Discord.Audio struggles significantly 
->with processing audio that is already opus-encoded; you will need to 
+>As of the time of this writing, Discord.Audio struggles significantly
+>with processing audio that is already opus-encoded; you will need to
 >use the PCM write streams.
 
 [!code-csharp[Creating FFmpeg](samples/audio_create_ffmpeg.cs)]
 
-Next, to transmit audio from FFmpeg to Discord, you will need to 
-pull an [AudioOutStream] from your [IAudioClient]. Since we're using 
+Next, to transmit audio from FFmpeg to Discord, you will need to
+pull an [AudioOutStream] from your [IAudioClient]. Since we're using
 PCM audio, use [IAudioClient.CreatePCMStream].
 
-The sample rate argument doesn't particularly matter, so long as it is 
-a valid rate (120, 240, 480, 960, 1920, or 2880). For the sake of 
+The sample rate argument doesn't particularly matter, so long as it is
+a valid rate (120, 240, 480, 960, 1920, or 2880). For the sake of
 simplicity, I recommend using 1920.
 
-Channels should be left at `2`, unless you specified a different value 
+Channels should be left at `2`, unless you specified a different value
 for `-ac 2` when creating FFmpeg.
 
 [AudioOutStream]: xref:Discord.Audio.AudioOutStream
 [IAudioClient.CreatePCMStream]: xref:Discord.Audio.IAudioClient#Discord_Audio_IAudioClient_CreateDirectPCMStream_Discord_Audio_AudioApplication_System_Nullable_System_Int32__System_Int32_
 
-Finally, audio will need to be piped from FFmpeg's stdout into your 
-AudioOutStream. This step can be as complex as you'd like it to be, but 
-for the majority of cases, you can just use [Stream.CopyToAsync], as 
+Finally, audio will need to be piped from FFmpeg's stdout into your
+AudioOutStream. This step can be as complex as you'd like it to be, but
+for the majority of cases, you can just use [Stream.CopyToAsync], as
 shown below.
 
 [Stream.CopyToAsync]: https://msdn.microsoft.com/en-us/library/hh159084(v=vs.110).aspx
 
-If you are implementing a queue for sending songs, it's likely that 
-you will want to wait for audio to stop playing before continuing on 
-to the next song. You can await `AudioOutStream.FlushAsync` to wait for 
+If you are implementing a queue for sending songs, it's likely that
+you will want to wait for audio to stop playing before continuing on
+to the next song. You can await `AudioOutStream.FlushAsync` to wait for
 the audio client's internal buffer to clear out.
 
 [!code-csharp[Sending Audio](samples/audio_ffmpeg.cs)]

From fb8dbcae4beef1684f22cf7d4c3cc3be0918d958 Mon Sep 17 00:00:00 2001
From: Rithari <rithari@outlook.com>
Date: Sat, 20 Oct 2018 15:59:06 +0200
Subject: [PATCH 30/59] Added check to ignore bot commands. (#1175)

Added the usual check to ignore bot commands in this sample CommandHandler as seen and approved in #1174.
---
 .../commands/samples/post-execution/command_executed_demo.cs  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/commands/samples/post-execution/command_executed_demo.cs b/docs/guides/commands/samples/post-execution/command_executed_demo.cs
index 8d8fb911b..b87f4ef06 100644
--- a/docs/guides/commands/samples/post-execution/command_executed_demo.cs
+++ b/docs/guides/commands/samples/post-execution/command_executed_demo.cs
@@ -27,7 +27,7 @@ public async Task HandleCommandAsync(SocketMessage msg)
     var message = messageParam as SocketUserMessage;
     if (message == null) return;
     int argPos = 0;
-    if (!(message.HasCharPrefix('!', ref argPos) || message.HasMentionPrefix(_client.CurrentUser, ref argPos))) return;
+    if (!(message.HasCharPrefix('!', ref argPos) || message.HasMentionPrefix(_client.CurrentUser, ref argPos)) || message.Author.IsBot) return;
     var context = new SocketCommandContext(_client, message);
     var result = await _commands.ExecuteAsync(context, argPos, _services);
     // Optionally, you may pass the result manually into your
@@ -35,4 +35,4 @@ public async Task HandleCommandAsync(SocketMessage msg)
     // precondition failures in the same method.
 
     // await OnCommandExecutedAsync(null, context, result);
-}
\ No newline at end of file
+}

From 00097d3c271eab194853e2eed72a7bc495948967 Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Sat, 20 Oct 2018 10:02:25 -0400
Subject: [PATCH 31/59] Add DiscordShardedClient sample project & Client FAQ
 entry. (#1177)

* Add DiscordShardedClient sample project & Client FAQ entry.

* Revise language, fix typo, add xrefs

* Adjust placement of message handler.

* Resolve DI issue with initialized client; properly initialize command handling service.
---
 Discord.Net.sln                               | 17 ++++-
 docs/faq/basics/client-basics.md              | 30 +++++++-
 .../03_sharded_client.csproj                  | 14 ++++
 .../03_sharded_client/Modules/PublicModule.cs | 17 +++++
 samples/03_sharded_client/Program.cs          | 69 +++++++++++++++++++
 .../Services/CommandHandlingService.cs        | 52 ++++++++++++++
 6 files changed, 197 insertions(+), 2 deletions(-)
 create mode 100644 samples/03_sharded_client/03_sharded_client.csproj
 create mode 100644 samples/03_sharded_client/Modules/PublicModule.cs
 create mode 100644 samples/03_sharded_client/Program.cs
 create mode 100644 samples/03_sharded_client/Services/CommandHandlingService.cs

diff --git a/Discord.Net.sln b/Discord.Net.sln
index 9bb940d8c..245515c7c 100644
--- a/Discord.Net.sln
+++ b/Discord.Net.sln
@@ -26,10 +26,12 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Analyzers", "sr
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Samples", "Samples", "{BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "01_basic_ping_bot", "samples\01_basic_ping_bot\01_basic_ping_bot.csproj", "{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "01_basic_ping_bot", "samples\01_basic_ping_bot\01_basic_ping_bot.csproj", "{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "02_commands_framework", "samples\02_commands_framework\02_commands_framework.csproj", "{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "03_sharded_client", "samples\03_sharded_client\03_sharded_client.csproj", "{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -160,6 +162,18 @@ Global
 		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x64.Build.0 = Release|Any CPU
 		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x86.ActiveCfg = Release|Any CPU
 		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x86.Build.0 = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x64.Build.0 = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x86.Build.0 = Debug|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x64.ActiveCfg = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x64.Build.0 = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x86.ActiveCfg = Release|Any CPU
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -173,6 +187,7 @@ Global
 		{BBA8E7FB-C834-40DC-822F-B112CB7F0140} = {CC3D4B1C-9DE0-448B-8AE7-F3F1F3EC5C3A}
 		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
 		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
+		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {D2404771-EEC8-45F2-9D71-F3373F6C1495}
diff --git a/docs/faq/basics/client-basics.md b/docs/faq/basics/client-basics.md
index 5c529a3f5..9377ac2e9 100644
--- a/docs/faq/basics/client-basics.md
+++ b/docs/faq/basics/client-basics.md
@@ -63,4 +63,32 @@ use the cached message entity. Read more about it [here](xref:Guides.Concepts.Ev
 
 [MessageCacheSize]: xref:Discord.WebSocket.DiscordSocketConfig.MessageCacheSize
 [DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
-[MessageUpdated]: xref:Discord.WebSocket.BaseSocketClient.MessageUpdated
\ No newline at end of file
+[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/samples/03_sharded_client/03_sharded_client.csproj b/samples/03_sharded_client/03_sharded_client.csproj
new file mode 100644
index 000000000..5d76961cd
--- /dev/null
+++ b/samples/03_sharded_client/03_sharded_client.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
+    <RootNamespace>_03_sharded_client</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\Discord.Net.Commands\Discord.Net.Commands.csproj" />
+    <ProjectReference Include="..\..\src\Discord.Net.WebSocket\Discord.Net.WebSocket.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/03_sharded_client/Modules/PublicModule.cs b/samples/03_sharded_client/Modules/PublicModule.cs
new file mode 100644
index 000000000..60e57563a
--- /dev/null
+++ b/samples/03_sharded_client/Modules/PublicModule.cs
@@ -0,0 +1,17 @@
+using System.Threading.Tasks;
+using Discord.Commands;
+
+namespace _03_sharded_client.Modules
+{
+    // Remember to make your module reference the ShardedCommandContext
+    public class PublicModule : ModuleBase<ShardedCommandContext>
+    {
+        [Command("info")]
+        public async Task InfoAsync()
+        {
+            var msg = $@"Hi {Context.User}! There are currently {Context.Client.Shards} shards!
+                This guild is being served by shard number {Context.Client.GetShardFor(Context.Guild).ShardId}";
+            await ReplyAsync(msg);
+        }
+    }
+}
diff --git a/samples/03_sharded_client/Program.cs b/samples/03_sharded_client/Program.cs
new file mode 100644
index 000000000..048145f9f
--- /dev/null
+++ b/samples/03_sharded_client/Program.cs
@@ -0,0 +1,69 @@
+using System;
+using System.Threading.Tasks;
+using _03_sharded_client.Services;
+using Discord;
+using Discord.Commands;
+using Discord.WebSocket;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace _03_sharded_client
+{
+    // This is a minimal example of using Discord.Net's Sharded Client
+    // The provided DiscordShardedClient class simplifies having multiple
+    // DiscordSocketClient instances (or shards) to serve a large number of guilds.
+    class Program
+    {
+        private DiscordShardedClient _client;
+
+        static void Main(string[] args)
+            => new Program().MainAsync().GetAwaiter().GetResult();
+        public async Task MainAsync()
+        {
+            // You specify the amount of shards you'd like to have with the
+            // DiscordSocketConfig. Generally, it's recommended to 
+            // have 1 shard per 1500-2000 guilds your bot is in.
+            var config = new DiscordSocketConfig
+            {
+                TotalShards = 2
+            };
+
+            _client = new DiscordShardedClient(config);
+            var services = ConfigureServices();
+
+            // The Sharded Client does not have a Ready event.
+            // The ShardReady event is used instead, allowing for individual
+            // control per shard.
+            _client.ShardReady += ReadyAsync;
+            _client.Log += LogAsync;
+
+            await services.GetRequiredService<CommandHandlingService>().InitializeAsync();
+
+            await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
+            await _client.StartAsync();
+
+            await Task.Delay(-1);
+        }
+
+        private IServiceProvider ConfigureServices()
+        {
+            return new ServiceCollection()
+                .AddSingleton(_client)
+                .AddSingleton<CommandService>()
+                .AddSingleton<CommandHandlingService>()
+                .BuildServiceProvider();
+        }
+
+
+        private Task ReadyAsync(DiscordSocketClient shard)
+        {
+            Console.WriteLine($"Shard Number {shard.ShardId} is connected and ready!");
+            return Task.CompletedTask;
+        }
+
+        private Task LogAsync(LogMessage log)
+        {
+            Console.WriteLine(log.ToString());
+            return Task.CompletedTask;
+        }
+    }
+}
diff --git a/samples/03_sharded_client/Services/CommandHandlingService.cs b/samples/03_sharded_client/Services/CommandHandlingService.cs
new file mode 100644
index 000000000..31b70d4ae
--- /dev/null
+++ b/samples/03_sharded_client/Services/CommandHandlingService.cs
@@ -0,0 +1,52 @@
+using System;
+using System.Reflection;
+using System.Threading.Tasks;
+using Microsoft.Extensions.DependencyInjection;
+using Discord;
+using Discord.Commands;
+using Discord.WebSocket;
+
+namespace _03_sharded_client.Services
+{
+    public class CommandHandlingService
+    {
+        private readonly CommandService _commands;
+        private readonly DiscordShardedClient _discord;
+        private readonly IServiceProvider _services;
+
+        public CommandHandlingService(IServiceProvider services)
+        {
+            _commands = services.GetRequiredService<CommandService>();
+            _discord = services.GetRequiredService<DiscordShardedClient>();
+            _services = services;
+        }
+
+        public async Task InitializeAsync()
+        {
+            await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
+            _discord.MessageReceived += MessageReceivedAsync;
+        }
+
+        public async Task MessageReceivedAsync(SocketMessage rawMessage)
+        {
+            // Ignore system messages, or messages from other bots
+            if (!(rawMessage is SocketUserMessage message))
+                return;
+            if (message.Source != MessageSource.User)
+                return;
+
+            // This value holds the offset where the prefix ends
+            var argPos = 0;
+            if (!message.HasMentionPrefix(_discord.CurrentUser, ref argPos))
+                return;
+
+            // A new kind of command context, ShardedCommandContext can be utilized with the commands framework
+            var context = new ShardedCommandContext(_discord, message);
+            var result = await _commands.ExecuteAsync(context, argPos, _services);
+
+            if (result.Error.HasValue &&
+                result.Error.Value != CommandError.UnknownCommand) // it's bad practice to send 'unknown command' errors
+                await context.Channel.SendMessageAsync(result.ToString());
+        }
+    }
+}

From 07ec413884cc6b509acc6d8a28b10880fa7c9c47 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sat, 20 Oct 2018 10:05:08 -0400
Subject: [PATCH 32/59] docs: update shard sample to use CommandExecuted, Log

---
 .../Services/CommandHandlingService.cs        | 29 ++++++++++++++++---
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/samples/03_sharded_client/Services/CommandHandlingService.cs b/samples/03_sharded_client/Services/CommandHandlingService.cs
index 31b70d4ae..08a3887f0 100644
--- a/samples/03_sharded_client/Services/CommandHandlingService.cs
+++ b/samples/03_sharded_client/Services/CommandHandlingService.cs
@@ -19,6 +19,10 @@ namespace _03_sharded_client.Services
             _commands = services.GetRequiredService<CommandService>();
             _discord = services.GetRequiredService<DiscordShardedClient>();
             _services = services;
+
+            _commands.CommandExecuted += CommandExecutedAsync;
+            _commands.Log += LogAsync;
+            _discord.MessageReceived += MessageReceivedAsync;
         }
 
         public async Task InitializeAsync()
@@ -42,11 +46,28 @@ namespace _03_sharded_client.Services
 
             // A new kind of command context, ShardedCommandContext can be utilized with the commands framework
             var context = new ShardedCommandContext(_discord, message);
-            var result = await _commands.ExecuteAsync(context, argPos, _services);
+            await _commands.ExecuteAsync(context, argPos, _services);
+        }
+
+        public async Task CommandExecutedAsync(Optional<CommandInfo> command, ICommandContext context, IResult result)
+        {
+            // command is unspecified when there was a search failure (command not found); we don't care about these errors
+            if (!command.IsSpecified)
+                return;
+
+            // the command was succesful, we don't care about this result, unless we want to log that a command succeeded.
+            if (result.IsSuccess)
+                return;
+
+            // the command failed, let's notify the user that something happened.
+            await context.Channel.SendMessageAsync($"error: {result.ToString()}");
+        }
+
+        private Task LogAsync(LogMessage log)
+        {
+            Console.WriteLine(log.ToString());
 
-            if (result.Error.HasValue &&
-                result.Error.Value != CommandError.UnknownCommand) // it's bad practice to send 'unknown command' errors
-                await context.Channel.SendMessageAsync(result.ToString());
+            return Task.CompletedTask;
         }
     }
 }

From a253b7ee75f7ec1a731de8a363f81f466b4952be Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sat, 20 Oct 2018 10:07:10 -0400
Subject: [PATCH 33/59] docs: remove duplicated MessageReceived hook

---
 samples/03_sharded_client/Services/CommandHandlingService.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/samples/03_sharded_client/Services/CommandHandlingService.cs b/samples/03_sharded_client/Services/CommandHandlingService.cs
index 08a3887f0..1230cbcff 100644
--- a/samples/03_sharded_client/Services/CommandHandlingService.cs
+++ b/samples/03_sharded_client/Services/CommandHandlingService.cs
@@ -28,7 +28,6 @@ namespace _03_sharded_client.Services
         public async Task InitializeAsync()
         {
             await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
-            _discord.MessageReceived += MessageReceivedAsync;
         }
 
         public async Task MessageReceivedAsync(SocketMessage rawMessage)

From 62607490952511ab5fc41965cea10f9879914c95 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sat, 20 Oct 2018 10:52:26 -0400
Subject: [PATCH 34/59] fix: invoke CommandExecuted on async exception failures

---
 src/Discord.Net.Commands/Info/CommandInfo.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/Discord.Net.Commands/Info/CommandInfo.cs b/src/Discord.Net.Commands/Info/CommandInfo.cs
index d27a1ed7b..87434546f 100644
--- a/src/Discord.Net.Commands/Info/CommandInfo.cs
+++ b/src/Discord.Net.Commands/Info/CommandInfo.cs
@@ -272,6 +272,10 @@ namespace Discord.Commands
 
                 var wrappedEx = new CommandException(this, context, ex);
                 await Module.Service._cmdLogger.ErrorAsync(wrappedEx).ConfigureAwait(false);
+
+                var result = ExecuteResult.FromError(CommandError.Exception, ex.Message);
+                await Module.Service._commandExecutedEvent.InvokeAsync(this, context, result).ConfigureAwait(false);
+
                 if (Module.Service._throwOnError)
                 {
                     if (ex == originalEx)
@@ -280,7 +284,7 @@ namespace Discord.Commands
                         ExceptionDispatchInfo.Capture(ex).Throw();
                 }
 
-                return ExecuteResult.FromError(CommandError.Exception, ex.Message);
+                return result;
             }
             finally
             {

From f549da50e0cb491350e2116cbb141c82c460a455 Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sat, 20 Oct 2018 11:01:17 -0400
Subject: [PATCH 35/59] fix: pass the entire Exception into ExecuteResult

---
 src/Discord.Net.Commands/Info/CommandInfo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.Commands/Info/CommandInfo.cs b/src/Discord.Net.Commands/Info/CommandInfo.cs
index 87434546f..a8aa3157c 100644
--- a/src/Discord.Net.Commands/Info/CommandInfo.cs
+++ b/src/Discord.Net.Commands/Info/CommandInfo.cs
@@ -273,7 +273,7 @@ namespace Discord.Commands
                 var wrappedEx = new CommandException(this, context, ex);
                 await Module.Service._cmdLogger.ErrorAsync(wrappedEx).ConfigureAwait(false);
 
-                var result = ExecuteResult.FromError(CommandError.Exception, ex.Message);
+                var result = ExecuteResult.FromError(ex);
                 await Module.Service._commandExecutedEvent.InvokeAsync(this, context, result).ConfigureAwait(false);
 
                 if (Module.Service._throwOnError)

From 649a779c23737233933bac1b13a976e2b8a536f6 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sun, 21 Oct 2018 00:45:05 +0800
Subject: [PATCH 36/59] feature: Add invite maxAge check before attempting to
 create the invite (#1140)

* Add maxage check & improve maxage parameter check

* Change InvalidOperation to ArgumentOoR

* Remove HasValue check
...since it does it implicitly already.

* Add parameter names & better wording for invite OoR

* Move maxAge check to DiscordRestApiClient for consistency
---
 src/Discord.Net.Rest/DiscordRestApiClient.cs           |  2 ++
 .../Entities/Channels/ChannelHelper.cs                 | 10 +++++++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 284a51756..7ed57ed6f 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -978,6 +978,8 @@ namespace Discord.API
             Preconditions.NotNull(args, nameof(args));
             Preconditions.AtLeast(args.MaxAge, 0, nameof(args.MaxAge));
             Preconditions.AtLeast(args.MaxUses, 0, nameof(args.MaxUses));
+            Preconditions.AtMost(args.MaxAge, 86400, nameof(args.MaxAge),
+                "The maximum age of an invite must be less than or equal to a day (86400 seconds).");
             options = RequestOptions.CreateOrClone(options);
 
             var ids = new BucketIds(channelId: channelId);
diff --git a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
index 65b4869b8..5c232f292 100644
--- a/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/ChannelHelper.cs
@@ -76,9 +76,13 @@ namespace Discord.Rest
         public static async Task<RestInviteMetadata> CreateInviteAsync(IGuildChannel channel, BaseDiscordClient client,
             int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
         {
-            var args = new CreateChannelInviteParams { IsTemporary = isTemporary, IsUnique = isUnique };
-            args.MaxAge = maxAge.GetValueOrDefault(0);
-            args.MaxUses = maxUses.GetValueOrDefault(0);
+            var args = new API.Rest.CreateChannelInviteParams
+            {
+                IsTemporary = isTemporary,
+                IsUnique = isUnique,
+                MaxAge = maxAge ?? 0,
+                MaxUses = maxUses ?? 0
+            };
             var model = await client.ApiClient.CreateChannelInviteAsync(channel.Id, args, options).ConfigureAwait(false);
             return RestInviteMetadata.Create(client, null, channel, model);
         }

From 637d9fc79404700dbe8a0c76d741f01b8986b422 Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Sat, 20 Oct 2018 14:40:13 -0400
Subject: [PATCH 37/59] Add SocketUser.MutualGuilds + various command ext.
 methods. (#1037)

* Add SocketUser.MutualGuilds + various ext. methods.

* Search through submodules for GetExecutableCommandAsync

* Allow GetExecutableCommandsAsync(ModuleInfo) to recurse properly to all submodules.

* Bump down lang. version & whitespace cleanup.

* Change to use Task.WhenAll

* Change to ICollection<CommandInfo>

* Resolve build errors.
---
 .../Extensions/CommandServiceExtensions.cs    | 42 +++++++++++++++++++
 .../Extensions/EmbedBuilderExtensions.cs      | 12 ++++++
 .../Entities/Users/SocketUser.cs              |  6 ++-
 3 files changed, 59 insertions(+), 1 deletion(-)
 create mode 100644 src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs

diff --git a/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs b/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs
new file mode 100644
index 000000000..0a1c1646c
--- /dev/null
+++ b/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs
@@ -0,0 +1,42 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Discord.Commands
+{
+    public static class CommandServiceExtensions
+    {
+        public static async Task<IReadOnlyCollection<CommandInfo>> GetExecutableCommandsAsync(this ICollection<CommandInfo> commands, ICommandContext context, IServiceProvider provider)
+        {
+            var executableCommands = new List<CommandInfo>();
+
+            var tasks = commands.Select(async c => { var result = await c.CheckPreconditionsAsync(context, provider).ConfigureAwait(false); return new { Command = c, PreconditionResult = result }; });
+
+            var results = await Task.WhenAll(tasks);
+
+            foreach (var result in results)
+            {
+                if (result.PreconditionResult.IsSuccess)
+                    executableCommands.Add(result.Command);
+            }
+
+            return executableCommands;
+        }
+        public static Task<IReadOnlyCollection<CommandInfo>> GetExecutableCommandsAsync(this CommandService commandService, ICommandContext context, IServiceProvider provider)
+            => GetExecutableCommandsAsync(commandService.Commands.ToArray(), context, provider);
+        public static async Task<IReadOnlyCollection<CommandInfo>> GetExecutableCommandsAsync(this ModuleInfo module, ICommandContext context, IServiceProvider provider)
+        {
+            var executableCommands = new List<CommandInfo>();
+
+            executableCommands.AddRange(await module.Commands.ToArray().GetExecutableCommandsAsync(context, provider).ConfigureAwait(false));
+
+            var tasks = module.Submodules.Select(async s => await s.GetExecutableCommandsAsync(context, provider).ConfigureAwait(false));
+            var results = await Task.WhenAll(tasks);
+
+            executableCommands.AddRange(results.SelectMany(c => c));
+
+            return executableCommands;
+        }
+    }
+}
diff --git a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
index 2d72dc985..60fdcfbee 100644
--- a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
@@ -1,4 +1,6 @@
 using System;
+using System.Collections.Generic;
+using System.Linq;
 
 namespace Discord
 {
@@ -65,5 +67,15 @@ namespace Discord
 
             return builder;
         }
+
+        public static EmbedBuilder WithFields(this EmbedBuilder builder, IEnumerable<EmbedFieldBuilder> fields)
+        {
+            foreach (var field in fields)
+                builder.AddField(field);
+
+            return builder;
+        }
+        public static EmbedBuilder WithFields(this EmbedBuilder builder, params EmbedFieldBuilder[] fields)
+            => WithFields(builder, fields.AsEnumerable());
     }
 }
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
index 9a101cddb..f0dc92b1c 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
@@ -1,7 +1,9 @@
-using Discord.Rest;
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
+using System.Linq;
 using System.Threading.Tasks;
+using Discord.Rest;
 using Model = Discord.API.User;
 
 namespace Discord.WebSocket
@@ -35,6 +37,8 @@ namespace Discord.WebSocket
         public IActivity Activity => Presence.Activity;
         /// <inheritdoc />
         public UserStatus Status => Presence.Status;
+        public IEnumerable<SocketGuild> MutualGuilds
+            => Discord.Guilds.Where(g => g.Users.Any(u => u.Id == Id));
 
         internal SocketUser(DiscordSocketClient discord, ulong id)
             : base(discord, id)

From 5b3eb70ffdd1d791265aa38bfb3b313cbefbb3cd Mon Sep 17 00:00:00 2001
From: Christopher F <foxbot@protonmail.com>
Date: Sat, 20 Oct 2018 15:00:08 -0400
Subject: [PATCH 38/59] meta: add changelog

---
 CHANGELOG.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000..0388cb239
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,76 @@
+# Changelog
+
+## [Unreleased]
+### Added
+
+- #747: `CommandService` now has a `CommandExecuted` event (e991715)
+- #765: Parameters may have a name specified via `NameAttribute` (9c81ab9)
+- #773: Both socket clients inherit from `BaseSocketClient` (9b7afec)
+- #785: Primitives now automatically load a NullableTypeReader (cb0ff78)
+- #819: Support for Welcome Message channels (30e867a)
+- #835: Emoji may now be managed from a bot (b4bf046)
+- #843: Webhooks may now be managed from a bot (7b2ddd0)
+- #863: An embed may be converted to an `EmbedBuilder` using the `.ToEmbedBuilder()` method (5218e6b)
+- #877: Support for reading rich presences (34b4e5a)
+- #888: Users may now opt-in to using a proxy (678a723)
+- #906: API Analyzers to assist users when writing their bot (f69ef2a)
+- #907: Full support for channel categories (030422f)
+- #913: Animated emoji may be read and written (a19ff18)
+- #915: Unused parameters may be discarded, rather than failing the command (5f46aef)
+- #929: Standard EqualityComparers for use in LINQ operations with the library's entities (b5e7548)
+- 'html' variant added to the `EmbedType` enum (42c879c)
+
+### Fixed
+- #742: `DiscordShardedClient#GetGuildFor` will now direct null guilds to Shard 0 (d5e9d6f)
+- #743: Various issues with permissions and inheritance of permissions (f996338)
+- #755: `IRole.Mention` will correctly tag the @everyone role (6b5a6e7)
+- #768: `CreateGuildAsync` will include the icon stream (865080a)
+- #866: Revised permissions constants and behavior (dec7cb2)
+- #872: Bulk message deletion should no longer fail for incomplete batch sizes (804d918)
+- #923: A null value should properly reset a user's nickname (227f61a)
+- #938: The reconnect handler should no longer deadlock during Discord outages (73ac9d7)
+- Ignore messages with no ID in bulk delete (676be40)
+
+### Changed
+- #731: `IUserMessage#GetReactionUsersAsync` now takes an `IEmote` instead of a `string` (5d7f2fc)
+- #744: IAsyncEnumerable has been redesigned (5bbd9bb)
+- #777: `IGuild#DefaultChannel` will now resolve the first accessible channel, per changes to Discord (1ffcd4b)
+- #781: Attempting to add or remove a member's EveryoneRole will throw (506a6c9)
+- #801: `EmbedBuilder` will no longer implicitly convert to `Embed`, you must build manually (94f7dd2)
+- #804: Command-related tasks will have the 'async' suffix (14fbe40)
+- #812: The WebSocket4Net provider has been bumped to version 0.15, allowing support for .NET Standard apps (e25054b)
+- #829: DeleteMessagesAsync moved from IMessageChannel to ITextChannel (e00f17f)
+- #853: WebSocket will now use `zlib-stream` compression (759db34)
+- #874: The `ReadMessages` permission is moving to `ViewChannel` (edfbd05)
+- #877: Refactored Games into Activities (34b4e5a)
+- `IGuildChannel#Nsfw` moved to `ITextChannel`, now maps to the API property (608bc35)
+- Preemptive ratelimits are now logged under verbose, rather than warning. (3c1e766)
+- The default InviteAge when creating Invites is now 24 hours (9979a02)
+
+
+### Removed
+- #790: Redundant overloads for `AddField` removed from EmbedBuilder (479361b)
+- #925: RPC is no longer being maintained nor packaged (b30af57)
+- User logins (including selfbots) are no longer supported (fc5adca)
+
+### Misc
+- This project is now licensed to the Discord.Net contributors (710e182)
+- #786: Unit tests for the Color structure (22b969c)
+- #828: We now include a contributing guide (cd82a0f)
+- #876: We now include a standard editorconfig (5c8c784)
+
+## [1.0.2] - 2017-09-09
+### Fixed
+
+- Guilds utilizing Channel Categories will no longer crash bots on the `READY` event.
+
+## [1.0.1] - 2017-07-05
+### Fixed
+
+- #732: Fixed parameter preconditions not being loaded from class-based modules (b6dcc9e)
+- #726: Fixed CalculateScore throwing an ArgumentException for missing parameters (7597cf5)
+- EmbedBuilder URI validation should no longer throw NullReferenceExceptions in certain edge cases (d89804d)
+- Fixed module auto-detection for nested modules (d2afb06)
+
+### Changed
+- ShardedCommandContext now inherits from SocketCommandContext (8cd99be)

From 8fa70bf6a65dde24f6ab85dd279f3f10a93c8c77 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Mon, 22 Oct 2018 05:26:39 +0800
Subject: [PATCH 39/59] lint: Initial clean-up (#1181)

---
 .../Extensions/CommandServiceExtensions.cs             | 10 +++++++---
 src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs |  5 +++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs b/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs
index 0a1c1646c..675a9073d 100644
--- a/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs
+++ b/src/Discord.Net.Commands/Extensions/CommandServiceExtensions.cs
@@ -11,9 +11,13 @@ namespace Discord.Commands
         {
             var executableCommands = new List<CommandInfo>();
 
-            var tasks = commands.Select(async c => { var result = await c.CheckPreconditionsAsync(context, provider).ConfigureAwait(false); return new { Command = c, PreconditionResult = result }; });
+            var tasks = commands.Select(async c =>
+            {
+                var result = await c.CheckPreconditionsAsync(context, provider).ConfigureAwait(false);
+                return new { Command = c, PreconditionResult = result };
+            });
 
-            var results = await Task.WhenAll(tasks);
+            var results = await Task.WhenAll(tasks).ConfigureAwait(false);
 
             foreach (var result in results)
             {
@@ -32,7 +36,7 @@ namespace Discord.Commands
             executableCommands.AddRange(await module.Commands.ToArray().GetExecutableCommandsAsync(context, provider).ConfigureAwait(false));
 
             var tasks = module.Submodules.Select(async s => await s.GetExecutableCommandsAsync(context, provider).ConfigureAwait(false));
-            var results = await Task.WhenAll(tasks);
+            var results = await Task.WhenAll(tasks).ConfigureAwait(false);
 
             executableCommands.AddRange(results.SelectMany(c => c));
 
diff --git a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
index f0dc92b1c..41c463a89 100644
--- a/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
+++ b/src/Discord.Net.WebSocket/Entities/Users/SocketUser.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Collections.Immutable;
 using System.Diagnostics;
 using System.Linq;
 using System.Threading.Tasks;
@@ -37,8 +38,8 @@ namespace Discord.WebSocket
         public IActivity Activity => Presence.Activity;
         /// <inheritdoc />
         public UserStatus Status => Presence.Status;
-        public IEnumerable<SocketGuild> MutualGuilds
-            => Discord.Guilds.Where(g => g.Users.Any(u => u.Id == Id));
+        public IReadOnlyCollection<SocketGuild> MutualGuilds
+            => Discord.Guilds.Where(g => g.Users.Any(u => u.Id == Id)).ToImmutableArray();
 
         internal SocketUser(DiscordSocketClient discord, ulong id)
             : base(discord, id)

From 8e6e0e9ad2fe535b28ab5ed0f8e5b9e127cde092 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Sun, 21 Oct 2018 14:27:02 -0700
Subject: [PATCH 40/59] lint: Remove public setters for MessageApplication,
 MessageActivity properties (#1182)

This fixes an error that was introduced in d30d12246d5173321c2556cf65d3c69da230cb8c (thanks Still for noticing!)

Changes the public property setters of the MessageActivity and MessageApplication entities to be
internal, since they cannot be modified by the user in the API.
---
 .../Entities/Messages/MessageActivity.cs               |  4 ++--
 .../Entities/Messages/MessageApplication.cs            | 10 +++++-----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs b/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
index d19e6a8e9..b539b8f9b 100644
--- a/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
+++ b/src/Discord.Net.Core/Entities/Messages/MessageActivity.cs
@@ -13,11 +13,11 @@ namespace Discord
         /// <summary>
         ///     Gets the type of activity of this message.
         /// </summary>
-        public MessageActivityType Type { get; set; }
+        public MessageActivityType Type { get; internal set; }
         /// <summary>
         ///     Gets the party ID of this activity, if any.
         /// </summary>
-        public string PartyId { get; set; }
+        public string PartyId { get; internal set; }
 
         private string DebuggerDisplay
             => $"{Type}{(string.IsNullOrWhiteSpace(PartyId) ? "" : $" {PartyId}")}";
diff --git a/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs b/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
index 960d1700f..05616cb59 100644
--- a/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
+++ b/src/Discord.Net.Core/Entities/Messages/MessageApplication.cs
@@ -13,19 +13,19 @@ namespace Discord
         /// <summary>
         ///     Gets the snowflake ID of the application.
         /// </summary>
-        public ulong Id { get; set; }
+        public ulong Id { get; internal set; }
         /// <summary>
         ///     Gets the ID of the embed's image asset.
         /// </summary>
-        public string CoverImage { get; set; }
+        public string CoverImage { get; internal set; }
         /// <summary>
         ///     Gets the application's description.
         /// </summary>
-        public string Description { get; set; }
+        public string Description { get; internal set; }
         /// <summary>
         ///     Gets the ID of the application's icon.
         /// </summary>
-        public string Icon { get; set; }
+        public string Icon { get; internal set; }
         /// <summary>
         ///     Gets the Url of the application's icon.
         /// </summary>
@@ -34,7 +34,7 @@ namespace Discord
         /// <summary>
         ///     Gets the name of the application.
         /// </summary>
-        public string Name { get; set; }
+        public string Name { get; internal set; }
         private string DebuggerDisplay
             => $"{Name} ({Id}): {Description}";
         public override string ToString()

From c1d51522122688fdc598c5225a0cd08b0f47017b Mon Sep 17 00:00:00 2001
From: OatmealDome <OatmealDome@users.noreply.github.com>
Date: Sun, 4 Nov 2018 17:43:36 -0500
Subject: [PATCH 41/59] fix: UploadWebhookFileParams: Move most things into a
 json_payload (#1186)

---
 .../API/Rest/UploadWebhookFileParams.cs       | 28 ++++++++++++++-----
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/src/Discord.Net.Rest/API/Rest/UploadWebhookFileParams.cs b/src/Discord.Net.Rest/API/Rest/UploadWebhookFileParams.cs
index 6d6eb29b2..479a7857a 100644
--- a/src/Discord.Net.Rest/API/Rest/UploadWebhookFileParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/UploadWebhookFileParams.cs
@@ -1,12 +1,17 @@
-#pragma warning disable CS1591
+#pragma warning disable CS1591
 using System.Collections.Generic;
 using System.IO;
+using System.Text;
+using Discord.Net.Converters;
 using Discord.Net.Rest;
+using Newtonsoft.Json;
 
 namespace Discord.API.Rest
 {
     internal class UploadWebhookFileParams
     {
+        private static JsonSerializer _serializer = new JsonSerializer { ContractResolver = new DiscordContractResolver() };
+
         public Stream File { get; }
 
         public Optional<string> Filename { get; set; }
@@ -27,18 +32,27 @@ namespace Discord.API.Rest
             var d = new Dictionary<string, object>();
             d["file"] = new MultipartFile(File, Filename.GetValueOrDefault("unknown.dat"));
 
+            var payload = new Dictionary<string, object>();
             if (Content.IsSpecified)
-                d["content"] = Content.Value;
+                payload["content"] = Content.Value;
             if (IsTTS.IsSpecified)
-                d["tts"] = IsTTS.Value.ToString();
+                payload["tts"] = IsTTS.Value.ToString();
             if (Nonce.IsSpecified)
-                d["nonce"] = Nonce.Value;
+                payload["nonce"] = Nonce.Value;
             if (Username.IsSpecified)
-                d["username"] = Username.Value;
+                payload["username"] = Username.Value;
             if (AvatarUrl.IsSpecified)
-                d["avatar_url"] = AvatarUrl.Value;
+                payload["avatar_url"] = AvatarUrl.Value;
             if (Embeds.IsSpecified)
-                d["embeds"] = Embeds.Value;
+                payload["embeds"] = Embeds.Value;
+
+            var json = new StringBuilder();
+            using (var text = new StringWriter(json))
+            using (var writer = new JsonTextWriter(text))
+                _serializer.Serialize(writer, payload);
+
+            d["payload_json"] = json.ToString();
+
             return d;
         }
     }

From 7dd2268982c4f269c1e361c7745d22139fc7f2d7 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Tue, 6 Nov 2018 07:32:30 +0800
Subject: [PATCH 42/59] lint: Discord Namespace Clean-up (#1185)

* Remove RpcException

* Move RestConnection to Discord.Net.Rest

* Remove RpcVirtualMessageChannel

* Move REST objects to Discord.Net.Rest

* Fix Discord.Rest namespace
---
 src/Discord.Net.Core/Net/RpcException.cs      |  17 ---
 .../Channels/RpcVirtualMessageChannel.cs      | 110 ------------------
 .../Entities/Guilds/RestGuildEmbed.cs         |   2 +-
 .../Entities/Guilds/RestVoiceRegion.cs        |   2 +-
 .../Entities/Users/RestConnection.cs          |   2 +-
 5 files changed, 3 insertions(+), 130 deletions(-)
 delete mode 100644 src/Discord.Net.Core/Net/RpcException.cs
 delete mode 100644 src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs

diff --git a/src/Discord.Net.Core/Net/RpcException.cs b/src/Discord.Net.Core/Net/RpcException.cs
deleted file mode 100644
index 195fad73f..000000000
--- a/src/Discord.Net.Core/Net/RpcException.cs
+++ /dev/null
@@ -1,17 +0,0 @@
-using System;
-
-namespace Discord
-{
-    public class RpcException : Exception
-    {
-        public int ErrorCode { get; }
-        public string Reason { get; }
-
-        public RpcException(int errorCode, string reason = null)
-            : base($"The server sent error {errorCode}{(reason != null ? $": \"{reason}\"" : "")}")
-        {
-            ErrorCode = errorCode;
-            Reason = reason;
-        }
-    }
-}
diff --git a/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs
deleted file mode 100644
index ce37af6b4..000000000
--- a/src/Discord.Net.Rest/Entities/Channels/RpcVirtualMessageChannel.cs
+++ /dev/null
@@ -1,110 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.IO;
-using System.Linq;
-using System.Threading.Tasks;
-
-namespace Discord.Rest
-{
-    [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    internal class RestVirtualMessageChannel : RestEntity<ulong>, IMessageChannel
-    {
-        public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
-        public string Mention => MentionUtils.MentionChannel(Id);
-
-        internal RestVirtualMessageChannel(BaseDiscordClient discord, ulong id)
-            : base(discord, id)
-        {
-        }
-        internal static RestVirtualMessageChannel Create(BaseDiscordClient discord, ulong id)
-        {
-            return new RestVirtualMessageChannel(discord, id);
-        }
-
-        public Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null)
-            => ChannelHelper.GetMessageAsync(this, Discord, id, options);
-        public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
-            => ChannelHelper.GetMessagesAsync(this, Discord, null, Direction.Before, limit, options);
-        public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
-            => ChannelHelper.GetMessagesAsync(this, Discord, fromMessageId, dir, limit, options);
-        public IAsyncEnumerable<IReadOnlyCollection<RestMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
-            => ChannelHelper.GetMessagesAsync(this, Discord, fromMessage.Id, dir, limit, options);
-        public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
-            => ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
-
-        public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
-            => ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
-        public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
-            => ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options);
-        public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null)
-
-            => ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options);
-
-        /// <inheritdoc />
-        public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
-            => ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
-        /// <inheritdoc />
-        public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
-            => ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
-
-        /// <inheritdoc />
-        public Task TriggerTypingAsync(RequestOptions options = null)
-            => ChannelHelper.TriggerTypingAsync(this, Discord, options);
-        /// <inheritdoc />
-        public IDisposable EnterTypingState(RequestOptions options = null)
-            => ChannelHelper.EnterTypingState(this, Discord, options);
-
-        private string DebuggerDisplay => $"({Id}, Text)";
-
-        //IMessageChannel
-        async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
-        {
-            if (mode == CacheMode.AllowDownload)
-                return await GetMessageAsync(id, options).ConfigureAwait(false);
-            else
-                return null;
-        }
-        IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
-        {
-            if (mode == CacheMode.AllowDownload)
-                return GetMessagesAsync(limit, options);
-            else
-                return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
-        }
-        IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
-        {
-            if (mode == CacheMode.AllowDownload)
-                return GetMessagesAsync(fromMessageId, dir, limit, options);
-            else
-                return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
-        }
-        IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
-        {
-            if (mode == CacheMode.AllowDownload)
-                return GetMessagesAsync(fromMessage, dir, limit, options);
-            else
-                return AsyncEnumerable.Empty<IReadOnlyCollection<IMessage>>();
-        }
-        async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
-            => await GetPinnedMessagesAsync(options).ConfigureAwait(false);
-
-        async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options)
-            => await SendFileAsync(filePath, text, isTTS, embed, options);
-
-        async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options)
-            => await SendFileAsync(stream, filename, text, isTTS, embed, options).ConfigureAwait(false);
-        async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
-            => await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
-
-        //IChannel
-        string IChannel.Name => 
-            throw new NotSupportedException();
-
-        IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options) => 
-            throw new NotSupportedException();
-
-        Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options) => 
-            throw new NotSupportedException();
-    }
-}
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
index 00f3fae69..41c76eb06 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuildEmbed.cs
@@ -1,7 +1,7 @@
 using System.Diagnostics;
 using Model = Discord.API.GuildEmbed;
 
-namespace Discord
+namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public struct RestGuildEmbed
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs b/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
index 7a03b68d4..a363f051b 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs
@@ -2,7 +2,7 @@ using Discord.Rest;
 using System.Diagnostics;
 using Model = Discord.API.VoiceRegion;
 
-namespace Discord
+namespace Discord.Rest
 {
     /// <summary>
     ///     Represents a REST-based voice region.
diff --git a/src/Discord.Net.Rest/Entities/Users/RestConnection.cs b/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
index 0c91493d2..1afb813c0 100644
--- a/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
+++ b/src/Discord.Net.Rest/Entities/Users/RestConnection.cs
@@ -3,7 +3,7 @@ using System.Collections.Immutable;
 using System.Diagnostics;
 using Model = Discord.API.Connection;
 
-namespace Discord
+namespace Discord.Rest
 {
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestConnection : IConnection

From 8ef5f8120ffdaaa0669b8ff6d9c8dc601ac78439 Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Mon, 5 Nov 2018 18:34:09 -0500
Subject: [PATCH 43/59] feature: add Add Guild Member endpoint (#1183)

* Add AddGuildMember Oauth endpoint support

* Concat RoleIds if already exists.

* Use local ids variable.
---
 .../Entities/Guilds/IGuild.cs                 | 12 ++++
 .../Entities/Users/AddGuildUserProperties.cs  | 62 +++++++++++++++++++
 .../API/Rest/AddGuildMemberParams.cs          | 19 ++++++
 src/Discord.Net.Rest/DiscordRestApiClient.cs  | 19 ++++++
 .../Entities/Guilds/GuildHelper.cs            | 28 +++++++++
 .../Entities/Guilds/RestGuild.cs              |  8 +++
 .../Entities/Guilds/SocketGuild.cs            |  8 +++
 7 files changed, 156 insertions(+)
 create mode 100644 src/Discord.Net.Core/Entities/Users/AddGuildUserProperties.cs
 create mode 100644 src/Discord.Net.Rest/API/Rest/AddGuildMemberParams.cs

diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
index c321cd2e3..a7206bd59 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
@@ -535,6 +535,18 @@ namespace Discord
         /// </returns>
         Task<IRole> CreateRoleAsync(string name, GuildPermissions? permissions = null, Color? color = null, bool isHoisted = false, RequestOptions options = null);
 
+        /// <summary>
+        ///     Adds a user to this guild.
+        /// </summary>
+        /// <remarks>
+        ///     This method requires you have an OAuth2 access token for the user, requested with the guilds.join scope, and that the bot have the MANAGE_INVITES permission in the guild.
+        /// </remarks>
+        /// <param name="id">The snowflake identifier of the user.</param>
+        /// <param name="accessToken">The OAuth2 access token for the user, requested with the guilds.join scope.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the user upon being added to the guild.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>A guild user associated with the specified <paramref name="id" />; <c>null</c> if the user is already in the guild.</returns>
+        Task<IGuildUser> AddGuildUserAsync(ulong userId, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null);
         /// <summary>
         ///     Gets a collection of all users in this guild.
         /// </summary>
diff --git a/src/Discord.Net.Core/Entities/Users/AddGuildUserProperties.cs b/src/Discord.Net.Core/Entities/Users/AddGuildUserProperties.cs
new file mode 100644
index 000000000..e380d9027
--- /dev/null
+++ b/src/Discord.Net.Core/Entities/Users/AddGuildUserProperties.cs
@@ -0,0 +1,62 @@
+using System.Collections.Generic;
+
+namespace Discord
+{
+    /// <summary>
+    ///     Properties that are used to add a new <see cref="IGuildUser"/> to the guild with the following parameters.
+    /// </summary>
+    /// <seealso cref="IGuild.AddGuildUserAsync" />
+    public class AddGuildUserProperties
+    {
+        /// <summary>
+        ///     Gets or sets the user's nickname.
+        /// </summary>
+        /// <remarks>
+        ///     To clear the user's nickname, this value can be set to <c>null</c> or
+        ///     <see cref="string.Empty"/>.
+        /// </remarks>
+        public Optional<string> Nickname { get; set; }
+        /// <summary>
+        ///     Gets or sets whether the user should be muted in a voice channel.
+        /// </summary>
+        /// <remarks>
+        ///     If this value is set to <c>true</c>, no user will be able to hear this user speak in the guild.
+        /// </remarks>
+        public Optional<bool> Mute { get; set; }
+        /// <summary>
+        ///     Gets or sets whether the user should be deafened in a voice channel.
+        /// </summary>
+        /// <remarks>
+        ///     If this value is set to <c>true</c>, this user will not be able to hear anyone speak in the guild.
+        /// </remarks>
+        public Optional<bool> Deaf { get; set; }
+        /// <summary>
+        ///     Gets or sets the roles the user should have.
+        /// </summary>
+        /// <remarks>
+        ///     <para>
+        ///         To add a role to a user:
+        ///         <see cref="IGuildUser.AddRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        ///     <para>
+        ///         To remove a role from a user:
+        ///         <see cref="IGuildUser.RemoveRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        /// </remarks>
+        public Optional<IEnumerable<IRole>> Roles { get; set; }
+        /// <summary>
+        ///     Gets or sets the roles the user should have.
+        /// </summary>
+        /// <remarks>
+        ///     <para>
+        ///         To add a role to a user:
+        ///         <see cref="IGuildUser.AddRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        ///     <para>
+        ///         To remove a role from a user:
+        ///         <see cref="IGuildUser.RemoveRolesAsync(IEnumerable{IRole},RequestOptions)" />
+        ///     </para>
+        /// </remarks>
+        public Optional<IEnumerable<ulong>> RoleIds { get; set; }
+    }
+}
diff --git a/src/Discord.Net.Rest/API/Rest/AddGuildMemberParams.cs b/src/Discord.Net.Rest/API/Rest/AddGuildMemberParams.cs
new file mode 100644
index 000000000..ef6229edb
--- /dev/null
+++ b/src/Discord.Net.Rest/API/Rest/AddGuildMemberParams.cs
@@ -0,0 +1,19 @@
+using Newtonsoft.Json;
+
+namespace Discord.API.Rest
+{
+    [JsonObject(MemberSerialization = MemberSerialization.OptIn)]
+    internal class AddGuildMemberParams
+    {
+        [JsonProperty("access_token")]
+        public string AccessToken { get; set; }
+        [JsonProperty("nick")]
+        public Optional<string> Nickname { get; set; }
+        [JsonProperty("roles")]
+        public Optional<ulong[]> RoleIds { get; set; }
+        [JsonProperty("mute")]
+        public Optional<bool> IsMuted { get; set; }
+        [JsonProperty("deaf")]
+        public Optional<bool> IsDeafened { get; set; }
+    }
+}
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 7ed57ed6f..57d7c718a 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -994,6 +994,25 @@ namespace Discord.API
         }
 
         //Guild Members
+        public async Task<GuildMember> AddGuildMemberAsync(ulong guildId, ulong userId, AddGuildMemberParams args, RequestOptions options = null)
+        {
+            Preconditions.NotEqual(guildId, 0, nameof(guildId));
+            Preconditions.NotEqual(userId, 0, nameof(userId));
+            Preconditions.NotNull(args, nameof(args));
+            Preconditions.NotNullOrWhitespace(args.AccessToken, nameof(args.AccessToken));
+
+            if (args.RoleIds.IsSpecified)
+            {
+                foreach (var roleId in args.RoleIds.Value)
+                    Preconditions.NotEqual(roleId, 0, nameof(roleId));
+            }                
+
+            options = RequestOptions.CreateOrClone(options);
+
+            var ids = new BucketIds(guildId: guildId);
+
+            return await SendJsonAsync<GuildMember>("PUT", () => $"guilds/{guildId}/members/{userId}", args, ids, options: options);
+        }
         public async Task<GuildMember> GetGuildMemberAsync(ulong guildId, ulong userId, RequestOptions options = null)
         {
             Preconditions.NotEqual(guildId, 0, nameof(guildId));
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index 7b77dafc7..c31fa89f2 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -257,6 +257,34 @@ namespace Discord.Rest
         }
 
         //Users
+        public static async Task<RestGuildUser> AddGuildUserAsync(IGuild guild, BaseDiscordClient client, ulong userId, string accessToken,
+            Action<AddGuildUserProperties> func, RequestOptions options)
+        {
+            var args = new AddGuildUserProperties();
+            func?.Invoke(args);
+
+            if (args.Roles.IsSpecified)
+            {
+                var ids = args.Roles.Value.Select(r => r.Id);
+
+                if (args.RoleIds.IsSpecified)
+                    args.RoleIds.Value.Concat(ids);
+                else
+                    args.RoleIds = Optional.Create(ids);
+            }
+            var apiArgs = new AddGuildMemberParams
+            {
+                AccessToken = accessToken,
+                Nickname = args.Nickname,
+                IsDeafened = args.Deaf,
+                IsMuted = args.Mute,
+                RoleIds = args.RoleIds.IsSpecified ? args.RoleIds.Value.Distinct().ToArray() : Optional.Create<ulong[]>()
+            };
+
+            var model = await client.ApiClient.AddGuildMemberAsync(guild.Id, userId, apiArgs, options);
+
+            return model is null ? null : RestGuildUser.Create(client, guild, model);
+        }
         public static async Task<RestGuildUser> GetUserAsync(IGuild guild, BaseDiscordClient client,
             ulong id, RequestOptions options)
         {
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index 8cd81f218..bd70bf96b 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -537,6 +537,10 @@ namespace Discord.Rest
         public IAsyncEnumerable<IReadOnlyCollection<RestGuildUser>> GetUsersAsync(RequestOptions options = null)
             => GuildHelper.GetUsersAsync(this, Discord, null, null, options);
 
+        /// <inheritdoc />
+        public Task<RestGuildUser> AddGuildUserAsync(ulong id, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null)
+            => GuildHelper.AddGuildUserAsync(this, Discord, id, accessToken, func, options);
+
         /// <summary>
         ///     Gets a user from this guild.
         /// </summary>
@@ -800,6 +804,10 @@ namespace Discord.Rest
         async Task<IRole> IGuild.CreateRoleAsync(string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options)
             => await CreateRoleAsync(name, permissions, color, isHoisted, options).ConfigureAwait(false);
 
+        /// <inheritdoc />
+        async Task<IGuildUser> IGuild.AddGuildUserAsync(ulong userId, string accessToken, Action<AddGuildUserProperties> func, RequestOptions options)
+            => await AddGuildUserAsync(userId, accessToken, func, options);
+
         /// <inheritdoc />
         async Task<IGuildUser> IGuild.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
         {
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index ce8cd08de..412f3acff 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -669,6 +669,10 @@ namespace Discord.WebSocket
         }
 
         //Users
+        /// <inheritdoc />
+        public Task<RestGuildUser> AddGuildUserAsync(ulong id, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null)
+            => GuildHelper.AddGuildUserAsync(this, Discord, id, accessToken, func, options);
+
         /// <summary>
         ///     Gets a user from this guild.
         /// </summary>
@@ -1096,6 +1100,10 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         Task<IReadOnlyCollection<IGuildUser>> IGuild.GetUsersAsync(CacheMode mode, RequestOptions options)
             => Task.FromResult<IReadOnlyCollection<IGuildUser>>(Users);
+
+        /// <inheritdoc />
+        async Task<IGuildUser> IGuild.AddGuildUserAsync(ulong userId, string accessToken, Action<AddGuildUserProperties> func, RequestOptions options)
+            => await AddGuildUserAsync(userId, accessToken, func, options);
         /// <inheritdoc />
         Task<IGuildUser> IGuild.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));

From 419c0a5b5312391903c0f72344609c4dae486a07 Mon Sep 17 00:00:00 2001
From: Joe4evr <jii.geugten@gmail.com>
Date: Wed, 7 Nov 2018 00:36:44 +0100
Subject: [PATCH 44/59] feature: Add a way to invoke a command specifying
 optional values by name (#1123)

* Add NamedArgumentTypeAttribute

* Add NamedArgumentTypeReader

* Fix superflous empty line.

* Fix logic for quoted arguments

* Throw an exception with a tailored message.

* Add a catch to wrap parsing/input errors

* Trim potential excess whitespace

* Fix an off-by-one

* Support to read an IEnumerable property

* Add a doc

* Add assertion for the collection test
---
 .../Attributes/NamedArgumentTypeAttribute.cs  |  11 +
 .../Attributes/OverrideTypeReaderAttribute.cs |   5 +-
 .../Builders/ModuleClassBuilder.cs            |   2 +-
 .../Builders/ParameterBuilder.cs              |  29 ++-
 .../Readers/NamedArgumentTypeReader.cs        | 191 ++++++++++++++++++
 .../Discord.Net.Tests.csproj                  |   7 +-
 test/Discord.Net.Tests/Tests.TypeReaders.cs   | 133 ++++++++++++
 7 files changed, 369 insertions(+), 9 deletions(-)
 create mode 100644 src/Discord.Net.Commands/Attributes/NamedArgumentTypeAttribute.cs
 create mode 100644 src/Discord.Net.Commands/Readers/NamedArgumentTypeReader.cs
 create mode 100644 test/Discord.Net.Tests/Tests.TypeReaders.cs

diff --git a/src/Discord.Net.Commands/Attributes/NamedArgumentTypeAttribute.cs b/src/Discord.Net.Commands/Attributes/NamedArgumentTypeAttribute.cs
new file mode 100644
index 000000000..a43286110
--- /dev/null
+++ b/src/Discord.Net.Commands/Attributes/NamedArgumentTypeAttribute.cs
@@ -0,0 +1,11 @@
+using System;
+
+namespace Discord.Commands
+{
+    /// <summary>
+    /// Instructs the command system to treat command paramters of this type
+    /// as a collection of named arguments matching to its properties.
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
+    public sealed class NamedArgumentTypeAttribute : Attribute { }
+}
diff --git a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
index 85f5df10e..a44dcb6e4 100644
--- a/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
+++ b/src/Discord.Net.Commands/Attributes/OverrideTypeReaderAttribute.cs
@@ -1,5 +1,4 @@
 using System;
-
 using System.Reflection;
 
 namespace Discord.Commands
@@ -27,8 +26,8 @@ namespace Discord.Commands
     ///         => ReplyAsync(time);
     ///     </code>
     /// </example>
-    [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
-    public class OverrideTypeReaderAttribute : Attribute
+    [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
+    public sealed class OverrideTypeReaderAttribute : Attribute
     {
         private static readonly TypeInfo TypeReaderTypeInfo = typeof(TypeReader).GetTypeInfo();
 
diff --git a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
index 3b71c87b0..aec8dcbe3 100644
--- a/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
+++ b/src/Discord.Net.Commands/Builders/ModuleClassBuilder.cs
@@ -280,7 +280,7 @@ namespace Discord.Commands
             }
         }
 
-        private static TypeReader GetTypeReader(CommandService service, Type paramType, Type typeReaderType, IServiceProvider services)
+        internal static TypeReader GetTypeReader(CommandService service, Type paramType, Type typeReaderType, IServiceProvider services)
         {
             var readers = service.GetTypeReaders(paramType);
             TypeReader reader = null;
diff --git a/src/Discord.Net.Commands/Builders/ParameterBuilder.cs b/src/Discord.Net.Commands/Builders/ParameterBuilder.cs
index 8a59c247c..4ad5bfac0 100644
--- a/src/Discord.Net.Commands/Builders/ParameterBuilder.cs
+++ b/src/Discord.Net.Commands/Builders/ParameterBuilder.cs
@@ -56,11 +56,36 @@ namespace Discord.Commands.Builders
 
         private TypeReader GetReader(Type type)
         {
-            var readers = Command.Module.Service.GetTypeReaders(type);
+            var commands = Command.Module.Service;
+            if (type.GetTypeInfo().GetCustomAttribute<NamedArgumentTypeAttribute>() != null)
+            {
+                IsRemainder = true;
+                var reader = commands.GetTypeReaders(type)?.FirstOrDefault().Value;
+                if (reader == null)
+                {
+                    Type readerType;
+                    try
+                    {
+                        readerType = typeof(NamedArgumentTypeReader<>).MakeGenericType(new[] { type });
+                    }
+                    catch (ArgumentException ex)
+                    {
+                        throw new InvalidOperationException($"Parameter type '{type.Name}' for command '{Command.Name}' must be a class with a public parameterless constructor to use as a NamedArgumentType.", ex);
+                    }
+
+                    reader = (TypeReader)Activator.CreateInstance(readerType, new[] { commands });
+                    commands.AddTypeReader(type, reader);
+                }
+
+                return reader;
+            }
+
+
+            var readers = commands.GetTypeReaders(type);
             if (readers != null)
                 return readers.FirstOrDefault().Value;
             else
-                return Command.Module.Service.GetDefaultTypeReader(type);
+                return commands.GetDefaultTypeReader(type);
         }
 
         public ParameterBuilder WithSummary(string summary)
diff --git a/src/Discord.Net.Commands/Readers/NamedArgumentTypeReader.cs b/src/Discord.Net.Commands/Readers/NamedArgumentTypeReader.cs
new file mode 100644
index 000000000..01559293f
--- /dev/null
+++ b/src/Discord.Net.Commands/Readers/NamedArgumentTypeReader.cs
@@ -0,0 +1,191 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Reflection;
+using System.Threading.Tasks;
+
+namespace Discord.Commands
+{
+    internal sealed class NamedArgumentTypeReader<T> : TypeReader
+        where T : class, new()
+    {
+        private static readonly IReadOnlyDictionary<string, PropertyInfo> _tProps = typeof(T).GetTypeInfo().DeclaredProperties
+            .Where(p => p.SetMethod != null && p.SetMethod.IsPublic && !p.SetMethod.IsStatic)
+            .ToImmutableDictionary(p => p.Name, StringComparer.OrdinalIgnoreCase);
+
+        private readonly CommandService _commands;
+
+        public NamedArgumentTypeReader(CommandService commands)
+        {
+            _commands = commands;
+        }
+
+        public override async Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
+        {
+            var result = new T();
+            var state = ReadState.LookingForParameter;
+            int beginRead = 0, currentRead = 0;
+
+            while (state != ReadState.End)
+            {
+                try
+                {
+                    var prop = Read(out var arg);
+                    var propVal = await ReadArgumentAsync(prop, arg).ConfigureAwait(false);
+                    if (propVal != null)
+                        prop.SetMethod.Invoke(result, new[] { propVal });
+                    else
+                        return TypeReaderResult.FromError(CommandError.ParseFailed, $"Could not parse the argument for the parameter '{prop.Name}' as type '{prop.PropertyType}'.");
+                }
+                catch (Exception ex)
+                {
+                    //TODO: use the Exception overload after a rebase on latest
+                    return TypeReaderResult.FromError(CommandError.Exception, ex.Message);
+                }
+            }
+
+            return TypeReaderResult.FromSuccess(result);
+
+            PropertyInfo Read(out string arg)
+            {
+                string currentParam = null;
+                char match = '\0';
+
+                for (; currentRead < input.Length; currentRead++)
+                {
+                    var currentChar = input[currentRead];
+                    switch (state)
+                    {
+                        case ReadState.LookingForParameter:
+                            if (Char.IsWhiteSpace(currentChar))
+                                continue;
+                            else
+                            {
+                                beginRead = currentRead;
+                                state = ReadState.InParameter;
+                            }
+                            break;
+                        case ReadState.InParameter:
+                            if (currentChar != ':')
+                                continue;
+                            else
+                            {
+                                currentParam = input.Substring(beginRead, currentRead - beginRead);
+                                state = ReadState.LookingForArgument;
+                            }
+                            break;
+                        case ReadState.LookingForArgument:
+                            if (Char.IsWhiteSpace(currentChar))
+                                continue;
+                            else
+                            {
+                                beginRead = currentRead;
+                                state = (QuotationAliasUtils.GetDefaultAliasMap.TryGetValue(currentChar, out match))
+                                    ? ReadState.InQuotedArgument
+                                    : ReadState.InArgument;
+                            }
+                            break;
+                        case ReadState.InArgument:
+                            if (!Char.IsWhiteSpace(currentChar))
+                                continue;
+                            else
+                                return GetPropAndValue(out arg);
+                        case ReadState.InQuotedArgument:
+                            if (currentChar != match)
+                                continue;
+                            else
+                                return GetPropAndValue(out arg);
+                    }
+                }
+
+                if (currentParam == null)
+                    throw new InvalidOperationException("No parameter name was read.");
+
+                return GetPropAndValue(out arg);
+
+                PropertyInfo GetPropAndValue(out string argv)
+                {
+                    bool quoted = state == ReadState.InQuotedArgument;
+                    state = (currentRead == (quoted ? input.Length - 1 : input.Length))
+                        ? ReadState.End
+                        : ReadState.LookingForParameter;
+
+                    if (quoted)
+                    {
+                        argv = input.Substring(beginRead + 1, currentRead - beginRead - 1).Trim();
+                        currentRead++;
+                    }
+                    else 
+                        argv = input.Substring(beginRead, currentRead - beginRead);
+
+                    return _tProps[currentParam];
+                }
+            }
+
+            async Task<object> ReadArgumentAsync(PropertyInfo prop, string arg)
+            {
+                var elemType = prop.PropertyType;
+                bool isCollection = false;
+                if (elemType.GetTypeInfo().IsGenericType && elemType.GetGenericTypeDefinition() == typeof(IEnumerable<>))
+                {
+                    elemType = prop.PropertyType.GenericTypeArguments[0];
+                    isCollection = true;
+                }
+
+                var overridden = prop.GetCustomAttribute<OverrideTypeReaderAttribute>();
+                var reader = (overridden != null)
+                    ? ModuleClassBuilder.GetTypeReader(_commands, elemType, overridden.TypeReader, services)
+                    : (_commands.GetDefaultTypeReader(elemType)
+                        ?? _commands.GetTypeReaders(elemType).FirstOrDefault().Value);
+
+                if (reader != null)
+                {
+                    if (isCollection)
+                    {
+                        var method = _readMultipleMethod.MakeGenericMethod(elemType);
+                        var task = (Task<IEnumerable>)method.Invoke(null, new object[] { reader, context, arg.Split(','), services });
+                        return await task.ConfigureAwait(false);
+                    }
+                    else
+                        return await ReadSingle(reader, context, arg, services).ConfigureAwait(false);
+                }
+                return null;
+            }
+        }
+
+        private static async Task<object> ReadSingle(TypeReader reader, ICommandContext context, string arg, IServiceProvider services)
+        {
+            var readResult = await reader.ReadAsync(context, arg, services).ConfigureAwait(false);
+            return (readResult.IsSuccess)
+                ? readResult.BestMatch
+                : null;
+        }
+        private static async Task<IEnumerable> ReadMultiple<TObj>(TypeReader reader, ICommandContext context, IEnumerable<string> args, IServiceProvider services)
+        {
+            var objs = new List<TObj>();
+            foreach (var arg in args)
+            {
+                var read = await ReadSingle(reader, context, arg.Trim(), services).ConfigureAwait(false);
+                if (read != null)
+                    objs.Add((TObj)read);
+            }
+            return objs.ToImmutableArray();
+        }
+        private static readonly MethodInfo _readMultipleMethod = typeof(NamedArgumentTypeReader<T>)
+            .GetTypeInfo()
+            .DeclaredMethods
+            .Single(m => m.IsPrivate && m.IsStatic && m.Name == nameof(ReadMultiple));
+
+        private enum ReadState
+        {
+            LookingForParameter,
+            InParameter,
+            LookingForArgument,
+            InArgument,
+            InQuotedArgument,
+            End
+        }
+    }
+}
diff --git a/test/Discord.Net.Tests/Discord.Net.Tests.csproj b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
index 60491a96f..0ee6f7e59 100644
--- a/test/Discord.Net.Tests/Discord.Net.Tests.csproj
+++ b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
@@ -3,6 +3,7 @@
     <OutputType>Exe</OutputType>
     <RootNamespace>Discord</RootNamespace>
     <TargetFramework>netcoreapp1.1</TargetFramework>
+    <DebugType>portable</DebugType>
     <PackageTargetFallback>$(PackageTargetFallback);portable-net45+win8+wp8+wpa81</PackageTargetFallback>
   </PropertyGroup>
   <ItemGroup>
@@ -23,8 +24,8 @@
     <PackageReference Include="Akavache" Version="5.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.7.2" />
     <PackageReference Include="Newtonsoft.Json" Version="11.0.2" />
-    <PackageReference Include="xunit" Version="2.3.1" />
-    <PackageReference Include="xunit.runner.visualstudio" Version="2.3.1" />
-    <PackageReference Include="xunit.runner.reporters" Version="2.3.1" />
+    <PackageReference Include="xunit" Version="2.4.0" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.0" />
+    <PackageReference Include="xunit.runner.reporters" Version="2.4.0" />
   </ItemGroup>
 </Project>
diff --git a/test/Discord.Net.Tests/Tests.TypeReaders.cs b/test/Discord.Net.Tests/Tests.TypeReaders.cs
new file mode 100644
index 000000000..91514bfae
--- /dev/null
+++ b/test/Discord.Net.Tests/Tests.TypeReaders.cs
@@ -0,0 +1,133 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Discord.Commands;
+using Xunit;
+
+namespace Discord
+{
+    public sealed class TypeReaderTests
+    {
+        [Fact]
+        public async Task TestNamedArgumentReader()
+        {
+            var commands = new CommandService();
+            var module = await commands.AddModuleAsync<TestModule>(null);
+
+            Assert.NotNull(module);
+            Assert.NotEmpty(module.Commands);
+
+            var cmd = module.Commands[0];
+            Assert.NotNull(cmd);
+            Assert.NotEmpty(cmd.Parameters);
+
+            var param = cmd.Parameters[0];
+            Assert.NotNull(param);
+            Assert.True(param.IsRemainder);
+
+            var result = await param.ParseAsync(null, "bar: hello foo: 42");
+            Assert.True(result.IsSuccess);
+
+            var m = result.BestMatch as ArgumentType;
+            Assert.NotNull(m);
+            Assert.Equal(expected: 42, actual: m.Foo);
+            Assert.Equal(expected: "hello", actual: m.Bar);
+        }
+
+        [Fact]
+        public async Task TestQuotedArgumentValue()
+        {
+            var commands = new CommandService();
+            var module = await commands.AddModuleAsync<TestModule>(null);
+
+            Assert.NotNull(module);
+            Assert.NotEmpty(module.Commands);
+
+            var cmd = module.Commands[0];
+            Assert.NotNull(cmd);
+            Assert.NotEmpty(cmd.Parameters);
+
+            var param = cmd.Parameters[0];
+            Assert.NotNull(param);
+            Assert.True(param.IsRemainder);
+
+            var result = await param.ParseAsync(null, "foo: 42 bar: 《hello》");
+            Assert.True(result.IsSuccess);
+
+            var m = result.BestMatch as ArgumentType;
+            Assert.NotNull(m);
+            Assert.Equal(expected: 42, actual: m.Foo);
+            Assert.Equal(expected: "hello", actual: m.Bar);
+        }
+
+        [Fact]
+        public async Task TestNonPatternInput()
+        {
+            var commands = new CommandService();
+            var module = await commands.AddModuleAsync<TestModule>(null);
+
+            Assert.NotNull(module);
+            Assert.NotEmpty(module.Commands);
+
+            var cmd = module.Commands[0];
+            Assert.NotNull(cmd);
+            Assert.NotEmpty(cmd.Parameters);
+
+            var param = cmd.Parameters[0];
+            Assert.NotNull(param);
+            Assert.True(param.IsRemainder);
+
+            var result = await param.ParseAsync(null, "foobar");
+            Assert.False(result.IsSuccess);
+            Assert.Equal(expected: CommandError.Exception, actual: result.Error);
+        }
+
+        [Fact]
+        public async Task TestMultiple()
+        {
+            var commands = new CommandService();
+            var module = await commands.AddModuleAsync<TestModule>(null);
+
+            Assert.NotNull(module);
+            Assert.NotEmpty(module.Commands);
+
+            var cmd = module.Commands[0];
+            Assert.NotNull(cmd);
+            Assert.NotEmpty(cmd.Parameters);
+
+            var param = cmd.Parameters[0];
+            Assert.NotNull(param);
+            Assert.True(param.IsRemainder);
+
+            var result = await param.ParseAsync(null, "manyints: \"1, 2, 3, 4, 5, 6, 7\"");
+            Assert.True(result.IsSuccess);
+
+            var m = result.BestMatch as ArgumentType;
+            Assert.NotNull(m);
+            Assert.Equal(expected: new int[] { 1, 2, 3, 4, 5, 6, 7 }, actual: m.ManyInts);
+        }
+    }
+
+    [NamedArgumentType]
+    public sealed class ArgumentType
+    {
+        public int Foo { get; set; }
+
+        [OverrideTypeReader(typeof(CustomTypeReader))]
+        public string Bar { get; set; }
+
+        public IEnumerable<int> ManyInts { get; set; }
+    }
+
+    public sealed class CustomTypeReader : TypeReader
+    {
+        public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
+            => Task.FromResult(TypeReaderResult.FromSuccess(input));
+    }
+
+    public sealed class TestModule : ModuleBase
+    {
+        [Command("test")]
+        public Task TestCommand(ArgumentType arg) => Task.Delay(0);
+    }
+}

From f9c95bc4610899fcd286b7d6e930c48cd5c9e9a5 Mon Sep 17 00:00:00 2001
From: Casino Boyale <kayrenhi@gmail.com>
Date: Thu, 8 Nov 2018 15:58:21 +0000
Subject: [PATCH 45/59] Got rid of use of undefined variables

---
 docs/guides/voice/samples/joining_audio.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/voice/samples/joining_audio.cs b/docs/guides/voice/samples/joining_audio.cs
index 3abbfb632..8803d3596 100644
--- a/docs/guides/voice/samples/joining_audio.cs
+++ b/docs/guides/voice/samples/joining_audio.cs
@@ -3,8 +3,8 @@
 public async Task JoinChannel(IVoiceChannel channel = null)
 {
     // Get the audio channel
-    channel = channel ?? (msg.Author as IGuildUser)?.VoiceChannel;
-    if (channel == null) { await msg.Channel.SendMessageAsync("User must be in a voice channel, or a voice channel must be passed as an argument."); return; }
+    channel = channel ?? (Context.User as IGuildUser)?.VoiceChannel;
+    if (channel == null) { await Context.Channel.SendMessageAsync("User must be in a voice channel, or a voice channel must be passed as an argument."); return; }
 
     // For the next step with transmitting audio, you would want to pass this Audio Client in to a service.
     var audioClient = await channel.ConnectAsync();

From 10233f3a9a67a6e2cb63e98060c71662dc60c45a Mon Sep 17 00:00:00 2001
From: Casino Boyale <kayrenhi@gmail.com>
Date: Tue, 20 Nov 2018 19:16:27 +0000
Subject: [PATCH 46/59] fix: Fixed CommandExecuted firing twice for failed
 RuntimeResults (#1192)

* Fixed CommandExecuted firing twice for failed RuntimeResults

* Changed to just checking the result type

* Amendments
---
 src/Discord.Net.Commands/CommandService.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Discord.Net.Commands/CommandService.cs b/src/Discord.Net.Commands/CommandService.cs
index 432b75f27..d5b3f9ff4 100644
--- a/src/Discord.Net.Commands/CommandService.cs
+++ b/src/Discord.Net.Commands/CommandService.cs
@@ -603,7 +603,7 @@ namespace Discord.Commands
             //If we get this far, at least one parse was successful. Execute the most likely overload.
             var chosenOverload = successfulParses[0];
             var result = await chosenOverload.Key.ExecuteAsync(context, chosenOverload.Value, services).ConfigureAwait(false);
-            if (!result.IsSuccess) // succesful results raise the event in CommandInfo#ExecuteInternalAsync (have to raise it there b/c deffered execution)
+            if (!result.IsSuccess && !(result is RuntimeResult)) // succesful results raise the event in CommandInfo#ExecuteInternalAsync (have to raise it there b/c deffered execution)
                 await _commandExecutedEvent.InvokeAsync(chosenOverload.Key.Command, context, result);
             return result;
         }

From a64ab6025b4da17fcfea1876d54fdd032d5361dd Mon Sep 17 00:00:00 2001
From: Nathan Solomon <nbsolomon4559@gmail.com>
Date: Tue, 27 Nov 2018 16:16:32 -0600
Subject: [PATCH 47/59] Resolve Issue #1188 (Allow Users to specify position
 when creating a new channel) (#1196)

* Added ability to specify position when creating a channel

* Adjusted categories to include guildproperties and allow specifying position when creating channel categories

* fixed unimplemented methods (for CreateCategoryChannelAsync) and added appropriate documentation
---
 src/Discord.Net.Core/Entities/Guilds/IGuild.cs    |  3 ++-
 .../API/Rest/CreateGuildChannelParams.cs          |  2 ++
 .../Entities/Guilds/GuildHelper.cs                | 15 ++++++++++++---
 src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs |  9 +++++----
 .../Entities/Guilds/SocketGuild.cs                |  9 +++++----
 5 files changed, 26 insertions(+), 12 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
index a7206bd59..3b35796b9 100644
--- a/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/IGuild.cs
@@ -474,12 +474,13 @@ namespace Discord
         ///     Creates a new channel category in this guild.
         /// </summary>
         /// <param name="name">The new name for the category.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
         ///     A task that represents the asynchronous creation operation. The task result contains the newly created
         ///     category channel.
         /// </returns>
-        Task<ICategoryChannel> CreateCategoryAsync(string name, RequestOptions options = null);
+        Task<ICategoryChannel> CreateCategoryAsync(string name, Action<GuildChannelProperties> func = null, RequestOptions options = null);
 
         /// <summary>
         ///     Gets a collection of all the voice regions this guild can access.
diff --git a/src/Discord.Net.Rest/API/Rest/CreateGuildChannelParams.cs b/src/Discord.Net.Rest/API/Rest/CreateGuildChannelParams.cs
index 05cdf4b8a..a102bd38d 100644
--- a/src/Discord.Net.Rest/API/Rest/CreateGuildChannelParams.cs
+++ b/src/Discord.Net.Rest/API/Rest/CreateGuildChannelParams.cs
@@ -12,6 +12,8 @@ namespace Discord.API.Rest
         public ChannelType Type { get; }
         [JsonProperty("parent_id")]
         public Optional<ulong?> CategoryId { get; set; }
+        [JsonProperty("position")]
+        public Optional<int> Position { get; set; }
 
         //Text channels
         [JsonProperty("topic")]
diff --git a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
index c31fa89f2..affa74685 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/GuildHelper.cs
@@ -163,6 +163,7 @@ namespace Discord.Rest
                 CategoryId = props.CategoryId,
                 Topic = props.Topic,
                 IsNsfw = props.IsNsfw,
+                Position = props.Position
             };
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestTextChannel.Create(client, guild, model);
@@ -180,18 +181,26 @@ namespace Discord.Rest
             {
                 CategoryId = props.CategoryId,
                 Bitrate = props.Bitrate,
-                UserLimit = props.UserLimit
+                UserLimit = props.UserLimit,
+                Position = props.Position
             };
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestVoiceChannel.Create(client, guild, model);
         }
         /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client,
-            string name, RequestOptions options)
+            string name, RequestOptions options, Action<GuildChannelProperties> func = null)
         {
             if (name == null) throw new ArgumentNullException(paramName: nameof(name));
 
-            var args = new CreateGuildChannelParams(name, ChannelType.Category);
+            var props = new GuildChannelProperties();
+            func?.Invoke(props);
+
+            var args = new CreateGuildChannelParams(name, ChannelType.Category)
+            {
+                Position = props.Position
+            };
+
             var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
             return RestCategoryChannel.Create(client, guild, model);
         }
diff --git a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
index bd70bf96b..a847998b5 100644
--- a/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
+++ b/src/Discord.Net.Rest/Entities/Guilds/RestGuild.cs
@@ -441,13 +441,14 @@ namespace Discord.Rest
         ///     Creates a category channel with the provided name.
         /// </summary>
         /// <param name="name">The name of the new channel.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <exception cref="ArgumentNullException"><paramref name="name" /> is <c>null</c>.</exception>
         /// <returns>
         ///     The created category channel.
         /// </returns>
-        public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, RequestOptions options = null)
-            => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options);
+        public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, Action<GuildChannelProperties> func = null, RequestOptions options = null)
+            => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options, func);
 
         /// <summary>
         ///     Gets a collection of all the voice regions this guild can access.
@@ -776,8 +777,8 @@ namespace Discord.Rest
         async Task<IVoiceChannel> IGuild.CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
             => await CreateVoiceChannelAsync(name, func, options).ConfigureAwait(false);
         /// <inheritdoc />
-        async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
-            => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
+        async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, Action<GuildChannelProperties> func, RequestOptions options)
+            => await CreateCategoryChannelAsync(name, func, options).ConfigureAwait(false);
 
         /// <inheritdoc />
         async Task<IReadOnlyCollection<IVoiceRegion>> IGuild.GetVoiceRegionsAsync(RequestOptions options)
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index 412f3acff..4e4124679 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -561,14 +561,15 @@ namespace Discord.WebSocket
         ///     Creates a new channel category in this guild.
         /// </summary>
         /// <param name="name">The new name for the category.</param>
+        /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
         /// <returns>
         ///     A task that represents the asynchronous creation operation. The task result contains the newly created
         ///     category channel.
         /// </returns>
-        public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, RequestOptions options = null)
-            => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options);
+        public Task<RestCategoryChannel> CreateCategoryChannelAsync(string name, Action<GuildChannelProperties> func = null, RequestOptions options = null)
+            => GuildHelper.CreateCategoryChannelAsync(this, Discord, name, options, func);
 
         internal SocketGuildChannel AddChannel(ClientState state, ChannelModel model)
         {
@@ -1069,8 +1070,8 @@ namespace Discord.WebSocket
         async Task<IVoiceChannel> IGuild.CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
             => await CreateVoiceChannelAsync(name, func, options).ConfigureAwait(false);
         /// <inheritdoc />
-        async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, RequestOptions options)
-            => await CreateCategoryChannelAsync(name, options).ConfigureAwait(false);
+        async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, Action<GuildChannelProperties> func, RequestOptions options)
+            => await CreateCategoryChannelAsync(name, func, options).ConfigureAwait(false);
 
         /// <inheritdoc />
         async Task<IReadOnlyCollection<IVoiceRegion>> IGuild.GetVoiceRegionsAsync(RequestOptions options)

From f005af37b401e921d5402a9d4db8519bdcdd5192 Mon Sep 17 00:00:00 2001
From: Christopher Felegy <foxbot@protonmail.com>
Date: Tue, 27 Nov 2018 17:31:47 -0500
Subject: [PATCH 48/59] feature: add Format.Url, Format.EscapeUrl

Format.Url formats a URL into a markdown `[]()` masked URL.

Format.EscapeUrl formats a URL into a Discord `<>` escaped URL.
---
 src/Discord.Net.Core/Format.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Discord.Net.Core/Format.cs b/src/Discord.Net.Core/Format.cs
index 0b16daeb1..fec9b607a 100644
--- a/src/Discord.Net.Core/Format.cs
+++ b/src/Discord.Net.Core/Format.cs
@@ -14,6 +14,10 @@ namespace Discord
         public static string Underline(string text) => $"__{text}__";
         /// <summary> Returns a markdown-formatted string with strikethrough formatting. </summary>
         public static string Strikethrough(string text) => $"~~{text}~~";
+        /// <summary> Returns a markdown-formatted URL. Only works in <see cref="EmbedBuilder"/> descriptions and fields. </summary>
+        public static string Url(string text, string url) => $"[{text}]({url})";
+        /// <summary> Escapes a URL so that a preview is not generated. </summary>
+        public static string EscapeUrl(string url) => $"<{url}>";
 
         /// <summary> Returns a markdown-formatted string with codeblock formatting. </summary>
         public static string Code(string text, string language = null)

From 5421df14fe5f0a90a07863bdf3690e8ff449e9ae Mon Sep 17 00:00:00 2001
From: Christopher Felegy <foxbot@protonmail.com>
Date: Tue, 27 Nov 2018 17:49:30 -0500
Subject: [PATCH 49/59] feature: add extensions for bulk reactions

this is not api-level bulk reactions (!)
---
 .../Extensions/MessageExtensions.cs           | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/src/Discord.Net.Core/Extensions/MessageExtensions.cs b/src/Discord.Net.Core/Extensions/MessageExtensions.cs
index 90185cb6d..90ebea92f 100644
--- a/src/Discord.Net.Core/Extensions/MessageExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/MessageExtensions.cs
@@ -1,3 +1,5 @@
+using System.Threading.Tasks;
+
 namespace Discord
 {
     /// <summary>
@@ -17,5 +19,57 @@ namespace Discord
             var channel = msg.Channel;
             return $"https://discordapp.com/channels/{(channel is IDMChannel ? "@me" : $"{(channel as ITextChannel).GuildId}")}/{channel.Id}/{msg.Id}";
         }
+
+        /// <summary>
+        ///     Add multiple reactions to a message.
+        /// </summary>
+        /// <remarks>
+        ///     This method does not bulk add reactions! It will send a request for each reaction inculded.
+        /// </remarks>
+        /// <example>
+        /// <code language="cs">
+        /// IEmote A = new Emoji("🅰");
+        /// IEmote B = new Emoji("🅱");
+        /// await msg.AddReactionsAsync(new[] { A, B });
+        /// </code>
+        /// </example>
+        /// <param name="msg">The message to add reactions to.</param>
+        /// <param name="reactions">An array of reactions to add to the message</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for adding a reaction to this message.
+        /// </returns>
+        /// <seealso cref="IUserMessage.AddReactionAsync(IEmote, RequestOptions)"/>
+        /// <seealso cref="IEmote"/>
+        public static async Task AddReactionsAsync(this IUserMessage msg, IEmote[] reactions, RequestOptions options = null)
+        {
+            foreach (var rxn in reactions)
+                await msg.AddReactionAsync(rxn, options).ConfigureAwait(false);
+        }
+        /// <summary>
+        ///     Remove multiple reactions from a message.
+        /// </summary>
+        /// <remarks>
+        ///     This method does not bulk remove reactions! If you want to clear reactions from a message,
+        ///     <see cref="IUserMessage.RemoveAllReactionsAsync(RequestOptions)"/>
+        /// </remarks>
+        /// <example>
+        /// <code language="cs">
+        /// await msg.RemoveReactionsAsync(currentUser, new[] { A, B });
+        /// </code>
+        /// </example>
+        /// <param name="msg">The message to remove reactions from.</param>
+        /// <param name="reactions">An array of reactions to remove from the message</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous operation for removing a reaction to this message.
+        /// </returns>
+        /// <seealso cref="IUserMessage.RemoveReactionAsync(IEmote, IUser, RequestOptions)"/>
+        /// <seealso cref="IEmote"/>
+        public static async Task RemoveReactionsAsync(this IUserMessage msg, IUser user, IEmote[] reactions, RequestOptions options = null)
+        {
+            foreach (var rxn in reactions)
+                await msg.RemoveReactionAsync(rxn, user, options).ConfigureAwait(false);
+        }
     }
 }

From dca6c33da334bf048afcc81ac8a13eb6905b8946 Mon Sep 17 00:00:00 2001
From: jaypaw549 <17625734+jaypaw549@users.noreply.github.com>
Date: Wed, 28 Nov 2018 18:17:08 -0700
Subject: [PATCH 50/59] fix: Update ChannelCreateAuditLogData.cs (#1195)

---
 .../AuditLogs/DataTypes/ChannelCreateAuditLogData.cs      | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
index 51a19a0de..a692829f4 100644
--- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
+++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs
@@ -33,10 +33,10 @@ namespace Discord.Rest
 
             foreach (var overwrite in overwritesModel.NewValue)
             {
-                var deny = overwrite.Value<ulong>("deny");
-                var permType = overwrite.Value<PermissionTarget>("type");
-                var id = overwrite.Value<ulong>("id");
-                var allow = overwrite.Value<ulong>("allow");
+                var deny = overwrite["deny"].ToObject<ulong>(discord.ApiClient.Serializer);
+                var permType = overwrite["type"].ToObject<PermissionTarget>(discord.ApiClient.Serializer);
+                var id = overwrite["id"].ToObject<ulong>(discord.ApiClient.Serializer);
+                var allow = overwrite["allow"].ToObject<ulong>(discord.ApiClient.Serializer);
 
                 overwrites.Add(new Overwrite(id, permType, new OverwritePermissions(allow, deny)));
             }

From 7366cd4361bc5052766ad85e87066ea54075a15c Mon Sep 17 00:00:00 2001
From: Monica S <FiniteReality@users.noreply.github.com>
Date: Thu, 29 Nov 2018 01:18:16 +0000
Subject: [PATCH 51/59] feature: Implement Dispose for types which have
 disposable data (#1171)

* Initial set of dispose implementations

Not handled yet:
- Discord.Net.Websocket/Entities/SocketGuild
- Discord.Net.Tests

* Refactor DiscordSocketClient init into ctor

This way we remove an IDisposableAnalyzer warning for not disposing
the client when we set the client variable.

* Dispose of clients when disposing sharded client

* Finish implementing IDisposable where appropriate

I opted to use NoWarn in the Tests project as it wasn't really necessary
considering that our tests only run once

* Tweak samples after feedback
---
 samples/01_basic_ping_bot/Program.cs          | 13 ++++--
 samples/02_commands_framework/Program.cs      | 28 +++++++-----
 samples/03_sharded_client/Program.cs          | 37 +++++++++-------
 src/Discord.Net.Commands/CommandService.cs    | 26 +++++++++--
 .../Discord.Net.Commands.csproj               |  2 +-
 src/Discord.Net.Core/Discord.Net.Core.csproj  |  3 ++
 src/Discord.Net.Core/Entities/Image.cs        | 26 +++++++++--
 src/Discord.Net.Core/Net/Rest/IRestClient.cs  |  3 +-
 src/Discord.Net.Core/Net/Udp/IUdpSocket.cs    |  2 +-
 .../Net/WebSockets/IWebSocketClient.cs        |  2 +-
 .../WS4NetClient.cs                           | 22 +++++++---
 src/Discord.Net.Rest/BaseDiscordClient.cs     | 13 +++---
 src/Discord.Net.Rest/DiscordRestApiClient.cs  |  8 +++-
 src/Discord.Net.Rest/DiscordRestClient.cs     | 12 +++---
 .../Net/Converters/ImageConverter.cs          | 14 +++---
 src/Discord.Net.Rest/Net/DefaultRestClient.cs | 28 ++++++++----
 .../Net/Queue/RequestQueue.cs                 | 39 ++++++++++++-----
 .../Audio/AudioClient.cs                      | 25 +++++------
 .../Audio/Streams/BufferedWriteStream.cs      | 26 ++++++++---
 .../Audio/Streams/InputStream.cs              | 12 +++++-
 .../ConnectionManager.cs                      | 43 +++++++++++++++----
 .../DiscordShardedClient.cs                   | 35 ++++++++++++---
 .../DiscordSocketApiClient.cs                 |  5 ++-
 .../DiscordSocketClient.cs                    | 24 ++++++++---
 .../DiscordVoiceApiClient.cs                  | 14 +++---
 .../Entities/Guilds/SocketGuild.cs            | 20 ++++++++-
 .../Net/DefaultUdpSocket.cs                   | 27 +++++++++---
 .../Net/DefaultWebSocketClient.cs             | 35 ++++++++++-----
 .../Discord.Net.Webhook.csproj                |  2 +-
 .../Discord.Net.Tests.csproj                  |  1 +
 .../Discord.Net.Tests/Net/CachedRestClient.cs | 11 +++--
 31 files changed, 405 insertions(+), 153 deletions(-)

diff --git a/samples/01_basic_ping_bot/Program.cs b/samples/01_basic_ping_bot/Program.cs
index 973a6ce95..4d6674e97 100644
--- a/samples/01_basic_ping_bot/Program.cs
+++ b/samples/01_basic_ping_bot/Program.cs
@@ -16,21 +16,28 @@ namespace _01_basic_ping_bot
     // - https://github.com/foxbot/patek - a more feature-filled bot, utilizing more aspects of the library
     class Program
     {
-        private DiscordSocketClient _client;
+        private readonly DiscordSocketClient _client;
 
         // Discord.Net heavily utilizes TAP for async, so we create
         // an asynchronous context from the beginning.
         static void Main(string[] args)
-            => new Program().MainAsync().GetAwaiter().GetResult();
+        {
+            new Program().MainAsync().GetAwaiter().GetResult();
+        }
 
-        public async Task MainAsync()
+        public Program()
         {
+            // It is recommended to Dispose of a client when you are finished
+            // using it, at the end of your app's lifetime.
             _client = new DiscordSocketClient();
 
             _client.Log += LogAsync;
             _client.Ready += ReadyAsync;
             _client.MessageReceived += MessageReceivedAsync;
+        }
 
+        public async Task MainAsync()
+        {
             // Tokens should be considered secret data, and never hard-coded.
             await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
             await _client.StartAsync();
diff --git a/samples/02_commands_framework/Program.cs b/samples/02_commands_framework/Program.cs
index 136494bdf..76c11f9f0 100644
--- a/samples/02_commands_framework/Program.cs
+++ b/samples/02_commands_framework/Program.cs
@@ -19,24 +19,32 @@ namespace _02_commands_framework
     // - https://github.com/foxbot/patek - a more feature-filled bot, utilizing more aspects of the library
     class Program
     {
+        // There is no need to implement IDisposable like before as we are
+        // using dependency injection, which handles calling Dispose for us.
         static void Main(string[] args)
             => new Program().MainAsync().GetAwaiter().GetResult();
 
         public async Task MainAsync()
         {
-            var services = ConfigureServices();
+            // You should dispose a service provider created using ASP.NET
+            // when you are finished using it, at the end of your app's lifetime.
+            // If you use another dependency injection framework, you should inspect
+            // its documentation for the best way to do this.
+            using (var services = ConfigureServices())
+            {
+                var client = services.GetRequiredService<DiscordSocketClient>();
 
-            var client = services.GetRequiredService<DiscordSocketClient>();
+                client.Log += LogAsync;
+                services.GetRequiredService<CommandService>().Log += LogAsync;
 
-            client.Log += LogAsync;
-            services.GetRequiredService<CommandService>().Log += LogAsync;
+                // Tokens should be considered secret data, and never hard-coded.
+                await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
+                await client.StartAsync();
 
-            await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
-            await client.StartAsync();
+                await services.GetRequiredService<CommandHandlingService>().InitializeAsync();
 
-            await services.GetRequiredService<CommandHandlingService>().InitializeAsync();
-
-            await Task.Delay(-1);
+                await Task.Delay(-1);
+            }
         }
 
         private Task LogAsync(LogMessage log)
@@ -46,7 +54,7 @@ namespace _02_commands_framework
             return Task.CompletedTask;
         }
 
-        private IServiceProvider ConfigureServices()
+        private ServiceProvider ConfigureServices()
         {
             return new ServiceCollection()
                 .AddSingleton<DiscordSocketClient>()
diff --git a/samples/03_sharded_client/Program.cs b/samples/03_sharded_client/Program.cs
index 048145f9f..7a2f99168 100644
--- a/samples/03_sharded_client/Program.cs
+++ b/samples/03_sharded_client/Program.cs
@@ -13,41 +13,46 @@ namespace _03_sharded_client
     // DiscordSocketClient instances (or shards) to serve a large number of guilds.
     class Program
     {
-        private DiscordShardedClient _client;
-
         static void Main(string[] args)
             => new Program().MainAsync().GetAwaiter().GetResult();
         public async Task MainAsync()
         {
             // You specify the amount of shards you'd like to have with the
-            // DiscordSocketConfig. Generally, it's recommended to 
+            // DiscordSocketConfig. Generally, it's recommended to
             // have 1 shard per 1500-2000 guilds your bot is in.
             var config = new DiscordSocketConfig
             {
                 TotalShards = 2
             };
 
-            _client = new DiscordShardedClient(config);
-            var services = ConfigureServices();
+            // You should dispose a service provider created using ASP.NET
+            // when you are finished using it, at the end of your app's lifetime.
+            // If you use another dependency injection framework, you should inspect
+            // its documentation for the best way to do this.
+            using (var services = ConfigureServices(config))
+            {
+                var client = services.GetRequiredService<DiscordShardedClient>();
 
-            // The Sharded Client does not have a Ready event.
-            // The ShardReady event is used instead, allowing for individual
-            // control per shard.
-            _client.ShardReady += ReadyAsync;
-            _client.Log += LogAsync;
+                // The Sharded Client does not have a Ready event.
+                // The ShardReady event is used instead, allowing for individual
+                // control per shard.
+                client.ShardReady += ReadyAsync;
+                client.Log += LogAsync;
 
-            await services.GetRequiredService<CommandHandlingService>().InitializeAsync();
+                await services.GetRequiredService<CommandHandlingService>().InitializeAsync();
 
-            await _client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
-            await _client.StartAsync();
+                // Tokens should be considered secret data, and never hard-coded.
+                await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
+                await client.StartAsync();
 
-            await Task.Delay(-1);
+                await Task.Delay(-1);
+            }
         }
 
-        private IServiceProvider ConfigureServices()
+        private ServiceProvider ConfigureServices(DiscordSocketConfig config)
         {
             return new ServiceCollection()
-                .AddSingleton(_client)
+                .AddSingleton(new DiscordShardedClient(config))
                 .AddSingleton<CommandService>()
                 .AddSingleton<CommandHandlingService>()
                 .BuildServiceProvider();
diff --git a/src/Discord.Net.Commands/CommandService.cs b/src/Discord.Net.Commands/CommandService.cs
index d5b3f9ff4..c36aec4a5 100644
--- a/src/Discord.Net.Commands/CommandService.cs
+++ b/src/Discord.Net.Commands/CommandService.cs
@@ -27,7 +27,7 @@ namespace Discord.Commands
     ///         been successfully executed.
     ///     </para>
     /// </remarks>
-    public class CommandService
+    public class CommandService : IDisposable
     {
         /// <summary>
         ///     Occurs when a command-related information is received.
@@ -67,6 +67,8 @@ namespace Discord.Commands
         internal readonly LogManager _logManager;
         internal readonly IReadOnlyDictionary<char, char> _quotationMarkAliasMap;
 
+        internal bool _isDisposed;
+
         /// <summary>
         ///     Represents all modules loaded within <see cref="CommandService"/>.
         /// </summary>
@@ -330,9 +332,9 @@ namespace Discord.Commands
 
         //Type Readers
         /// <summary>
-        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object 
+        ///     Adds a custom <see cref="TypeReader" /> to this <see cref="CommandService" /> for the supplied object
         ///     type.
-        ///     If <typeparamref name="T" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> will 
+        ///     If <typeparamref name="T" /> is a <see cref="ValueType" />, a nullable <see cref="TypeReader" /> will
         ///     also be added.
         ///     If a default <see cref="TypeReader" /> exists for <typeparamref name="T" />, a warning will be logged
         ///     and the default <see cref="TypeReader" /> will be replaced.
@@ -607,5 +609,23 @@ namespace Discord.Commands
                 await _commandExecutedEvent.InvokeAsync(chosenOverload.Key.Command, context, result);
             return result;
         }
+
+        protected virtual void Dispose(bool disposing)
+        {
+            if (!_isDisposed)
+            {
+                if (disposing)
+                {
+                    _moduleLock?.Dispose();
+                }
+
+                _isDisposed = true;
+            }
+        }
+
+        void IDisposable.Dispose()
+        {
+            Dispose(true);
+        }
     }
 }
diff --git a/src/Discord.Net.Commands/Discord.Net.Commands.csproj b/src/Discord.Net.Commands/Discord.Net.Commands.csproj
index a754486dd..1bef1bfea 100644
--- a/src/Discord.Net.Commands/Discord.Net.Commands.csproj
+++ b/src/Discord.Net.Commands/Discord.Net.Commands.csproj
@@ -16,4 +16,4 @@
   <ItemGroup Condition=" '$(TargetFramework)' != 'netstandard2.0' ">
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="1.1.1" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/src/Discord.Net.Core/Discord.Net.Core.csproj b/src/Discord.Net.Core/Discord.Net.Core.csproj
index d4d450e1c..ff9b3c5e0 100644
--- a/src/Discord.Net.Core/Discord.Net.Core.csproj
+++ b/src/Discord.Net.Core/Discord.Net.Core.csproj
@@ -12,4 +12,7 @@
     <PackageReference Include="System.Collections.Immutable" Version="1.3.1" />
     <PackageReference Include="System.Interactive.Async" Version="3.1.1" />
   </ItemGroup>
+  <ItemGroup Condition=" '$(Configuration)' != 'Release' ">
+    <PackageReference Include="IDisposableAnalyzers" Version="2.0.3.3" />
+  </ItemGroup>
 </Project>
diff --git a/src/Discord.Net.Core/Entities/Image.cs b/src/Discord.Net.Core/Entities/Image.cs
index d5a9e26a3..3f5a01f6a 100644
--- a/src/Discord.Net.Core/Entities/Image.cs
+++ b/src/Discord.Net.Core/Entities/Image.cs
@@ -1,15 +1,21 @@
+using System;
 using System.IO;
+
 namespace Discord
 {
     /// <summary>
     ///     An image that will be uploaded to Discord.
     /// </summary>
-    public struct Image
+    public struct Image : IDisposable
     {
+        private bool _isDisposed;
+
         /// <summary>
         ///     Gets the stream to be uploaded to Discord.
         /// </summary>
+#pragma warning disable IDISP008
         public Stream Stream { get; }
+#pragma warning restore IDISP008
         /// <summary>
         ///     Create the image with a <see cref="System.IO.Stream"/>.
         /// </summary>
@@ -19,6 +25,7 @@ namespace Discord
         /// </param>
         public Image(Stream stream)
         {
+            _isDisposed = false;
             Stream = stream;
         }
 
@@ -45,15 +52,28 @@ namespace Discord
         /// The specified <paramref name="path"/> is invalid, (for example, it is on an unmapped drive).
         /// </exception>
         /// <exception cref="System.UnauthorizedAccessException">
-        /// <paramref name="path" /> specified a directory.-or- The caller does not have the required permission. 
+        /// <paramref name="path" /> specified a directory.-or- The caller does not have the required permission.
         /// </exception>
-        /// <exception cref="FileNotFoundException">The file specified in <paramref name="path" /> was not found. 
+        /// <exception cref="FileNotFoundException">The file specified in <paramref name="path" /> was not found.
         /// </exception>
         /// <exception cref="IOException">An I/O error occurred while opening the file. </exception>
         public Image(string path)
         {
+            _isDisposed = false;
             Stream = File.OpenRead(path);
         }
 
+        /// <inheritdoc/>
+        public void Dispose()
+        {
+            if (!_isDisposed)
+            {
+#pragma warning disable IDISP007
+                Stream?.Dispose();
+#pragma warning restore IDISP007
+
+                _isDisposed = true;
+            }
+        }
     }
 }
diff --git a/src/Discord.Net.Core/Net/Rest/IRestClient.cs b/src/Discord.Net.Core/Net/Rest/IRestClient.cs
index 2e30d2ef4..71010f70d 100644
--- a/src/Discord.Net.Core/Net/Rest/IRestClient.cs
+++ b/src/Discord.Net.Core/Net/Rest/IRestClient.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
@@ -7,7 +8,7 @@ namespace Discord.Net.Rest
     /// <summary>
     ///     Represents a generic REST-based client.
     /// </summary>
-    public interface IRestClient
+    public interface IRestClient : IDisposable
     {
         /// <summary>
         ///     Sets the HTTP header of this client for all requests.
diff --git a/src/Discord.Net.Core/Net/Udp/IUdpSocket.cs b/src/Discord.Net.Core/Net/Udp/IUdpSocket.cs
index 10ac652b3..ed2881d1f 100644
--- a/src/Discord.Net.Core/Net/Udp/IUdpSocket.cs
+++ b/src/Discord.Net.Core/Net/Udp/IUdpSocket.cs
@@ -4,7 +4,7 @@ using System.Threading.Tasks;
 
 namespace Discord.Net.Udp
 {
-    public interface IUdpSocket
+    public interface IUdpSocket : IDisposable
     {
         event Func<byte[], int, int, Task> ReceivedDatagram;
 
diff --git a/src/Discord.Net.Core/Net/WebSockets/IWebSocketClient.cs b/src/Discord.Net.Core/Net/WebSockets/IWebSocketClient.cs
index 7eccaabf2..14b41cce1 100644
--- a/src/Discord.Net.Core/Net/WebSockets/IWebSocketClient.cs
+++ b/src/Discord.Net.Core/Net/WebSockets/IWebSocketClient.cs
@@ -4,7 +4,7 @@ using System.Threading.Tasks;
 
 namespace Discord.Net.WebSockets
 {
-    public interface IWebSocketClient
+    public interface IWebSocketClient : IDisposable
     {
         event Func<byte[], int, int, Task> BinaryMessage;
         event Func<string, Task> TextMessage;
diff --git a/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs b/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
index afc01f87a..ef99c8045 100644
--- a/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
+++ b/src/Discord.Net.Providers.WS4Net/WS4NetClient.cs
@@ -19,6 +19,7 @@ namespace Discord.Net.Providers.WS4Net
         private readonly SemaphoreSlim _lock;
         private readonly Dictionary<string, string> _headers;
         private WS4NetSocket _client;
+        private CancellationTokenSource _disconnectCancelTokenSource;
         private CancellationTokenSource _cancelTokenSource;
         private CancellationToken _cancelToken, _parentToken;
         private ManualResetEventSlim _waitUntilConnect;
@@ -28,7 +29,7 @@ namespace Discord.Net.Providers.WS4Net
         {
             _headers = new Dictionary<string, string>();
             _lock = new SemaphoreSlim(1, 1);
-            _cancelTokenSource = new CancellationTokenSource();
+            _disconnectCancelTokenSource = new CancellationTokenSource();
             _cancelToken = CancellationToken.None;
             _parentToken = CancellationToken.None;
             _waitUntilConnect = new ManualResetEventSlim();
@@ -38,7 +39,11 @@ namespace Discord.Net.Providers.WS4Net
             if (!_isDisposed)
             {
                 if (disposing)
+                {
                     DisconnectInternalAsync(true).GetAwaiter().GetResult();
+                    _lock?.Dispose();
+                    _cancelTokenSource?.Dispose();
+                }
                 _isDisposed = true;
             }
         }
@@ -63,8 +68,13 @@ namespace Discord.Net.Providers.WS4Net
         {
             await DisconnectInternalAsync().ConfigureAwait(false);
 
-            _cancelTokenSource = new CancellationTokenSource();
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _disconnectCancelTokenSource?.Dispose();
+            _cancelTokenSource?.Dispose();
+            _client?.Dispose();
+
+            _disconnectCancelTokenSource = new CancellationTokenSource();
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _disconnectCancelTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
 
             _client = new WS4NetSocket(host, "", customHeaderItems: _headers.ToList())
             {
@@ -96,7 +106,7 @@ namespace Discord.Net.Providers.WS4Net
         }
         private Task DisconnectInternalAsync(bool isDisposing = false)
         {
-            _cancelTokenSource.Cancel();
+            _disconnectCancelTokenSource.Cancel();
             if (_client == null)
                 return Task.Delay(0);
 
@@ -125,8 +135,10 @@ namespace Discord.Net.Providers.WS4Net
         }
         public void SetCancelToken(CancellationToken cancelToken)
         {
+            _cancelTokenSource?.Dispose();
             _parentToken = cancelToken;
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _disconnectCancelTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
         }
 
         public async Task SendAsync(byte[] data, int index, int count, bool isText)
diff --git a/src/Discord.Net.Rest/BaseDiscordClient.cs b/src/Discord.Net.Rest/BaseDiscordClient.cs
index b584f5764..fc938d04d 100644
--- a/src/Discord.Net.Rest/BaseDiscordClient.cs
+++ b/src/Discord.Net.Rest/BaseDiscordClient.cs
@@ -34,7 +34,7 @@ namespace Discord.Rest
         public ISelfUser CurrentUser { get; protected set; }
         /// <inheritdoc />
         public TokenType TokenType => ApiClient.AuthTokenType;
-        
+
         /// <summary> Creates a new REST-only Discord client. </summary>
         internal BaseDiscordClient(DiscordRestConfig config, API.DiscordRestApiClient client)
         {
@@ -106,9 +106,9 @@ namespace Discord.Rest
 
             await _loggedInEvent.InvokeAsync().ConfigureAwait(false);
         }
-        internal virtual Task OnLoginAsync(TokenType tokenType, string token) 
+        internal virtual Task OnLoginAsync(TokenType tokenType, string token)
             => Task.Delay(0);
-        
+
         public async Task LogoutAsync()
         {
             await _stateLock.WaitAsync().ConfigureAwait(false);
@@ -131,14 +131,17 @@ namespace Discord.Rest
 
             await _loggedOutEvent.InvokeAsync().ConfigureAwait(false);
         }
-        internal virtual Task OnLogoutAsync() 
+        internal virtual Task OnLogoutAsync()
             => Task.Delay(0);
 
         internal virtual void Dispose(bool disposing)
         {
             if (!_isDisposed)
             {
+#pragma warning disable IDISP007
                 ApiClient.Dispose();
+#pragma warning restore IDISP007
+                _stateLock?.Dispose();
                 _isDisposed = true;
             }
         }
@@ -156,7 +159,7 @@ namespace Discord.Rest
         ISelfUser IDiscordClient.CurrentUser => CurrentUser;
 
         /// <inheritdoc />
-        Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options) 
+        Task<IApplication> IDiscordClient.GetApplicationInfoAsync(RequestOptions options)
             => throw new NotSupportedException();
 
         /// <inheritdoc />
diff --git a/src/Discord.Net.Rest/DiscordRestApiClient.cs b/src/Discord.Net.Rest/DiscordRestApiClient.cs
index 57d7c718a..eeeea4139 100644
--- a/src/Discord.Net.Rest/DiscordRestApiClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestApiClient.cs
@@ -66,6 +66,7 @@ namespace Discord.API
         /// <exception cref="ArgumentException">Unknown OAuth token type.</exception>
         internal void SetBaseUrl(string baseUrl)
         {
+            RestClient?.Dispose();
             RestClient = _restClientProvider(baseUrl);
             RestClient.SetHeader("accept", "*/*");
             RestClient.SetHeader("user-agent", UserAgent);
@@ -93,7 +94,9 @@ namespace Discord.API
                 if (disposing)
                 {
                     _loginCancelToken?.Dispose();
-                    (RestClient as IDisposable)?.Dispose();
+                    RestClient?.Dispose();
+                    RequestQueue?.Dispose();
+                    _stateLock?.Dispose();
                 }
                 _isDisposed = true;
             }
@@ -117,6 +120,7 @@ namespace Discord.API
 
             try
             {
+                _loginCancelToken?.Dispose();
                 _loginCancelToken = new CancellationTokenSource();
 
                 AuthToken = null;
@@ -242,7 +246,7 @@ namespace Discord.API
         internal Task<TResponse> SendMultipartAsync<TResponse>(string method, Expression<Func<string>> endpointExpr, IReadOnlyDictionary<string, object> multipartArgs, BucketIds ids,
              ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null, [CallerMemberName] string funcName = null)
             => SendMultipartAsync<TResponse>(method, GetEndpoint(endpointExpr), multipartArgs, GetBucketId(ids, endpointExpr, funcName), clientBucket, options);
-        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs, 
+        public async Task<TResponse> SendMultipartAsync<TResponse>(string method, string endpoint, IReadOnlyDictionary<string, object> multipartArgs,
             string bucketId = null, ClientBucketType clientBucket = ClientBucketType.Unbucketed, RequestOptions options = null)
         {
             options = options ?? new RequestOptions();
diff --git a/src/Discord.Net.Rest/DiscordRestClient.cs b/src/Discord.Net.Rest/DiscordRestClient.cs
index e36353855..f96d5dd0b 100644
--- a/src/Discord.Net.Rest/DiscordRestClient.cs
+++ b/src/Discord.Net.Rest/DiscordRestClient.cs
@@ -31,6 +31,8 @@ namespace Discord.Rest
         {
             if (disposing)
                 ApiClient.Dispose();
+
+            base.Dispose(disposing);
         }
 
         /// <inheritdoc />
@@ -46,12 +48,12 @@ namespace Discord.Rest
             _applicationInfo = null;
             return Task.Delay(0);
         }
-        
+
         public async Task<RestApplication> GetApplicationInfoAsync(RequestOptions options = null)
         {
             return _applicationInfo ?? (_applicationInfo = await ClientHelper.GetApplicationInfoAsync(this, options).ConfigureAwait(false));
         }
-        
+
         public Task<RestChannel> GetChannelAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetChannelAsync(this, id, options);
         public Task<IReadOnlyCollection<IRestPrivateChannel>> GetPrivateChannelsAsync(RequestOptions options = null)
@@ -60,7 +62,7 @@ namespace Discord.Rest
             => ClientHelper.GetDMChannelsAsync(this, options);
         public Task<IReadOnlyCollection<RestGroupChannel>> GetGroupChannelsAsync(RequestOptions options = null)
             => ClientHelper.GetGroupChannelsAsync(this, options);
-        
+
         public Task<IReadOnlyCollection<RestConnection>> GetConnectionsAsync(RequestOptions options = null)
             => ClientHelper.GetConnectionsAsync(this, options);
 
@@ -79,12 +81,12 @@ namespace Discord.Rest
             => ClientHelper.GetGuildsAsync(this, options);
         public Task<RestGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null)
             => ClientHelper.CreateGuildAsync(this, name, region, jpegIcon, options);
-        
+
         public Task<RestUser> GetUserAsync(ulong id, RequestOptions options = null)
             => ClientHelper.GetUserAsync(this, id, options);
         public Task<RestGuildUser> GetGuildUserAsync(ulong guildId, ulong id, RequestOptions options = null)
             => ClientHelper.GetGuildUserAsync(this, guildId, id, options);
-        
+
         public Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
             => ClientHelper.GetVoiceRegionsAsync(this, options);
         public Task<RestVoiceRegion> GetVoiceRegionAsync(string id, RequestOptions options = null)
diff --git a/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs b/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
index 9bbcfb8a3..941a35bf1 100644
--- a/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
+++ b/src/Discord.Net.Rest/Net/Converters/ImageConverter.cs
@@ -34,12 +34,14 @@ namespace Discord.Net.Converters
                 }
                 else
                 {
-                    var cloneStream = new MemoryStream();
-                    image.Stream.CopyTo(cloneStream);
-                    bytes = new byte[cloneStream.Length];
-                    cloneStream.Position = 0;
-                    cloneStream.Read(bytes, 0, bytes.Length);
-                    length = (int)cloneStream.Length;
+                    using (var cloneStream = new MemoryStream())
+                    {
+                        image.Stream.CopyTo(cloneStream);
+                        bytes = new byte[cloneStream.Length];
+                        cloneStream.Position = 0;
+                        cloneStream.Read(bytes, 0, bytes.Length);
+                        length = (int)cloneStream.Length;
+                    }
                 }
 
                 string base64 = Convert.ToBase64String(bytes, 0, length);
diff --git a/src/Discord.Net.Rest/Net/DefaultRestClient.cs b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
index 05a568198..b5036d94e 100644
--- a/src/Discord.Net.Rest/Net/DefaultRestClient.cs
+++ b/src/Discord.Net.Rest/Net/DefaultRestClient.cs
@@ -27,12 +27,14 @@ namespace Discord.Net.Rest
         {
             _baseUrl = baseUrl;
 
+#pragma warning disable IDISP014
             _client = new HttpClient(new HttpClientHandler
             {
                 AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate,
                 UseCookies = false,
                 UseProxy = useProxy,
             });
+#pragma warning restore IDISP014
             SetHeader("accept-encoding", "gzip, deflate");
 
             _cancelToken = CancellationToken.None;
@@ -91,12 +93,14 @@ namespace Discord.Net.Rest
             {
                 if (reason != null) restRequest.Headers.Add("X-Audit-Log-Reason", Uri.EscapeDataString(reason));
                 var content = new MultipartFormDataContent("Upload----" + DateTime.Now.ToString(CultureInfo.InvariantCulture));
+                MemoryStream memoryStream = null;
                 if (multipartParams != null)
                 {
                     foreach (var p in multipartParams)
                     {
                         switch (p.Value)
                         {
+#pragma warning disable IDISP004
                             case string stringValue: { content.Add(new StringContent(stringValue), p.Key); continue; }
                             case byte[] byteArrayValue: { content.Add(new ByteArrayContent(byteArrayValue), p.Key); continue; }
                             case Stream streamValue: { content.Add(new StreamContent(streamValue), p.Key); continue; }
@@ -105,12 +109,15 @@ namespace Discord.Net.Rest
                                 var stream = fileValue.Stream;
                                 if (!stream.CanSeek)
                                 {
-                                    var memoryStream = new MemoryStream();
+                                    memoryStream = new MemoryStream();
                                     await stream.CopyToAsync(memoryStream).ConfigureAwait(false);
                                     memoryStream.Position = 0;
+#pragma warning disable IDISP001
                                     stream = memoryStream;
+#pragma warning restore IDISP001
                                 }
                                 content.Add(new StreamContent(stream), p.Key, fileValue.Filename);
+#pragma warning restore IDISP004
                                 continue;
                             }
                             default: throw new InvalidOperationException($"Unsupported param type \"{p.Value.GetType().Name}\".");
@@ -118,19 +125,24 @@ namespace Discord.Net.Rest
                     }
                 }
                 restRequest.Content = content;
-                return await SendInternalAsync(restRequest, cancelToken, headerOnly).ConfigureAwait(false);
+                var result = await SendInternalAsync(restRequest, cancelToken, headerOnly).ConfigureAwait(false);
+                memoryStream?.Dispose();
+                return result;
             }
         }
 
         private async Task<RestResponse> SendInternalAsync(HttpRequestMessage request, CancellationToken cancelToken, bool headerOnly)
         {
-            cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_cancelToken, cancelToken).Token;
-            HttpResponseMessage response = await _client.SendAsync(request, cancelToken).ConfigureAwait(false);
-            
-            var headers = response.Headers.ToDictionary(x => x.Key, x => x.Value.FirstOrDefault(), StringComparer.OrdinalIgnoreCase);
-            var stream = !headerOnly ? await response.Content.ReadAsStreamAsync().ConfigureAwait(false) : null;
+            using (var cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_cancelToken, cancelToken))
+            {
+                cancelToken = cancelTokenSource.Token;
+                HttpResponseMessage response = await _client.SendAsync(request, cancelToken).ConfigureAwait(false);
 
-            return new RestResponse(response.StatusCode, headers, stream);
+                var headers = response.Headers.ToDictionary(x => x.Key, x => x.Value.FirstOrDefault(), StringComparer.OrdinalIgnoreCase);
+                var stream = !headerOnly ? await response.Content.ReadAsStreamAsync().ConfigureAwait(false) : null;
+
+                return new RestResponse(response.StatusCode, headers, stream);
+            }
         }
 
         private static readonly HttpMethod Patch = new HttpMethod("PATCH");
diff --git a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
index 1b4830da2..4baf76433 100644
--- a/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
+++ b/src/Discord.Net.Rest/Net/Queue/RequestQueue.cs
@@ -16,23 +16,24 @@ namespace Discord.Net.Queue
 
         private readonly ConcurrentDictionary<string, RequestBucket> _buckets;
         private readonly SemaphoreSlim _tokenLock;
-        private readonly CancellationTokenSource _cancelToken; //Dispose token
+        private readonly CancellationTokenSource _cancelTokenSource; //Dispose token
         private CancellationTokenSource _clearToken;
         private CancellationToken _parentToken;
+        private CancellationTokenSource _requestCancelTokenSource;
         private CancellationToken _requestCancelToken; //Parent token + Clear token
         private DateTimeOffset _waitUntil;
 
         private Task _cleanupTask;
-        
+
         public RequestQueue()
         {
             _tokenLock = new SemaphoreSlim(1, 1);
 
             _clearToken = new CancellationTokenSource();
-            _cancelToken = new CancellationTokenSource();
+            _cancelTokenSource = new CancellationTokenSource();
             _requestCancelToken = CancellationToken.None;
             _parentToken = CancellationToken.None;
-            
+
             _buckets = new ConcurrentDictionary<string, RequestBucket>();
 
             _cleanupTask = RunCleanup();
@@ -44,7 +45,9 @@ namespace Discord.Net.Queue
             try
             {
                 _parentToken = cancelToken;
-                _requestCancelToken = CancellationTokenSource.CreateLinkedTokenSource(cancelToken, _clearToken.Token).Token;
+                _requestCancelTokenSource?.Dispose();
+                _requestCancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(cancelToken, _clearToken.Token);
+                _requestCancelToken = _requestCancelTokenSource.Token;
             }
             finally { _tokenLock.Release(); }
         }
@@ -54,9 +57,14 @@ namespace Discord.Net.Queue
             try
             {
                 _clearToken?.Cancel();
+                _clearToken?.Dispose();
                 _clearToken = new CancellationTokenSource();
                 if (_parentToken != null)
-                    _requestCancelToken = CancellationTokenSource.CreateLinkedTokenSource(_clearToken.Token, _parentToken).Token;
+                {
+                    _requestCancelTokenSource?.Dispose();
+                    _requestCancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_clearToken.Token, _parentToken);
+                    _requestCancelToken = _requestCancelTokenSource.Token;
+                }
                 else
                     _requestCancelToken = _clearToken.Token;
             }
@@ -65,13 +73,19 @@ namespace Discord.Net.Queue
 
         public async Task<Stream> SendAsync(RestRequest request)
         {
+            CancellationTokenSource createdTokenSource = null;
             if (request.Options.CancelToken.CanBeCanceled)
-                request.Options.CancelToken = CancellationTokenSource.CreateLinkedTokenSource(_requestCancelToken, request.Options.CancelToken).Token;
+            {
+                createdTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_requestCancelToken, request.Options.CancelToken);
+                request.Options.CancelToken = createdTokenSource.Token;
+            }
             else
                 request.Options.CancelToken = _requestCancelToken;
 
             var bucket = GetOrCreateBucket(request.Options.BucketId, request);
-            return await bucket.SendAsync(request).ConfigureAwait(false);
+            var result = await bucket.SendAsync(request).ConfigureAwait(false);
+            createdTokenSource?.Dispose();
+            return result;
         }
         public async Task SendAsync(WebSocketRequest request)
         {
@@ -109,7 +123,7 @@ namespace Discord.Net.Queue
         {
             try
             {
-                while (!_cancelToken.IsCancellationRequested)
+                while (!_cancelTokenSource.IsCancellationRequested)
                 {
                     var now = DateTimeOffset.UtcNow;
                     foreach (var bucket in _buckets.Select(x => x.Value))
@@ -117,7 +131,7 @@ namespace Discord.Net.Queue
                         if ((now - bucket.LastAttemptAt).TotalMinutes > 1.0)
                             _buckets.TryRemove(bucket.Id, out _);
                     }
-                    await Task.Delay(60000, _cancelToken.Token).ConfigureAwait(false); //Runs each minute
+                    await Task.Delay(60000, _cancelTokenSource.Token).ConfigureAwait(false); //Runs each minute
                 }
             }
             catch (OperationCanceledException) { }
@@ -126,7 +140,10 @@ namespace Discord.Net.Queue
 
         public void Dispose()
         {
-            _cancelToken.Dispose();
+            _cancelTokenSource?.Dispose();
+            _tokenLock?.Dispose();
+            _clearToken?.Dispose();
+            _requestCancelTokenSource?.Dispose();
         }
     }
 }
diff --git a/src/Discord.Net.WebSocket/Audio/AudioClient.cs b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
index 800e04933..2210e019f 100644
--- a/src/Discord.Net.WebSocket/Audio/AudioClient.cs
+++ b/src/Discord.Net.WebSocket/Audio/AudioClient.cs
@@ -71,7 +71,7 @@ namespace Discord.Audio
             ApiClient.ReceivedPacket += ProcessPacketAsync;
 
             _stateLock = new SemaphoreSlim(1, 1);
-            _connection = new ConnectionManager(_stateLock, _audioLogger, 30000, 
+            _connection = new ConnectionManager(_stateLock, _audioLogger, 30000,
                 OnConnectingAsync, OnDisconnectingAsync, x => ApiClient.Disconnected += x);
             _connection.Connected += () => _connectedEvent.InvokeAsync();
             _connection.Disconnected += (ex, recon) => _disconnectedEvent.InvokeAsync(ex);
@@ -79,7 +79,7 @@ namespace Discord.Audio
             _keepaliveTimes = new ConcurrentQueue<KeyValuePair<ulong, int>>();
             _ssrcMap = new ConcurrentDictionary<uint, ulong>();
             _streams = new ConcurrentDictionary<ulong, StreamPair>();
-            
+
             _serializer = new JsonSerializer { ContractResolver = new DiscordContractResolver() };
             _serializer.Error += (s, e) =>
             {
@@ -91,7 +91,7 @@ namespace Discord.Audio
             UdpLatencyUpdated += async (old, val) => await _audioLogger.DebugAsync($"UDP Latency = {val} ms").ConfigureAwait(false);
         }
 
-        internal async Task StartAsync(string url, ulong userId, string sessionId, string token) 
+        internal async Task StartAsync(string url, ulong userId, string sessionId, string token)
         {
             _url = url;
             _userId = userId;
@@ -100,7 +100,7 @@ namespace Discord.Audio
             await _connection.StartAsync().ConfigureAwait(false);
         }
         public async Task StopAsync()
-        { 
+        {
             await _connection.StopAsync().ConfigureAwait(false);
         }
 
@@ -225,11 +225,11 @@ namespace Discord.Audio
 
                             if (!data.Modes.Contains(DiscordVoiceAPIClient.Mode))
                                 throw new InvalidOperationException($"Discord does not support {DiscordVoiceAPIClient.Mode}");
-                            
+
                             ApiClient.SetUdpEndpoint(data.Ip, data.Port);
                             await ApiClient.SendDiscoveryAsync(_ssrc).ConfigureAwait(false);
 
-                            
+
                             _heartbeatTask = RunHeartbeatAsync(41250, _connection.CancelToken);
                         }
                         break;
@@ -305,9 +305,9 @@ namespace Discord.Audio
                     catch (Exception ex)
                     {
                         await _audioLogger.DebugAsync("Malformed Packet", ex).ConfigureAwait(false);
-                        return; 
+                        return;
                     }
-                    
+
                     await _audioLogger.DebugAsync("Received Discovery").ConfigureAwait(false);
                     await ApiClient.SendSelectProtocol(ip, port).ConfigureAwait(false);
                 }
@@ -317,7 +317,7 @@ namespace Discord.Audio
                     {
                         await _audioLogger.DebugAsync("Received Keepalive").ConfigureAwait(false);
 
-                        ulong value = 
+                        ulong value =
                             ((ulong)packet[0] >> 0) |
                             ((ulong)packet[1] >> 8) |
                             ((ulong)packet[2] >> 16) |
@@ -341,7 +341,7 @@ namespace Discord.Audio
                         }
                     }
                     else
-                    {                        
+                    {
                         if (!RTPReadStream.TryReadSsrc(packet, 0, out var ssrc))
                         {
                             await _audioLogger.DebugAsync("Malformed Frame").ConfigureAwait(false);
@@ -388,7 +388,7 @@ namespace Discord.Audio
                     var now = Environment.TickCount;
 
                     //Did server respond to our last heartbeat?
-                    if (_heartbeatTimes.Count != 0 && (now - _lastMessageTime) > intervalMillis && 
+                    if (_heartbeatTimes.Count != 0 && (now - _lastMessageTime) > intervalMillis &&
                         ConnectionState == ConnectionState.Connected)
                     {
                         _connection.Error(new Exception("Server missed last heartbeat"));
@@ -437,7 +437,7 @@ namespace Discord.Audio
                     {
                         await _audioLogger.WarningAsync("Failed to send keepalive", ex).ConfigureAwait(false);
                     }
-                    
+
                     await Task.Delay(intervalMillis, cancelToken).ConfigureAwait(false);
                 }
                 await _audioLogger.DebugAsync("Keepalive Stopped").ConfigureAwait(false);
@@ -467,6 +467,7 @@ namespace Discord.Audio
             {
                 StopAsync().GetAwaiter().GetResult();
                 ApiClient.Dispose();
+                _stateLock?.Dispose();
             }
         }
         /// <inheritdoc />
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
index 47a7e2809..16ad0ae89 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/BufferedWriteStream.cs
@@ -27,7 +27,7 @@ namespace Discord.Audio.Streams
 
         private readonly AudioClient _client;
         private readonly AudioStream _next;
-        private readonly CancellationTokenSource _cancelTokenSource;
+        private readonly CancellationTokenSource _disposeTokenSource, _cancelTokenSource;
         private readonly CancellationToken _cancelToken;
         private readonly Task _task;
         private readonly ConcurrentQueue<Frame> _queuedFrames;
@@ -49,12 +49,13 @@ namespace Discord.Audio.Streams
             _logger = logger;
             _queueLength = (bufferMillis + (_ticksPerFrame - 1)) / _ticksPerFrame; //Round up
 
-            _cancelTokenSource = new CancellationTokenSource();
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_cancelTokenSource.Token, cancelToken).Token;
+            _disposeTokenSource = new CancellationTokenSource();
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_disposeTokenSource.Token, cancelToken);
+            _cancelToken = _cancelTokenSource.Token;
             _queuedFrames = new ConcurrentQueue<Frame>();
             _bufferPool = new ConcurrentQueue<byte[]>();
             for (int i = 0; i < _queueLength; i++)
-                _bufferPool.Enqueue(new byte[maxFrameSize]); 
+                _bufferPool.Enqueue(new byte[maxFrameSize]);
             _queueLock = new SemaphoreSlim(_queueLength, _queueLength);
             _silenceFrames = MaxSilenceFrames;
 
@@ -63,7 +64,12 @@ namespace Discord.Audio.Streams
         protected override void Dispose(bool disposing)
         {
             if (disposing)
-                _cancelTokenSource.Cancel();
+            {
+                _disposeTokenSource?.Cancel();
+                _disposeTokenSource?.Dispose();
+                _cancelTokenSource?.Dispose();
+                _queueLock?.Dispose();
+            }
             base.Dispose(disposing);
         }
 
@@ -131,8 +137,12 @@ namespace Discord.Audio.Streams
         public override void WriteHeader(ushort seq, uint timestamp, bool missed) { } //Ignore, we use our own timing
         public override async Task WriteAsync(byte[] data, int offset, int count, CancellationToken cancelToken)
         {
+            CancellationTokenSource writeCancelToken = null;
             if (cancelToken.CanBeCanceled)
-                cancelToken = CancellationTokenSource.CreateLinkedTokenSource(cancelToken, _cancelToken).Token;
+            {
+                writeCancelToken = CancellationTokenSource.CreateLinkedTokenSource(cancelToken, _cancelToken);
+                cancelToken = writeCancelToken.Token;
+            }
             else
                 cancelToken = _cancelToken;
 
@@ -142,6 +152,9 @@ namespace Discord.Audio.Streams
 #if DEBUG
                 var _ = _logger?.DebugAsync("Buffer overflow"); //Should never happen because of the queueLock
 #endif
+#pragma warning disable IDISP016
+                writeCancelToken?.Dispose();
+#pragma warning restore IDISP016
                 return;
             }
             Buffer.BlockCopy(data, offset, buffer, 0, count);
@@ -153,6 +166,7 @@ namespace Discord.Audio.Streams
 #endif
                 _isPreloaded = true;
             }
+            writeCancelToken?.Dispose();
         }
 
         public override async Task FlushAsync(CancellationToken cancelToken)
diff --git a/src/Discord.Net.WebSocket/Audio/Streams/InputStream.cs b/src/Discord.Net.WebSocket/Audio/Streams/InputStream.cs
index b9d6157ea..6233c47b5 100644
--- a/src/Discord.Net.WebSocket/Audio/Streams/InputStream.cs
+++ b/src/Discord.Net.WebSocket/Audio/Streams/InputStream.cs
@@ -96,7 +96,17 @@ namespace Discord.Audio.Streams
 
         protected override void Dispose(bool isDisposing)
         {
-            _isDisposed = true;
+            if (!_isDisposed)
+            {
+                if (isDisposing)
+                {
+                    _signal?.Dispose();
+                }
+
+                _isDisposed = true;
+            }
+
+            base.Dispose(isDisposing);
         }
     }
 }
diff --git a/src/Discord.Net.WebSocket/ConnectionManager.cs b/src/Discord.Net.WebSocket/ConnectionManager.cs
index decae4163..66f847c50 100644
--- a/src/Discord.Net.WebSocket/ConnectionManager.cs
+++ b/src/Discord.Net.WebSocket/ConnectionManager.cs
@@ -6,7 +6,7 @@ using Discord.Net;
 
 namespace Discord
 {
-    internal class ConnectionManager
+    internal class ConnectionManager : IDisposable
     {
         public event Func<Task> Connected { add { _connectedEvent.Add(value); } remove { _connectedEvent.Remove(value); } }
         private readonly AsyncEvent<Func<Task>> _connectedEvent = new AsyncEvent<Func<Task>>();
@@ -23,10 +23,12 @@ namespace Discord
         private CancellationTokenSource _combinedCancelToken, _reconnectCancelToken, _connectionCancelToken;
         private Task _task;
 
+        private bool _isDisposed;
+
         public ConnectionState State { get; private set; }
         public CancellationToken CancelToken { get; private set; }
 
-        internal ConnectionManager(SemaphoreSlim stateLock, Logger logger, int connectionTimeout, 
+        internal ConnectionManager(SemaphoreSlim stateLock, Logger logger, int connectionTimeout,
             Func<Task> onConnecting, Func<Exception, Task> onDisconnecting, Action<Func<Exception, Task>> clientDisconnectHandler)
         {
             _stateLock = stateLock;
@@ -55,6 +57,7 @@ namespace Discord
         {
             await AcquireConnectionLock().ConfigureAwait(false);
             var reconnectCancelToken = new CancellationTokenSource();
+            _reconnectCancelToken?.Dispose();
             _reconnectCancelToken = reconnectCancelToken;
             _task = Task.Run(async () =>
             {
@@ -67,16 +70,16 @@ namespace Discord
                         try
                         {
                             await ConnectAsync(reconnectCancelToken).ConfigureAwait(false);
-                            nextReconnectDelay = 1000; //Reset delay                          
+                            nextReconnectDelay = 1000; //Reset delay
                             await _connectionPromise.Task.ConfigureAwait(false);
                         }
-                        catch (OperationCanceledException ex) 
-                        { 
+                        catch (OperationCanceledException ex)
+                        {
                             Cancel(); //In case this exception didn't come from another Error call
                             await DisconnectAsync(ex, !reconnectCancelToken.IsCancellationRequested).ConfigureAwait(false);
                         }
-                        catch (Exception ex) 
-                        { 
+                        catch (Exception ex)
+                        {
                             Error(ex); //In case this exception didn't come from another Error call
                             if (!reconnectCancelToken.IsCancellationRequested)
                             {
@@ -113,6 +116,8 @@ namespace Discord
 
         private async Task ConnectAsync(CancellationTokenSource reconnectCancelToken)
         {
+            _connectionCancelToken?.Dispose();
+            _combinedCancelToken?.Dispose();
             _connectionCancelToken = new CancellationTokenSource();
             _combinedCancelToken = CancellationTokenSource.CreateLinkedTokenSource(_connectionCancelToken.Token, reconnectCancelToken.Token);
             CancelToken = _combinedCancelToken.Token;
@@ -120,7 +125,7 @@ namespace Discord
             _connectionPromise = new TaskCompletionSource<bool>();
             State = ConnectionState.Connecting;
             await _logger.InfoAsync("Connecting").ConfigureAwait(false);
-            
+
             try
             {
                 var readyPromise = new TaskCompletionSource<bool>();
@@ -206,5 +211,25 @@ namespace Discord
                     break;
             }
         }
+
+        protected virtual void Dispose(bool disposing)
+        {
+            if (!_isDisposed)
+            {
+                if (disposing)
+                {
+                    _combinedCancelToken?.Dispose();
+                    _reconnectCancelToken?.Dispose();
+                    _connectionCancelToken?.Dispose();
+                }
+
+                _isDisposed = true;
+            }
+        }
+
+        public void Dispose()
+        {
+            Dispose(true);
+        }
     }
-}
\ No newline at end of file
+}
diff --git a/src/Discord.Net.WebSocket/DiscordShardedClient.cs b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
index 4e497346f..03969f535 100644
--- a/src/Discord.Net.WebSocket/DiscordShardedClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordShardedClient.cs
@@ -18,7 +18,9 @@ namespace Discord.WebSocket
         private int[] _shardIds;
         private DiscordSocketClient[] _shards;
         private int _totalShards;
-        
+
+        private bool _isDisposed;
+
         /// <inheritdoc />
         public override int Latency { get => GetLatency(); protected set { } }
         /// <inheritdoc />
@@ -38,11 +40,15 @@ namespace Discord.WebSocket
         /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient() : this(null, new DiscordSocketConfig()) { }
         /// <summary> Creates a new REST/WebSocket Discord client. </summary>
+#pragma warning disable IDISP004
         public DiscordShardedClient(DiscordSocketConfig config) : this(null, config, CreateApiClient(config)) { }
+#pragma warning restore IDISP004
         /// <summary> Creates a new REST/WebSocket Discord client. </summary>
         public DiscordShardedClient(int[] ids) : this(ids, new DiscordSocketConfig()) { }
         /// <summary> Creates a new REST/WebSocket Discord client. </summary>
+#pragma warning disable IDISP004
         public DiscordShardedClient(int[] ids, DiscordSocketConfig config) : this(ids, config, CreateApiClient(config)) { }
+#pragma warning restore IDISP004
         private DiscordShardedClient(int[] ids, DiscordSocketConfig config, API.DiscordSocketApiClient client)
             : base(config, client)
         {
@@ -119,10 +125,10 @@ namespace Discord.WebSocket
         }
 
         /// <inheritdoc />
-        public override async Task StartAsync() 
+        public override async Task StartAsync()
             => await Task.WhenAll(_shards.Select(x => x.StartAsync())).ConfigureAwait(false);
         /// <inheritdoc />
-        public override async Task StopAsync() 
+        public override async Task StopAsync()
             => await Task.WhenAll(_shards.Select(x => x.StopAsync())).ConfigureAwait(false);
 
         public DiscordSocketClient GetShard(int id)
@@ -145,7 +151,7 @@ namespace Discord.WebSocket
             => await _shards[0].GetApplicationInfoAsync(options).ConfigureAwait(false);
 
         /// <inheritdoc />
-        public override SocketGuild GetGuild(ulong id) 
+        public override SocketGuild GetGuild(ulong id)
             => GetShardFor(id).GetGuild(id);
 
         /// <inheritdoc />
@@ -173,7 +179,7 @@ namespace Discord.WebSocket
             for (int i = 0; i < _shards.Length; i++)
                 result += _shards[i].PrivateChannels.Count;
             return result;
-        }                                                                    
+        }
 
         private IEnumerable<SocketGuild> GetGuilds()
         {
@@ -189,7 +195,7 @@ namespace Discord.WebSocket
             for (int i = 0; i < _shards.Length; i++)
                 result += _shards[i].Guilds.Count;
             return result;
-        }                    
+        }
 
         /// <inheritdoc />
         public override SocketUser GetUser(ulong id)
@@ -369,5 +375,22 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         Task<IVoiceRegion> IDiscordClient.GetVoiceRegionAsync(string id, RequestOptions options)
             => Task.FromResult<IVoiceRegion>(GetVoiceRegion(id));
+
+        internal override void Dispose(bool disposing)
+        {
+            if (!_isDisposed)
+            {
+                if (disposing)
+                {
+                    foreach (var client in _shards)
+                        client?.Dispose();
+                    _connectionGroupLock?.Dispose();
+                }
+
+                _isDisposed = true;
+            }
+
+            base.Dispose(disposing);
+        }
     }
 }
diff --git a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
index bc579793d..894ae66a8 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketApiClient.cs
@@ -108,6 +108,8 @@ namespace Discord.API
                 }
                 _isDisposed = true;
             }
+
+            base.Dispose(disposing);
         }
 
         public async Task ConnectAsync()
@@ -137,6 +139,7 @@ namespace Discord.API
             ConnectionState = ConnectionState.Connecting;
             try
             {
+                _connectCancelToken?.Dispose();
                 _connectCancelToken = new CancellationTokenSource();
                 if (WebSocketClient != null)
                     WebSocketClient.SetCancelToken(_connectCancelToken.Token);
@@ -209,7 +212,7 @@ namespace Discord.API
             await RequestQueue.SendAsync(new WebSocketRequest(WebSocketClient, null, bytes, true, options)).ConfigureAwait(false);
             await _sentGatewayMessageEvent.InvokeAsync(opCode).ConfigureAwait(false);
         }
-        
+
         public async Task SendIdentifyAsync(int largeThreshold = 100, int shardID = 0, int totalShards = 1, RequestOptions options = null)
         {
             options = RequestOptions.CreateOrClone(options);
diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
index 3d260d1a6..6b720645e 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
@@ -43,6 +43,8 @@ namespace Discord.WebSocket
         private DateTimeOffset? _statusSince;
         private RestApplication _applicationInfo;
 
+        private bool _isDisposed;
+
         /// <summary> Gets the shard of of this client. </summary>
         public int ShardId { get; }
         /// <summary> Gets the current connection state of this client. </summary>
@@ -63,7 +65,7 @@ namespace Discord.WebSocket
         internal WebSocketProvider WebSocketProvider { get; private set; }
         internal bool AlwaysDownloadUsers { get; private set; }
         internal int? HandlerTimeout { get; private set; }
-        
+
         internal new DiscordSocketApiClient ApiClient => base.ApiClient as DiscordSocketApiClient;
         /// <inheritdoc />
         public override IReadOnlyCollection<SocketGuild> Guilds => State.Guilds;
@@ -110,8 +112,10 @@ namespace Discord.WebSocket
         ///     Initializes a new REST/WebSocket-based Discord client with the provided configuration.
         /// </summary>
         /// <param name="config">The configuration to be used with the client.</param>
+#pragma warning disable IDISP004
         public DiscordSocketClient(DiscordSocketConfig config) : this(config, CreateApiClient(config), null, null) { }
         internal DiscordSocketClient(DiscordSocketConfig config, SemaphoreSlim groupLock, DiscordSocketClient parentClient) : this(config, CreateApiClient(config), groupLock, parentClient) { }
+#pragma warning restore IDISP004
         private DiscordSocketClient(DiscordSocketConfig config, API.DiscordSocketApiClient client, SemaphoreSlim groupLock, DiscordSocketClient parentClient)
             : base(config, client)
         {
@@ -170,11 +174,18 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         internal override void Dispose(bool disposing)
         {
-            if (disposing)
+            if (!_isDisposed)
             {
-                StopAsync().GetAwaiter().GetResult();
-                ApiClient.Dispose();
+                if (disposing)
+                {
+                    StopAsync().GetAwaiter().GetResult();
+                    ApiClient?.Dispose();
+                    _stateLock?.Dispose();
+                }
+                _isDisposed = true;
             }
+
+            base.Dispose(disposing);
         }
 
         /// <inheritdoc />
@@ -197,10 +208,10 @@ namespace Discord.WebSocket
         }
 
         /// <inheritdoc />
-        public override async Task StartAsync() 
+        public override async Task StartAsync()
             => await _connection.StartAsync().ConfigureAwait(false);
         /// <inheritdoc />
-        public override async Task StopAsync() 
+        public override async Task StopAsync()
             => await _connection.StopAsync().ConfigureAwait(false);
 
         private async Task OnConnectingAsync()
@@ -704,6 +715,7 @@ namespace Discord.WebSocket
                                         {
                                             await GuildUnavailableAsync(guild).ConfigureAwait(false);
                                             await TimedInvokeAsync(_leftGuildEvent, nameof(LeftGuild), guild).ConfigureAwait(false);
+                                            (guild as IDisposable).Dispose();
                                         }
                                         else
                                         {
diff --git a/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs b/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
index 80dec0fd4..f78145dbe 100644
--- a/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordVoiceApiClient.cs
@@ -16,7 +16,7 @@ using System.Threading.Tasks;
 
 namespace Discord.Audio
 {
-    internal class DiscordVoiceAPIClient
+    internal class DiscordVoiceAPIClient : IDisposable
     {
         public const int MaxBitrate = 128 * 1024;
         public const string Mode = "xsalsa20_poly1305";
@@ -36,7 +36,7 @@ namespace Discord.Audio
         private readonly AsyncEvent<Func<byte[], Task>> _receivedPacketEvent = new AsyncEvent<Func<byte[], Task>>();
         public event Func<Exception, Task> Disconnected { add { _disconnectedEvent.Add(value); } remove { _disconnectedEvent.Remove(value); } }
         private readonly AsyncEvent<Func<Exception, Task>> _disconnectedEvent = new AsyncEvent<Func<Exception, Task>>();
-        
+
         private readonly JsonSerializer _serializer;
         private readonly SemaphoreSlim _connectionLock;
         private readonly IUdpSocket _udp;
@@ -103,8 +103,9 @@ namespace Discord.Audio
                 if (disposing)
                 {
                     _connectCancelToken?.Dispose();
-                    (_udp as IDisposable)?.Dispose();
-                    (WebSocketClient as IDisposable)?.Dispose();
+                    _udp?.Dispose();
+                    WebSocketClient?.Dispose();
+                    _connectionLock?.Dispose();
                 }
                 _isDisposed = true;
             }
@@ -122,7 +123,7 @@ namespace Discord.Audio
         }
         public async Task SendAsync(byte[] data, int offset, int bytes)
         {
-            await _udp.SendAsync(data, offset, bytes).ConfigureAwait(false);                
+            await _udp.SendAsync(data, offset, bytes).ConfigureAwait(false);
             await _sentDataEvent.InvokeAsync(bytes).ConfigureAwait(false);
         }
 
@@ -177,6 +178,7 @@ namespace Discord.Audio
             ConnectionState = ConnectionState.Connecting;
             try
             {
+                _connectCancelToken?.Dispose();
                 _connectCancelToken = new CancellationTokenSource();
                 var cancelToken = _connectCancelToken.Token;
 
@@ -208,7 +210,7 @@ namespace Discord.Audio
         {
             if (ConnectionState == ConnectionState.Disconnected) return;
             ConnectionState = ConnectionState.Disconnecting;
-            
+
             try { _connectCancelToken?.Cancel(false); }
             catch { }
 
diff --git a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
index 4e4124679..ca2db1a77 100644
--- a/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
+++ b/src/Discord.Net.WebSocket/Entities/Guilds/SocketGuild.cs
@@ -25,8 +25,9 @@ namespace Discord.WebSocket
     ///     Represents a WebSocket-based guild object.
     /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
-    public class SocketGuild : SocketEntity<ulong>, IGuild
+    public class SocketGuild : SocketEntity<ulong>, IGuild, IDisposable
     {
+#pragma warning disable IDISP002, IDISP006
         private readonly SemaphoreSlim _audioLock;
         private TaskCompletionSource<bool> _syncPromise, _downloaderPromise;
         private TaskCompletionSource<AudioClient> _audioConnectPromise;
@@ -37,6 +38,7 @@ namespace Discord.WebSocket
         private ImmutableArray<GuildEmote> _emotes;
         private ImmutableArray<string> _features;
         private AudioClient _audioClient;
+#pragma warning restore IDISP002, IDISP006
 
         /// <inheritdoc />
         public string Name { get; private set; }
@@ -63,7 +65,7 @@ namespace Discord.WebSocket
         ///         number here is the most accurate in terms of counting the number of users within this guild.
         ///     </para>
         ///     <para>
-        ///         Use this instead of enumerating the count of the 
+        ///         Use this instead of enumerating the count of the
         ///         <see cref="Discord.WebSocket.SocketGuild.Users" /> collection, as you may see discrepancy
         ///         between that and this property.
         ///     </para>
@@ -872,9 +874,11 @@ namespace Discord.WebSocket
 
                 if (external)
                 {
+#pragma warning disable IDISP001
                     var _ = promise.TrySetResultAsync(null);
                     await Discord.ApiClient.SendVoiceStateUpdateAsync(Id, channelId, selfDeaf, selfMute).ConfigureAwait(false);
                     return null;
+#pragma warning restore IDISP001
                 }
 
                 if (_audioClient == null)
@@ -897,10 +901,14 @@ namespace Discord.WebSocket
                     };
                     audioClient.Connected += () =>
                     {
+#pragma warning disable IDISP001
                         var _ = promise.TrySetResultAsync(_audioClient);
+#pragma warning restore IDISP001
                         return Task.Delay(0);
                     };
+#pragma warning disable IDISP003
                     _audioClient = audioClient;
+#pragma warning restore IDISP003
                 }
 
                 await Discord.ApiClient.SendVoiceStateUpdateAsync(Id, channelId, selfDeaf, selfMute).ConfigureAwait(false);
@@ -948,6 +956,7 @@ namespace Discord.WebSocket
             if (_audioClient != null)
                 await _audioClient.StopAsync().ConfigureAwait(false);
             await Discord.ApiClient.SendVoiceStateUpdateAsync(Id, null, false, false).ConfigureAwait(false);
+            _audioClient?.Dispose();
             _audioClient = null;
         }
         internal async Task FinishConnectAudio(string url, string token)
@@ -1130,5 +1139,12 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         async Task<IReadOnlyCollection<IWebhook>> IGuild.GetWebhooksAsync(RequestOptions options)
             => await GetWebhooksAsync(options).ConfigureAwait(false);
+
+        void IDisposable.Dispose()
+        {
+            DisconnectAudioAsync().GetAwaiter().GetResult();
+            _audioLock?.Dispose();
+            _audioClient?.Dispose();
+        }
     }
 }
diff --git a/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs b/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
index 251a761d4..4b37de28f 100644
--- a/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
+++ b/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
@@ -13,24 +13,29 @@ namespace Discord.Net.Udp
         private readonly SemaphoreSlim _lock;
         private UdpClient _udp;
         private IPEndPoint _destination;
-        private CancellationTokenSource _cancelTokenSource;
+        private CancellationTokenSource _stopCancelTokenSource, _cancelTokenSource;
         private CancellationToken _cancelToken, _parentToken;
         private Task _task;
         private bool _isDisposed;
-        
+
         public ushort Port => (ushort)((_udp?.Client.LocalEndPoint as IPEndPoint)?.Port ?? 0);
 
         public DefaultUdpSocket()
         {
             _lock = new SemaphoreSlim(1, 1);
-            _cancelTokenSource = new CancellationTokenSource();
+            _stopCancelTokenSource = new CancellationTokenSource();
         }
         private void Dispose(bool disposing)
         {
             if (!_isDisposed)
             {
                 if (disposing)
+                {
                     StopInternalAsync(true).GetAwaiter().GetResult();
+                    _stopCancelTokenSource?.Dispose();
+                    _cancelTokenSource?.Dispose();
+                    _lock?.Dispose();
+                }
                 _isDisposed = true;
             }
         }
@@ -56,9 +61,14 @@ namespace Discord.Net.Udp
         {
             await StopInternalAsync().ConfigureAwait(false);
 
-            _cancelTokenSource = new CancellationTokenSource();
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _stopCancelTokenSource?.Dispose();
+            _cancelTokenSource?.Dispose();
+
+            _stopCancelTokenSource = new CancellationTokenSource();
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _stopCancelTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
 
+            _udp?.Dispose();
             _udp = new UdpClient(0);
 
             _task = RunAsync(_cancelToken);
@@ -77,7 +87,7 @@ namespace Discord.Net.Udp
         }
         public async Task StopInternalAsync(bool isDisposing = false)
         {
-            try { _cancelTokenSource.Cancel(false); } catch { }
+            try { _stopCancelTokenSource.Cancel(false); } catch { }
 
             if (!isDisposing)
                 await (_task ?? Task.Delay(0)).ConfigureAwait(false);
@@ -96,8 +106,11 @@ namespace Discord.Net.Udp
         }
         public void SetCancelToken(CancellationToken cancelToken)
         {
+            _cancelTokenSource?.Dispose();
+
             _parentToken = cancelToken;
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _stopCancelTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
         }
 
         public async Task SendAsync(byte[] data, int index, int count)
diff --git a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
index dc5201ac1..df2da5813 100644
--- a/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
+++ b/src/Discord.Net.WebSocket/Net/DefaultWebSocketClient.cs
@@ -25,14 +25,14 @@ namespace Discord.Net.WebSockets
         private readonly IWebProxy _proxy;
         private ClientWebSocket _client;
         private Task _task;
-        private CancellationTokenSource _cancelTokenSource;
+        private CancellationTokenSource _disconnectTokenSource, _cancelTokenSource;
         private CancellationToken _cancelToken, _parentToken;
         private bool _isDisposed, _isDisconnecting;
 
         public DefaultWebSocketClient(IWebProxy proxy = null)
         {
             _lock = new SemaphoreSlim(1, 1);
-            _cancelTokenSource = new CancellationTokenSource();
+            _disconnectTokenSource = new CancellationTokenSource();
             _cancelToken = CancellationToken.None;
             _parentToken = CancellationToken.None;
             _headers = new Dictionary<string, string>();
@@ -43,7 +43,12 @@ namespace Discord.Net.WebSockets
             if (!_isDisposed)
             {
                 if (disposing)
+                {
                     DisconnectInternalAsync(true).GetAwaiter().GetResult();
+                    _disconnectTokenSource?.Dispose();
+                    _cancelTokenSource?.Dispose();
+                    _lock?.Dispose();
+                }
                 _isDisposed = true;
             }
         }
@@ -68,9 +73,14 @@ namespace Discord.Net.WebSockets
         {
             await DisconnectInternalAsync().ConfigureAwait(false);
 
-            _cancelTokenSource = new CancellationTokenSource();
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _disconnectTokenSource?.Dispose();
+            _cancelTokenSource?.Dispose();
+
+            _disconnectTokenSource = new CancellationTokenSource();
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _disconnectTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
 
+            _client?.Dispose();
             _client = new ClientWebSocket();
             _client.Options.Proxy = _proxy;
             _client.Options.KeepAliveInterval = TimeSpan.Zero;
@@ -98,7 +108,7 @@ namespace Discord.Net.WebSockets
         }
         private async Task DisconnectInternalAsync(bool isDisposing = false)
         {
-            try { _cancelTokenSource.Cancel(false); } catch { }
+            try { _disconnectTokenSource.Cancel(false); } catch { }
 
             _isDisconnecting = true;
             try
@@ -117,7 +127,7 @@ namespace Discord.Net.WebSockets
                 }
                 try { _client.Dispose(); }
                 catch { }
-                
+
                 _client = null;
             }
         }
@@ -144,8 +154,11 @@ namespace Discord.Net.WebSockets
         }
         public void SetCancelToken(CancellationToken cancelToken)
         {
+            _cancelTokenSource?.Dispose();
+
             _parentToken = cancelToken;
-            _cancelToken = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _cancelTokenSource.Token).Token;
+            _cancelTokenSource = CancellationTokenSource.CreateLinkedTokenSource(_parentToken, _disconnectTokenSource.Token);
+            _cancelToken = _cancelTokenSource.Token;
         }
 
         public async Task SendAsync(byte[] data, int index, int count, bool isText)
@@ -166,7 +179,7 @@ namespace Discord.Net.WebSockets
                         frameSize = count - (i * SendChunkSize);
                     else
                         frameSize = SendChunkSize;
-                    
+
                     var type = isText ? WebSocketMessageType.Text : WebSocketMessageType.Binary;
                     await _client.SendAsync(new ArraySegment<byte>(data, index, count), type, isLast, _cancelToken).ConfigureAwait(false);
                 }
@@ -176,7 +189,7 @@ namespace Discord.Net.WebSockets
                 _lock.Release();
             }
         }
-        
+
         private async Task RunAsync(CancellationToken cancelToken)
         {
             var buffer = new ArraySegment<byte>(new byte[ReceiveChunkSize]);
@@ -188,7 +201,7 @@ namespace Discord.Net.WebSockets
                     WebSocketReceiveResult socketResult = await _client.ReceiveAsync(buffer, cancelToken).ConfigureAwait(false);
                     byte[] result;
                     int resultCount;
-                        
+
                     if (socketResult.MessageType == WebSocketMessageType.Close)
                         throw new WebSocketClosedException((int)socketResult.CloseStatus, socketResult.CloseStatusDescription);
 
@@ -219,7 +232,7 @@ namespace Discord.Net.WebSockets
                         resultCount = socketResult.Count;
                         result = buffer.Array;
                     }
-                    
+
                     if (socketResult.MessageType == WebSocketMessageType.Text)
                     {
                         string text = Encoding.UTF8.GetString(result, 0, resultCount);
diff --git a/src/Discord.Net.Webhook/Discord.Net.Webhook.csproj b/src/Discord.Net.Webhook/Discord.Net.Webhook.csproj
index ba7bbcff8..58282d85b 100644
--- a/src/Discord.Net.Webhook/Discord.Net.Webhook.csproj
+++ b/src/Discord.Net.Webhook/Discord.Net.Webhook.csproj
@@ -10,4 +10,4 @@
     <ProjectReference Include="..\Discord.Net.Core\Discord.Net.Core.csproj" />
     <ProjectReference Include="..\Discord.Net.Rest\Discord.Net.Rest.csproj" />
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/test/Discord.Net.Tests/Discord.Net.Tests.csproj b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
index 0ee6f7e59..aa6f86a34 100644
--- a/test/Discord.Net.Tests/Discord.Net.Tests.csproj
+++ b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
@@ -5,6 +5,7 @@
     <TargetFramework>netcoreapp1.1</TargetFramework>
     <DebugType>portable</DebugType>
     <PackageTargetFallback>$(PackageTargetFallback);portable-net45+win8+wp8+wpa81</PackageTargetFallback>
+    <NoWarn>IDISP001,IDISP002,IDISP004,IDISP005</NoWarn>
   </PropertyGroup>
   <ItemGroup>
     <Content Include="xunit.runner.json">
diff --git a/test/Discord.Net.Tests/Net/CachedRestClient.cs b/test/Discord.Net.Tests/Net/CachedRestClient.cs
index 4bc8a386a..c465eaa01 100644
--- a/test/Discord.Net.Tests/Net/CachedRestClient.cs
+++ b/test/Discord.Net.Tests/Net/CachedRestClient.cs
@@ -43,7 +43,10 @@ namespace Discord.Net
             if (!_isDisposed)
             {
                 if (disposing)
+                {
                     _blobCache.Dispose();
+                    _cancelTokenSource?.Dispose();
+                }
                 _isDisposed = true;
             }
         }
@@ -70,7 +73,7 @@ namespace Discord.Net
         {
             if (method != "GET")
                 throw new InvalidOperationException("This RestClient only supports GET requests.");
-                
+
             string uri = Path.Combine(_baseUrl, endpoint);
             var bytes = await _blobCache.DownloadUrl(uri, _headers);
             return new RestResponse(HttpStatusCode.OK, _headers, new MemoryStream(bytes));
@@ -84,7 +87,7 @@ namespace Discord.Net
             throw new InvalidOperationException("This RestClient does not support multipart requests.");
         }
 
-        public async Task ClearAsync() 
+        public async Task ClearAsync()
         {
             await _blobCache.InvalidateAll();
         }
@@ -93,7 +96,7 @@ namespace Discord.Net
         {
             if (Info != null)
                 return;
-                
+
             bool needsReset = false;
             try
             {
@@ -117,4 +120,4 @@ namespace Discord.Net
             await _blobCache.InsertObject<CacheInfo>("info", Info);
         }
     }
-}
\ No newline at end of file
+}

From 46e2674a9328abc994fcb9cd614f06e7e9c2ea97 Mon Sep 17 00:00:00 2001
From: ComputerMaster1st <mr_m.a_thompson@hotmail.co.uk>
Date: Thu, 29 Nov 2018 22:13:50 +0000
Subject: [PATCH 52/59] fix: Added Msg.Content Null Check For Prefixes (#1200)

* Added Msg.Content Null Check

* Minor Change

* Grouped Params In If Statement

* Minor Change
---
 src/Discord.Net.Commands/Extensions/MessageExtensions.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Discord.Net.Commands/Extensions/MessageExtensions.cs b/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
index f76df1f2a..f880e1d98 100644
--- a/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
+++ b/src/Discord.Net.Commands/Extensions/MessageExtensions.cs
@@ -19,7 +19,7 @@ namespace Discord.Commands
         public static bool HasCharPrefix(this IUserMessage msg, char c, ref int argPos)
         {
             var text = msg.Content;
-            if (text.Length > 0 && text[0] == c)
+            if (!string.IsNullOrEmpty(text) && text[0] == c)
             {
                 argPos = 1;
                 return true;
@@ -32,7 +32,7 @@ namespace Discord.Commands
         public static bool HasStringPrefix(this IUserMessage msg, string str, ref int argPos, StringComparison comparisonType = StringComparison.Ordinal)
         {
             var text = msg.Content;
-            if (text.StartsWith(str, comparisonType))
+            if (!string.IsNullOrEmpty(text) && text.StartsWith(str, comparisonType))
             {
                 argPos = str.Length;
                 return true;
@@ -45,7 +45,7 @@ namespace Discord.Commands
         public static bool HasMentionPrefix(this IUserMessage msg, IUser user, ref int argPos)
         {
             var text = msg.Content;
-            if (text.Length <= 3 || text[0] != '<' || text[1] != '@') return false;
+            if (string.IsNullOrEmpty(text) || text.Length <= 3 || text[0] != '<' || text[1] != '@') return false;
 
             int endPos = text.IndexOf('>');
             if (endPos == -1) return false;

From a3f5e0b3a7f9d74fd7e8665a80c2995150871a4b Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Fri, 30 Nov 2018 06:15:11 +0800
Subject: [PATCH 53/59] api: [brk] Move Invites-related Methods from
 IGuildChannel to INestedChannel (#1172)

* Move invites-related methods from IGuildChannel to INestedChannel

* Add missing implementation

...because I somehow forgot it the first time around
---
 .../Entities/Channels/IGuildChannel.cs        | 39 -----------------
 .../Entities/Channels/INestedChannel.cs       | 42 ++++++++++++++++++-
 .../Entities/Channels/RestCategoryChannel.cs  | 10 -----
 .../Entities/Channels/RestGuildChannel.cs     | 33 ---------------
 .../Entities/Channels/RestTextChannel.cs      |  8 ++++
 .../Entities/Channels/RestVoiceChannel.cs     | 10 +++++
 .../Channels/SocketCategoryChannel.cs         |  8 ----
 .../Entities/Channels/SocketGuildChannel.cs   | 32 --------------
 .../Entities/Channels/SocketTextChannel.cs    |  9 +++-
 .../Entities/Channels/SocketVoiceChannel.cs   |  8 ++++
 10 files changed, 75 insertions(+), 124 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs b/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
index c3a2161cc..1da1879de 100644
--- a/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/IGuildChannel.cs
@@ -44,45 +44,6 @@ namespace Discord
         /// </returns>
         IReadOnlyCollection<Overwrite> PermissionOverwrites { get; }
 
-        /// <summary>
-        ///     Creates a new invite to this channel.
-        /// </summary>
-        /// <example>
-        ///     The following example creates a new invite to this channel; the invite lasts for 12 hours and can only
-        ///     be used 3 times throughout its lifespan.
-        ///     <code language="cs">
-        ///     await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3);
-        ///     </code>
-        /// </example>
-        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
-        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
-        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
-        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
-        ///     metadata object containing information for the created invite.
-        /// </returns>
-        Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = default(int?), bool isTemporary = false, bool isUnique = false, RequestOptions options = null);
-        /// <summary>
-        ///     Gets a collection of all invites to this channel.
-        /// </summary>
-        /// <example>
-        ///     The following example gets all of the invites that have been created in this channel and selects the
-        ///     most used invite.
-        ///     <code language="cs">
-        ///     var invites = await channel.GetInvitesAsync();
-        ///     if (invites.Count == 0) return;
-        ///     var invite = invites.OrderByDescending(x => x.Uses).FirstOrDefault();
-        ///     </code>
-        /// </example>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
-        ///     of invite metadata that are created for this channel.
-        /// </returns>
-        Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null);
-
         /// <summary>
         ///     Modifies this guild channel.
         /// </summary>
diff --git a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
index 6719f91d4..f45a0114a 100644
--- a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
@@ -1,3 +1,4 @@
+using System.Collections.Generic;
 using System.Threading.Tasks;
 
 namespace Discord
@@ -25,10 +26,49 @@ namespace Discord
         ///     representing the parent of this channel; <c>null</c> if none is set.
         /// </returns>
         Task<ICategoryChannel> GetCategoryAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
-
+        
         /// <summary>
         ///     Syncs the permissions of this nested channel with its parent's.
         /// </summary>
         Task SyncPermissionsAsync(RequestOptions options = null);
+
+        /// <summary>
+        ///     Creates a new invite to this channel.
+        /// </summary>
+        /// <example>
+        ///     The following example creates a new invite to this channel; the invite lasts for 12 hours and can only
+        ///     be used 3 times throughout its lifespan.
+        ///     <code language="cs">
+        ///     await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3);
+        ///     </code>
+        /// </example>
+        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
+        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
+        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
+        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
+        ///     metadata object containing information for the created invite.
+        /// </returns>
+        Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = default(int?), bool isTemporary = false, bool isUnique = false, RequestOptions options = null);
+        /// <summary>
+        ///     Gets a collection of all invites to this channel.
+        /// </summary>B
+        /// <example>
+        ///     The following example gets all of the invites that have been created in this channel and selects the
+        ///     most used invite.
+        ///     <code language="cs">
+        ///     var invites = await channel.GetInvitesAsync();
+        ///     if (invites.Count == 0) return;
+        ///     var invite = invites.OrderByDescending(x => x.Uses).FirstOrDefault();
+        ///     </code>
+        /// </example>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <returns>
+        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
+        ///     of invite metadata that are created for this channel.
+        /// </returns>
+        Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null);
     }
 }
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
index 9d69d6bdc..177bde21d 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestCategoryChannel.cs
@@ -25,16 +25,6 @@ namespace Discord.Rest
 
         private string DebuggerDisplay => $"{Name} ({Id}, Category)";
 
-        // IGuildChannel
-        /// <inheritdoc />
-        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
-        Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
-            => throw new NotSupportedException();
-        /// <inheritdoc />
-        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
-        Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
-            => throw new NotSupportedException();
-
         //IChannel
         /// <inheritdoc />
         /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
index 380a64c8c..5f4db2eea 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestGuildChannel.cs
@@ -178,32 +178,6 @@ namespace Discord.Rest
             }
         }
 
-        /// <summary>
-        ///     Gets a collection of all invites to this channel.
-        /// </summary>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
-        ///     of invite metadata that are created for this channel.
-        /// </returns>
-        public async Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
-            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
-
-        /// <summary>
-        ///     Creates a new invite to this channel.
-        /// </summary>
-        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
-        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
-        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
-        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
-        ///     metadata object containing information for the created invite.
-        /// </returns>
-        public async Task<RestInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
-            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
-
         /// <summary>
         ///     Gets the name of this channel.
         /// </summary>
@@ -224,13 +198,6 @@ namespace Discord.Rest
             }
         }
 
-        /// <inheritdoc />
-        async Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
-            => await GetInvitesAsync(options).ConfigureAwait(false);
-        /// <inheritdoc />
-        async Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
-            => await CreateInviteAsync(maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
-
         /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IRole role)
             => GetPermissionOverwrite(role);
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
index beeb8de19..58de066fb 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestTextChannel.cs
@@ -204,6 +204,14 @@ namespace Discord.Rest
         public Task SyncPermissionsAsync(RequestOptions options = null)
             => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
 
+        //Invites
+        /// <inheritdoc />
+        public async Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
+            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
+        /// <inheritdoc />
+        public async Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
+            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
+
         private string DebuggerDisplay => $"{Name} ({Id}, Text)";
 
         //ITextChannel
diff --git a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
index 1a2c5ceae..aaaaad373 100644
--- a/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
+++ b/src/Discord.Net.Rest/Entities/Channels/RestVoiceChannel.cs
@@ -57,8 +57,17 @@ namespace Discord.Rest
         /// </returns>
         public Task<ICategoryChannel> GetCategoryAsync(RequestOptions options = null)
             => ChannelHelper.GetCategoryAsync(this, Discord, options);
+        
         public Task SyncPermissionsAsync(RequestOptions options = null)
             => ChannelHelper.SyncPermissionsAsync(this, Discord, options);
+         
+        //Invites
+        /// <inheritdoc />
+        public async Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
+            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
+        /// <inheritdoc />
+        public async Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
+            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
 
         private string DebuggerDisplay => $"{Name} ({Id}, Voice)";
 
@@ -77,6 +86,7 @@ namespace Discord.Rest
             => AsyncEnumerable.Empty<IReadOnlyCollection<IGuildUser>>();
 
         // INestedChannel
+        /// <inheritdoc />
         async Task<ICategoryChannel> INestedChannel.GetCategoryAsync(CacheMode mode, RequestOptions options)
         {
             if (CategoryId.HasValue && mode == CacheMode.AllowDownload)
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
index 0ae40820c..b90c1976a 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketCategoryChannel.cs
@@ -67,14 +67,6 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
             => Task.FromResult<IGuildUser>(GetUser(id));
-        /// <inheritdoc />
-        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
-        Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
-            => throw new NotSupportedException();
-        /// <inheritdoc />
-        /// <exception cref="NotSupportedException">This method is not supported with category channels.</exception>
-        Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
-            => throw new NotSupportedException();
 
         //IChannel
         /// <inheritdoc />
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
index bf1b2260b..18401c593 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketGuildChannel.cs
@@ -184,31 +184,6 @@ namespace Discord.WebSocket
             }
         }
 
-        /// <summary>
-        ///     Returns a collection of all invites to this channel.
-        /// </summary>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous get operation. The task result contains a read-only collection
-        ///     of invite metadata that are created for this channel.
-        /// </returns>
-        public async Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
-            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
-        /// <summary>
-        ///     Creates a new invite to this channel.
-        /// </summary>
-        /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param>
-        /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param>
-        /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param>
-        /// <param name="isUnique">If <c>true</c>, don't try to reuse a similar invite (useful for creating many unique one time use invites).</param>
-        /// <param name="options">The options to be used when sending the request.</param>
-        /// <returns>
-        ///     A task that represents the asynchronous invite creation operation. The task result contains an invite
-        ///     metadata object containing information for the created invite.
-        /// </returns>
-        public async Task<RestInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
-            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
-
         public new virtual SocketGuildUser GetUser(ulong id) => null;
 
         /// <summary>
@@ -233,13 +208,6 @@ namespace Discord.WebSocket
         /// <inheritdoc />
         ulong IGuildChannel.GuildId => Guild.Id;
 
-        /// <inheritdoc />
-        async Task<IReadOnlyCollection<IInviteMetadata>> IGuildChannel.GetInvitesAsync(RequestOptions options)
-            => await GetInvitesAsync(options).ConfigureAwait(false);
-        /// <inheritdoc />
-        async Task<IInviteMetadata> IGuildChannel.CreateInviteAsync(int? maxAge, int? maxUses, bool isTemporary, bool isUnique, RequestOptions options)
-            => await CreateInviteAsync(maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
-
         /// <inheritdoc />
         OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IRole role)
             => GetPermissionOverwrite(role);
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
index acd868020..728a4ad53 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketTextChannel.cs
@@ -126,7 +126,6 @@ namespace Discord.WebSocket
         /// <returns>
         ///     Paged collection of messages.
         /// </returns>
-
         public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
             => SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, CacheMode.AllowDownload, options);
         /// <summary>
@@ -304,6 +303,14 @@ namespace Discord.WebSocket
         public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
             => ChannelHelper.GetWebhooksAsync(this, Discord, options);
 
+        //Invites
+        /// <inheritdoc />
+        public async Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
+            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
+        /// <inheritdoc />
+        public async Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
+            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
+
         private string DebuggerDisplay => $"{Name} ({Id}, Text)";
         internal new SocketTextChannel Clone() => MemberwiseClone() as SocketTextChannel;
 
diff --git a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
index dd71416db..48a7d7c3b 100644
--- a/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
+++ b/src/Discord.Net.WebSocket/Entities/Channels/SocketVoiceChannel.cs
@@ -79,6 +79,14 @@ namespace Discord.WebSocket
             return null;
         }
 
+        //Invites
+        /// <inheritdoc />
+        public async Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
+            => await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
+        /// <inheritdoc />
+        public async Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
+            => await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
+
         private string DebuggerDisplay => $"{Name} ({Id}, Voice)";
         internal new SocketVoiceChannel Clone() => MemberwiseClone() as SocketVoiceChannel;
 

From 2c93363653d7935cd142b664b7abc63fd2641110 Mon Sep 17 00:00:00 2001
From: ComputerMaster1st <mr_m.a_thompson@hotmail.co.uk>
Date: Thu, 29 Nov 2018 22:16:46 +0000
Subject: [PATCH 54/59] fix: Solves AudioClient Lockup On Disconnect (#1203)

* Solves Audio Disconnect Lockup

* Execute Disconnected Event Before Logger & State
---
 src/Discord.Net.WebSocket/ConnectionManager.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/Discord.Net.WebSocket/ConnectionManager.cs b/src/Discord.Net.WebSocket/ConnectionManager.cs
index 66f847c50..8c9c743cb 100644
--- a/src/Discord.Net.WebSocket/ConnectionManager.cs
+++ b/src/Discord.Net.WebSocket/ConnectionManager.cs
@@ -106,12 +106,10 @@ namespace Discord
                 finally { _stateLock.Release(); }
             });
         }
-        public virtual async Task StopAsync()
+        public virtual Task StopAsync()
         {
             Cancel();
-            var task = _task;
-            if (task != null)
-                await task.ConfigureAwait(false);
+            return Task.CompletedTask;
         }
 
         private async Task ConnectAsync(CancellationTokenSource reconnectCancelToken)
@@ -164,9 +162,9 @@ namespace Discord
 
             await _onDisconnecting(ex).ConfigureAwait(false);
 
-            await _logger.InfoAsync("Disconnected").ConfigureAwait(false);
-            State = ConnectionState.Disconnected;
             await _disconnectedEvent.InvokeAsync(ex, isReconnecting).ConfigureAwait(false);
+            State = ConnectionState.Disconnected;
+            await _logger.InfoAsync("Disconnected").ConfigureAwait(false);
         }
 
         public async Task CompleteAsync()

From ccb16e40c8f111b3690f84b410b2020676b5a40d Mon Sep 17 00:00:00 2001
From: ComputerMaster1st <mr_m.a_thompson@hotmail.co.uk>
Date: Thu, 29 Nov 2018 22:20:35 +0000
Subject: [PATCH 55/59] fix: Solves UdpClient "ObjectDisposedException" (#1202)

* Solves "ObjectDisposedException"

* Corrected Spelling Error

* Fixed Spelling
---
 src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs b/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
index 4b37de28f..82079e9bd 100644
--- a/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
+++ b/src/Discord.Net.WebSocket/Net/DefaultUdpSocket.cs
@@ -130,6 +130,14 @@ namespace Discord.Net.Udp
             while (!cancelToken.IsCancellationRequested)
             {
                 var receiveTask = _udp.ReceiveAsync();
+
+                _ = receiveTask.ContinueWith((receiveResult) =>
+                {
+                    //observe the exception as to not receive as unhandled exception
+                    _ = receiveResult.Exception;
+
+                }, TaskContinuationOptions.OnlyOnFaulted);
+
                 var task = await Task.WhenAny(closeTask, receiveTask).ConfigureAwait(false);
                 if (task == closeTask)
                     break;

From 6f5693f486126413f7cbcd593b5b2539120385c4 Mon Sep 17 00:00:00 2001
From: Christopher Felegy <foxbot@protonmail.com>
Date: Thu, 29 Nov 2018 17:51:34 -0500
Subject: [PATCH 56/59] test: bump dependency versions

---
 test/Discord.Net.Tests/Discord.Net.Tests.csproj | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/test/Discord.Net.Tests/Discord.Net.Tests.csproj b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
index aa6f86a34..46e37655e 100644
--- a/test/Discord.Net.Tests/Discord.Net.Tests.csproj
+++ b/test/Discord.Net.Tests/Discord.Net.Tests.csproj
@@ -2,9 +2,8 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <RootNamespace>Discord</RootNamespace>
-    <TargetFramework>netcoreapp1.1</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <DebugType>portable</DebugType>
-    <PackageTargetFallback>$(PackageTargetFallback);portable-net45+win8+wp8+wpa81</PackageTargetFallback>
     <NoWarn>IDISP001,IDISP002,IDISP004,IDISP005</NoWarn>
   </PropertyGroup>
   <ItemGroup>
@@ -22,11 +21,14 @@
     <ProjectReference Include="../../src/Discord.Net.Analyzers/Discord.Net.Analyzers.csproj" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Akavache" Version="5.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.7.2" />
+    <PackageReference Include="Akavache" Version="6.0.31" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.9.0" />
     <PackageReference Include="Newtonsoft.Json" Version="11.0.2" />
-    <PackageReference Include="xunit" Version="2.4.0" />
-    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.0" />
-    <PackageReference Include="xunit.runner.reporters" Version="2.4.0" />
+    <PackageReference Include="xunit" Version="2.4.1" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.1">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="xunit.runner.reporters" Version="2.4.1" />
   </ItemGroup>
 </Project>

From f6413bac59ace5afdb9492e341e6bc28302ad6c7 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Fri, 30 Nov 2018 04:10:26 -0800
Subject: [PATCH 57/59] fix: Update minimum Bot Token length to 58 char (#1204)

* Update the minimum bot token length to 58 char

- Updates the minimum length of a bot token to be 58 characters. An older 58 char bot token was found by Moiph
- Makes this value an internal const instead of a magic number

* update the TokenUtils tests for 58 char min
---
 src/Discord.Net.Core/Utils/TokenUtils.cs   | 15 ++++++++++++---
 test/Discord.Net.Tests/Tests.TokenUtils.cs | 10 +++++++---
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/src/Discord.Net.Core/Utils/TokenUtils.cs b/src/Discord.Net.Core/Utils/TokenUtils.cs
index bfc915252..8fa846267 100644
--- a/src/Discord.Net.Core/Utils/TokenUtils.cs
+++ b/src/Discord.Net.Core/Utils/TokenUtils.cs
@@ -7,6 +7,15 @@ namespace Discord
     /// </summary>
     public static class TokenUtils
     {
+        /// <summary>
+        ///     The minimum length of a Bot token.
+        /// </summary>
+        /// <remarks>
+        ///     This value was determined by comparing against the examples in the Discord
+        ///     documentation, and pre-existing tokens.
+        /// </remarks>
+        internal const int MinBotTokenLength = 58;
+
         /// <summary>
         ///     Checks the validity of the supplied token of a specific type.
         /// </summary>
@@ -29,11 +38,11 @@ namespace Discord
                     // no validation is performed on Bearer tokens
                     break;
                 case TokenType.Bot:
-                    // bot tokens are assumed to be at least 59 characters in length
+                    // bot tokens are assumed to be at least 58 characters in length
                     // this value was determined by referencing examples in the discord documentation, and by comparing with
                     // pre-existing tokens
-                    if (token.Length < 59)
-                        throw new ArgumentException(message: "A Bot token must be at least 59 characters in length.", paramName: nameof(token));
+                    if (token.Length < MinBotTokenLength)
+                        throw new ArgumentException(message: $"A Bot token must be at least {MinBotTokenLength} characters in length.", paramName: nameof(token));
                     break;
                 default:
                     // All unrecognized TokenTypes (including User tokens) are considered to be invalid.
diff --git a/test/Discord.Net.Tests/Tests.TokenUtils.cs b/test/Discord.Net.Tests/Tests.TokenUtils.cs
index dc5a93e34..8cebc649d 100644
--- a/test/Discord.Net.Tests/Tests.TokenUtils.cs
+++ b/test/Discord.Net.Tests/Tests.TokenUtils.cs
@@ -69,9 +69,12 @@ namespace Discord
         /// <summary>
         ///     Tests the behavior of <see cref="TokenUtils.ValidateToken(TokenType, string)"/>
         ///     to see that valid Bot tokens do not throw Exceptions.
-        ///     Valid Bot tokens can be strings of length 59 or above.
+        ///     Valid Bot tokens can be strings of length 58 or above.
         /// </summary>
         [Theory]
+        // missing a single character from the end, 58 char. still should be valid
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKW")]
+        // 59 char token
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
         [InlineData("This appears to be completely invalid, however the current validation rules are not very strict.")]
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWss")]
@@ -90,12 +93,12 @@ namespace Discord
         /// </summary>
         [Theory]
         [InlineData("This is invalid")]
-        // missing a single character from the end
-        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKW")]
         // bearer token
         [InlineData("6qrZcUqja7812RVdnEKjpzOL4CvHBFG")]
         // client secret
         [InlineData("937it3ow87i4ery69876wqire")]
+        // 57 char bot token
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kK")]
         public void TestBotTokenInvalidThrowsArgumentException(string token)
         {
             Assert.Throws<ArgumentException>(() => TokenUtils.ValidateToken(TokenType.Bot, token));
@@ -113,6 +116,7 @@ namespace Discord
         // TokenType.User
         [InlineData(0)]
         // out of range TokenType
+        [InlineData(-1)]
         [InlineData(4)]
         [InlineData(7)]
         public void TestUnrecognizedTokenType(int type)

From 91e0f03bfdf6aae1a0e944a15aaf6a3a2a9a0d4c Mon Sep 17 00:00:00 2001
From: Alex Gravely <tcbskater@hotmail.com>
Date: Sun, 2 Dec 2018 12:57:38 -0500
Subject: [PATCH 58/59] fix: Fix after message remaining in MessageUpdated if
 message author wasn't in the payload (#1209)

* Fix leaving updated message as null when Discords doesn't include a message author in MESSAGE_UPDATE

* Name! That! Parameter!
---
 .../DiscordSocketClient.cs                     | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/Discord.Net.WebSocket/DiscordSocketClient.cs b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
index 6b720645e..1e431ec92 100644
--- a/src/Discord.Net.WebSocket/DiscordSocketClient.cs
+++ b/src/Discord.Net.WebSocket/DiscordSocketClient.cs
@@ -1218,16 +1218,22 @@ namespace Discord.WebSocket
                                             cachedMsg.Update(State, data);
                                             after = cachedMsg;
                                         }
-                                        else if (data.Author.IsSpecified)
+                                        else
                                         {
                                             //Edited message isnt in cache, create a detached one
                                             SocketUser author;
-                                            if (guild != null)
-                                                author = guild.GetUser(data.Author.Value.Id);
+                                            if (data.Author.IsSpecified)
+                                            {
+                                                if (guild != null)
+                                                    author = guild.GetUser(data.Author.Value.Id);
+                                                else
+                                                    author = (channel as SocketChannel).GetUser(data.Author.Value.Id);
+                                                if (author == null)
+                                                    author = SocketUnknownUser.Create(this, State, data.Author.Value);
+                                            }
                                             else
-                                                author = (channel as SocketChannel).GetUser(data.Author.Value.Id);
-                                            if (author == null)
-                                                author = SocketUnknownUser.Create(this, State, data.Author.Value);
+                                                // Message author wasn't specified in the payload, so create a completely anonymous unknown user
+                                                author = new SocketUnknownUser(this, id: 0);
 
                                             after = SocketMessage.Create(this, State, author, channel, data);
                                         }

From f4b1a5f25bfd37b353bdadcc93377c60b48368a9 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chris@thejohnstons.net>
Date: Sun, 2 Dec 2018 10:03:12 -0800
Subject: [PATCH 59/59] fix: Improve validation of Bot Tokens (#1206)

* improve bot token validation by trying to decode user id from token

Try to decode the user id from the supplied bot token as a way of validating the token. If this should fail, indicate that the token is invalid.

* Update the tokenutils tests to pass the new validation checks

* Add test case for CheckBotTokenValidity method

* lint: clean up whitespace

* Add check for null or whitespace string, lint whitespace

* fix userid conversion

* Add hint to user to check that token is not an oauth client secret

* Catch exception that can be thrown by GetString

* Refactor token conversion logic into it's own testable method
---
 src/Discord.Net.Core/Utils/TokenUtils.cs   | 68 +++++++++++++++++++++-
 test/Discord.Net.Tests/Tests.TokenUtils.cs | 44 +++++++++++++-
 2 files changed, 108 insertions(+), 4 deletions(-)

diff --git a/src/Discord.Net.Core/Utils/TokenUtils.cs b/src/Discord.Net.Core/Utils/TokenUtils.cs
index 8fa846267..68aad5d96 100644
--- a/src/Discord.Net.Core/Utils/TokenUtils.cs
+++ b/src/Discord.Net.Core/Utils/TokenUtils.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Text;
 
 namespace Discord
 {
@@ -16,6 +17,65 @@ namespace Discord
         /// </remarks>
         internal const int MinBotTokenLength = 58;
 
+        /// <summary>
+        ///     Decodes a base 64 encoded string into a ulong value.
+        /// </summary>
+        /// <param name="encoded"> A base 64 encoded string containing a User Id.</param>
+        /// <returns> A ulong containing the decoded value of the string, or null if the value was invalid. </returns>
+        internal static ulong? DecodeBase64UserId(string encoded)
+        {
+            if (string.IsNullOrWhiteSpace(encoded))
+                return null;
+
+            try
+            {
+                // decode the base64 string
+                var bytes = Convert.FromBase64String(encoded);
+                var idStr = Encoding.UTF8.GetString(bytes);
+                // try to parse a ulong from the resulting string
+                if (ulong.TryParse(idStr, out var id))
+                    return id;
+            }
+            catch (DecoderFallbackException)
+            {
+                // ignore exception, can be thrown by GetString
+            }
+            catch (FormatException)
+            {
+                // ignore exception, can be thrown if base64 string is invalid
+            }
+            catch (ArgumentException)
+            {
+                // ignore exception, can be thrown by BitConverter
+            }
+            return null;
+        }
+
+        /// <summary>
+        ///     Checks the validity of a bot token by attempting to decode a ulong userid
+        ///     from the bot token.
+        /// </summary>
+        /// <param name="message">
+        ///     The bot token to validate.
+        /// </param>
+        /// <returns>
+        ///     True if the bot token was valid, false if it was not.
+        /// </returns>
+        internal static bool CheckBotTokenValidity(string message)
+        {
+            if (string.IsNullOrWhiteSpace(message))
+                return false;
+
+            // split each component of the JWT
+            var segments = message.Split('.');
+
+            // ensure that there are three parts
+            if (segments.Length != 3)
+                return false;
+            // return true if the user id could be determined
+            return DecodeBase64UserId(segments[0]).HasValue;
+        }
+
         /// <summary>
         ///     Checks the validity of the supplied token of a specific type.
         /// </summary>
@@ -42,13 +102,17 @@ namespace Discord
                     // this value was determined by referencing examples in the discord documentation, and by comparing with
                     // pre-existing tokens
                     if (token.Length < MinBotTokenLength)
-                        throw new ArgumentException(message: $"A Bot token must be at least {MinBotTokenLength} characters in length.", paramName: nameof(token));
+                        throw new ArgumentException(message: $"A Bot token must be at least {MinBotTokenLength} characters in length. " +
+                            "Ensure that the Bot Token provided is not an OAuth client secret.", paramName: nameof(token));
+                    // check the validity of the bot token by decoding the ulong userid from the jwt
+                    if (!CheckBotTokenValidity(token))
+                        throw new ArgumentException(message: "The Bot token was invalid. " +
+                            "Ensure that the Bot Token provided is not an OAuth client secret.", paramName: nameof(token));
                     break;
                 default:
                     // All unrecognized TokenTypes (including User tokens) are considered to be invalid.
                     throw new ArgumentException(message: "Unrecognized TokenType.", paramName: nameof(token));
             }
         }
-
     }
 }
diff --git a/test/Discord.Net.Tests/Tests.TokenUtils.cs b/test/Discord.Net.Tests/Tests.TokenUtils.cs
index 8cebc649d..9a1102ec5 100644
--- a/test/Discord.Net.Tests/Tests.TokenUtils.cs
+++ b/test/Discord.Net.Tests/Tests.TokenUtils.cs
@@ -76,9 +76,7 @@ namespace Discord
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKW")]
         // 59 char token
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
-        [InlineData("This appears to be completely invalid, however the current validation rules are not very strict.")]
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWss")]
-        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWsMTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
         public void TestBotTokenDoesNotThrowExceptions(string token)
         {
             // This example token is pulled from the Discord Docs
@@ -99,6 +97,9 @@ namespace Discord
         [InlineData("937it3ow87i4ery69876wqire")]
         // 57 char bot token
         [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kK")]
+        [InlineData("This is an invalid token, but it passes the check for string length.")]
+        // valid token, but passed in twice
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWsMTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs")]
         public void TestBotTokenInvalidThrowsArgumentException(string token)
         {
             Assert.Throws<ArgumentException>(() => TokenUtils.ValidateToken(TokenType.Bot, token));
@@ -124,5 +125,44 @@ namespace Discord
             Assert.Throws<ArgumentException>(() =>
                 TokenUtils.ValidateToken((TokenType)type, "MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs"));
         }
+
+        /// <summary>
+        ///     Checks the <see cref="TokenUtils.CheckBotTokenValidity(string)"/> method for expected output.
+        /// </summary>
+        /// <param name="token"> The Bot Token to test.</param>
+        /// <param name="expected"> The expected result. </param>
+        [Theory]
+        // this method only checks the first part of the JWT
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4..", true)]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kK", true)]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4. this part is invalid. this part is also invalid", true)]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4.", false)]
+        [InlineData("MTk4NjIyNDgzNDcxOTI1MjQ4", false)]
+        [InlineData("NDI4NDc3OTQ0MDA5MTk1NTIw.xxxx.xxxxx", true)]
+        // should not throw an unexpected exception
+        [InlineData("", false)]
+        [InlineData(null, false)]
+        public void TestCheckBotTokenValidity(string token, bool expected)
+        {
+            Assert.Equal(expected, TokenUtils.CheckBotTokenValidity(token));
+        }
+
+        [Theory]
+        // cannot pass a ulong? as a param in InlineData, so have to have a separate param
+        // indicating if a value is null
+        [InlineData("NDI4NDc3OTQ0MDA5MTk1NTIw", false, 428477944009195520)]
+        // should return null w/o throwing other exceptions
+        [InlineData("", true, 0)]
+        [InlineData(" ", true, 0)]
+        [InlineData(null, true, 0)]
+        [InlineData("these chars aren't allowed @U#)*@#!)*", true, 0)]
+        public void TestDecodeBase64UserId(string encodedUserId, bool isNull, ulong expectedUserId)
+        {
+            var result = TokenUtils.DecodeBase64UserId(encodedUserId);
+            if (isNull)
+                Assert.Null(result);
+            else
+                Assert.Equal(expectedUserId, result);
+        }
     }
 }