diff --git a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
index 6c5d65501..440349eca 100644
--- a/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/ITextChannel.cs
@@ -26,7 +26,13 @@ namespace Discord
         /// </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>
diff --git a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
index 883493176..fbe4bfa43 100644
--- a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
@@ -15,14 +15,15 @@ namespace Discord
         /// </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; }
     }
 }