From 847b6bf99e0aa930a196662e30cffd9f0b717dd6 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sat, 13 Oct 2018 04:21:55 +0800
Subject: [PATCH] Add additional remarks for Guild/TextChannelProperties

---
 .../Entities/Channels/GuildChannelProperties.cs          | 5 +++++
 .../Entities/Channels/TextChannelProperties.cs           | 9 +++++++++
 2 files changed, 14 insertions(+)

diff --git a/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
index 4e92a2369..1a89fabaf 100644
--- a/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/GuildChannelProperties.cs
@@ -24,6 +24,11 @@ namespace Discord
         /// <summary>
         ///     Gets or sets the category ID for this channel.
         /// </summary>
+        /// <remarks>
+        ///     Setting this value to a category's snowflake identifier will change or set this channel's parent to the
+        ///     specified channel; setting this value to <c>0</c> will remove detach this channel from its parent if one
+        ///     is set.
+        /// </remarks>
         public Optional<ulong?> CategoryId { get; set; }
     }
 }
diff --git a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
index fbc59dba6..c9d0ba1d6 100644
--- a/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
+++ b/src/Discord.Net.Core/Entities/Channels/TextChannelProperties.cs
@@ -11,10 +11,19 @@ namespace Discord
         /// <summary>
         ///     Gets or sets the topic of the channel.
         /// </summary>
+        /// <remarks>
+        ///     Setting this value to any string other than <c>null</c> or <see cref="string.Empty"/> will set the
+        ///     channel topic or description to the desired value.
+        /// </remarks>
         public Optional<string> Topic { get; set; }
         /// <summary>
         ///     Gets or sets whether this channel should be flagged as NSFW.
         /// </summary>
+        /// <remarks>
+        ///     Setting this value to <c>true</c> will mark the channel as NSFW (Not Safe For Work) and will prompt the
+        ///     user about its maturity nature before they may view the channel; setting this value to <c>false</c> will
+        ///     mark this channel as SFW (Safe For Work).
+        /// </remarks>
         public Optional<bool> IsNsfw { get; set; }
         /// <summary>
         ///     Gets or sets the slow-mode ratelimit in seconds for this channel.