From 0cab2b04d8623254ed01275680b0f9b8fa8943d0 Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Mon, 8 Oct 2018 21:31:23 +0800
Subject: [PATCH] Move IRole.ModifyAsync sample

---
 src/Discord.Net.Core/Entities/Roles/IRole.cs       | 14 ++++----------
 .../Entities/Roles/RoleProperties.cs               | 12 ++++++++++++
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Roles/IRole.cs b/src/Discord.Net.Core/Entities/Roles/IRole.cs
index dcfc89cc6..66556fc2c 100644
--- a/src/Discord.Net.Core/Entities/Roles/IRole.cs
+++ b/src/Discord.Net.Core/Entities/Roles/IRole.cs
@@ -69,16 +69,10 @@ namespace Discord
         /// <summary>
         ///     Modifies this role.
         /// </summary>
-        /// <example>
-        ///     <code language="cs">
-        ///     await role.ModifyAsync(x =&gt;
-        ///     {
-        ///         x.Name = "Sonic";
-        ///         x.Color = new Color(0x1A50BC);
-        ///         x.Mentionable = true;
-        ///     });
-        ///     </code>
-        /// </example>
+        /// <remarks>
+        ///     This method modifies this role with the specified properties. To see an example of this
+        ///     method and what properties are available, please refer to <see cref="RoleProperties"/>.
+        /// </remarks>
         /// <param name="func">A delegate containing the properties to modify the role with.</param>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
diff --git a/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs b/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
index df23cf7b1..a58112b28 100644
--- a/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
+++ b/src/Discord.Net.Core/Entities/Roles/RoleProperties.cs
@@ -3,6 +3,18 @@ namespace Discord
     /// <summary>
     ///     Properties that are used to modify an <see cref="IRole" /> with the specified changes.
     /// </summary>
+    /// <example>
+    ///     The following example modifies the role to a mentionable one, renames the role into <c>Sonic</c>, and
+    ///     changes the color to a light-blue.
+    ///     <code language="cs">
+    ///     await role.ModifyAsync(x =&gt;
+    ///     {
+    ///         x.Name = "Sonic";
+    ///         x.Color = new Color(0x1A50BC);
+    ///         x.Mentionable = true;
+    ///     });
+    ///     </code>
+    /// </example>
     /// <seealso cref="IRole.ModifyAsync" />
     public class RoleProperties
     {