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
     {