From 53e70a595fa264311439f57a7180632d4a5bcd0f Mon Sep 17 00:00:00 2001
From: Still Hsu <341464@gmail.com>
Date: Mon, 8 Oct 2018 21:37:21 +0800
Subject: [PATCH] Clarify IUserMessage Add/RemoveReactionAsync samples

---
 .../Entities/Messages/IUserMessage.cs         | 26 ++++++++++++-------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
index b31890e51..1a8c54ab1 100644
--- a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
@@ -12,10 +12,15 @@ namespace Discord
         /// <summary>
         ///     Modifies this message.
         /// </summary>
+        /// <remarks>
+        ///     This method modifies this message with the specified properties. To see an example of this
+        ///     method and what properties are available, please refer to <see cref="MessageProperties"/>.
+        /// </remarks>
         /// <example>
-        /// <code language="cs">
-        /// await msg.ModifyAsync(x =&gt; x.Content = "Hello World!");
-        /// </code>
+        ///     The following example replaces the content of the message with <c>Hello World!</c>.
+        ///     <code language="cs">
+        ///     await msg.ModifyAsync(x =&gt; x.Content = "Hello World!");
+        ///     </code>
         /// </example>
         /// <param name="func">A delegate containing the properties to modify the message with.</param>
         /// <param name="options">The options to be used when sending the request.</param>
@@ -49,9 +54,10 @@ namespace Discord
         ///     Adds a reaction to this message.
         /// </summary>
         /// <example>
-        /// <code language="cs">
-        /// await msg.AddReactionAsync(new Emoji("\U0001f495"));
-        /// </code>
+        ///     The following example adds the reaction, <c>💕</c>, to the message.
+        ///     <code language="cs">
+        ///     await msg.AddReactionAsync(new Emoji("\U0001f495"));
+        ///     </code>
         /// </example>
         /// <param name="emote">The emoji used to react to this message.</param>
         /// <param name="options">The options to be used when sending the request.</param>
@@ -64,9 +70,10 @@ namespace Discord
         ///     Removes a reaction from message.
         /// </summary>
         /// <example>
-        /// <code language="cs">
-        /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), msg.Author);
-        /// </code>
+        ///     The following example removes the reaction, <c>💕</c>, added by the message author from the message.
+        ///     <code language="cs">
+        ///     await msg.RemoveReactionAsync(new Emoji("\U0001f495"), msg.Author);
+        ///     </code>
         /// </example>
         /// <param name="emote">The emoji used to react to this message.</param>
         /// <param name="user">The user that added the emoji.</param>
@@ -89,6 +96,7 @@ namespace Discord
         ///     Gets all users that reacted to a message with a given emote.
         /// </summary>
         /// <example>
+        ///     The following example gets the users that have reacted with the emoji <c>💕</c> to the message.
         ///     <code language="cs">
         ///     var emoji = new Emoji("\U0001f495");
         ///     var reactedUsers = await message.GetReactionUsersAsync(emoji, 100).FlattenAsync();