From 936cccf9bcb86f3d918d00dbceb031bc2965d21a Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Wed, 12 Sep 2018 17:11:42 +0800
Subject: [PATCH] Cleanup slow-mode-related documentation strings

---
 .../Entities/Channels/ITextChannel.cs                 |  8 +++++++-
 .../Entities/Channels/TextChannelProperties.cs        | 11 ++++++-----
 2 files changed, 13 insertions(+), 6 deletions(-)

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; }
     }
 }