Better xml documentation

src/Discord.Net.Core/Entities/Gateway/BotGateway.cs

@@ -1,17 +1,21 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Stores the gateway information related to the current bot.
+    /// </summary>
     public class BotGateway
     {
         /// <summary>
-        ///     The WSS URL that can be used for connecting to the gateway.
+        ///     Gets the WSS URL that can be used for connecting to the gateway.
         /// </summary>
         public string Url { get; internal set; }
         /// <summary>
-        ///     The recommended number of shards to use when connecting.
+        ///     Gets the recommended number of shards to use when connecting.
         /// </summary>
         public int Shards { get; internal set; }
         /// <summary>
-        ///     Information on the current session start limit.
+        ///     Gets the <see cref="SessionStartLimit"/> that contains the information
+        ///     about the current session start limit.
         /// </summary>
         public SessionStartLimit SessionStartLimit { get; internal set; }
     }

src/Discord.Net.Core/Entities/Gateway/SessionStartLimit.cs

@@ -1,22 +1,38 @@
 namespace Discord
 {
+    /// <summary>
+    ///     Stores the information related to the gateway identify request.
+    /// </summary>
     public class SessionStartLimit
     {
         /// <summary>
-        ///     The total number of session starts the current user is allowed.
+        ///     Gets the total number of session starts the current user is allowed.
         /// </summary>
+        /// <returns>
+        ///     The maximum amount of session starts the current user is allowed.
+        /// </returns>
         public int Total { get; internal set; }
         /// <summary>
-        ///     The remaining number of session starts the current user is allowed.
+        ///     Gets the remaining number of session starts the current user is allowed.
         /// </summary>
+        /// <returns>
+        ///     The remaining amount of session starts the current user is allowed.
+        /// </returns>
         public int Remaining { get; internal set; }
         /// <summary>
-        ///     The number of milliseconds after which the limit resets.
+        ///     Gets the number of milliseconds after which the limit resets.
         /// </summary>
+        /// <returns>
+        ///     The milliseconds until the limit resets back to the <see cref="Total"/>.
+        /// </returns>
         public int ResetAfter { get; internal set; }
         /// <summary>
-        ///     The maximum concurrent identify requests in a time window.
+        ///     Gets the maximum concurrent identify requests in a time window.
         /// </summary>
+        /// <returns>
+        ///     The maximum concurrent identify requests in a time window,
+        ///     limited to the same rate limit key.
+        /// </returns>
         public int MaxConcurrency { get; internal set; }
     }
 }