diff --git a/src/Discord.Net.Rest/Entities/Gateway/GatewayLimit.cs b/src/Discord.Net.Rest/Entities/Gateway/GatewayLimit.cs
index 036133d3f..3b229dbb9 100644
--- a/src/Discord.Net.Rest/Entities/Gateway/GatewayLimit.cs
+++ b/src/Discord.Net.Rest/Entities/Gateway/GatewayLimit.cs
@@ -6,12 +6,18 @@ namespace Discord.Rest
     public struct GatewayLimit
     {
         /// <summary>
-        ///     Gets or sets the maximum amount of this type of request in a time window, that is set by <see cref="Seconds"/>.
+        ///     Gets or sets the maximum amount of this type of request in a time frame, that is set by <see cref="Seconds"/>.
         /// </summary>
+        /// <returns>
+        ///     Returns the maximum amount of this type of request in a time frame to not trigger the rate limit.
+        /// </returns>
         public int Count { get; set; }
         /// <summary>
-        ///     Gets or sets the amount of seconds until the rate limiter resets the remaining requests <see cref="Count"/>.
+        ///     Gets or sets the amount of seconds until the rate limiter resets the remaining requests back to <see cref="Count"/>.
         /// </summary>
+        /// <returns>
+        ///     Returns the amount of seconds that define the time frame to reset.
+        /// </returns>
         public int Seconds { get; set; }
 
         internal GatewayLimit(int count, int seconds)