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.