From 180b20dd02edddfe1d279348516f5d54985eb8f0 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Sun, 27 May 2018 18:19:20 +0800
Subject: [PATCH] Add documentation for new INestedChannel

---
 .../Entities/Channels/INestedChannel.cs       | 20 +++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
index c8d2bcaaf..9c66fb06c 100644
--- a/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
+++ b/src/Discord.Net.Core/Entities/Channels/INestedChannel.cs
@@ -3,14 +3,26 @@ using System.Threading.Tasks;
 namespace Discord
 {
     /// <summary>
-    /// A type of guild channel that can be nested within a category.
-    /// Contains a CategoryId that is set to the parent category, if it is set.
+    ///     Represents a type of guild channel that can be nested within a category.
     /// </summary>
     public interface INestedChannel : IGuildChannel
     {
-        /// <summary> Gets the parentid (category) of this channel in the guild's channel list. </summary>
+        /// <summary>
+        ///     Gets the parent (category) ID of this channel in the guild's channel list.
+        /// </summary>
+        /// <returns>
+        ///     An <see cref="System.UInt64"/> representing the snowflake identifier of the parent of this channel; 
+        ///     <c>null</c> if none is set.
+        /// </returns>
         ulong? CategoryId { get; }
-        /// <summary> Gets the parent channel (category) of this channel, if it is set. If unset, returns null.</summary>
+        /// <summary>
+        ///     Gets the parent (category) channel of this channel.
+        /// </summary>
+        /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        /// <remarks>
+        ///     A generic category channel representing the parent of this channel; <c>null</c> if none is set.
+        /// </remarks>
         Task<ICategoryChannel> GetCategoryAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null);
     }
 }