Document some enums and settings classes

src/Discord.Net/ConnectionState.cs

@@ -1,10 +1,15 @@
 namespace Discord
 {
+    /// <summary> Connection state for clients </summary> 
     public enum ConnectionState : byte
     {
+        /// <summary> Not connected to Discord </summary>
         Disconnected,
+        /// <summary> Currently connecting to Discord </summary>
         Connecting,
+        /// <summary> Connected to Discord </summary>
         Connected,
+        /// <summary> Disconnecting from Discord </summary>
         Disconnecting
     }
 }

src/Discord.Net/DiscordConfig.cs

@@ -2,20 +2,29 @@
 
 namespace Discord
 {
+    /// <summary> Stores common configuration settings </summary>
     public class DiscordConfig
     {
-        public const int APIVersion = 6;        
+        /// <summary> The version of Discord's REST API which is used </summary>
+        public const int APIVersion = 6;
+        /// <summary> Version information about Discord.Net </summary>
         public static string Version { get; } =
             typeof(DiscordConfig).GetTypeInfo().Assembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion ??
             typeof(DiscordConfig).GetTypeInfo().Assembly.GetName().Version.ToString(3) ?? 
             "Unknown";
 
+        /// <summary> The base URL for all REST API requests </summary>
         public static readonly string ClientAPIUrl = $"https://discordapp.com/api/v{APIVersion}/";
+        /// <summary> The base URL for all CDN requests </summary>
         public const string CDNUrl = "https://discordcdn.com/";
+        /// <summary> The base URL for all invite links </summary>
         public const string InviteUrl = "https://discord.gg/";
 
+        /// <summary> The maximum amount of characters which can be sent in a message </summary>
         public const int MaxMessageSize = 2000;
+        /// <summary> The maximum number of messages which can be received in a batch </summary>
         public const int MaxMessagesPerBatch = 100;
+        /// <summary> The maximum number of users which can be received in a batch </summary>
         public const int MaxUsersPerBatch = 1000;
 
         /// <summary> Gets or sets the minimum log level severity that will be sent to the LogMessage event. </summary>

src/Discord.Net/Format.cs

@@ -1,5 +1,6 @@
 namespace Discord
 {
+    /// <summary> Contains common macros for formatting text using Markdown </summary>
     public static class Format
     {
         /// <summary> Returns a markdown-formatted string with bold formatting. </summary>

src/Discord.Net/LogSeverity.cs

@@ -1,12 +1,19 @@
 namespace Discord
 {
+    /// <summary> The severity of a log message </summary>
     public enum LogSeverity
     {
+        /// <summary> Used when a critical, non-recoverable error occurs </summary>
         Critical = 0,
+        /// <summary> Used when a recoverable error occurs </summary>
         Error = 1,
+        /// <summary> Used when a warning occurs </summary>
         Warning = 2,
+        /// <summary> Used for general, informative messages </summary>
         Info = 3,
+        /// <summary> Used for debugging purposes </summary> 
         Verbose = 4,
+        /// <summary> Used for debugging purposes </summary>
         Debug = 5
     }
 }

src/Discord.Net/LoginState.cs

@@ -1,10 +1,15 @@
 namespace Discord
 {
+    /// <summary> Login state for clients </summary>
     public enum LoginState : byte
     {
+        /// <summary> Logged out </summary>
         LoggedOut,
+        /// <summary> Logging in </summary>
         LoggingIn,
+        /// <summary> Logged in </summary>
         LoggedIn,
+        /// <summary> Logging out </summary>
         LoggingOut
     }
 }

src/Discord.Net/RequestOptions.cs

@@ -1,12 +1,15 @@
 namespace Discord
 {
+    /// <summary> Contains options specific to requests </summary>
     public class RequestOptions
     {
+        /// <summary> Returns the default options for a request. </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>
         public int? Timeout { get; set; }
 
+        /// <summary> Creates a new instance of the RequestOptions class </summary>
         public RequestOptions()
         {
             Timeout = 30000;