From 549df5783c84cec1d7024fc5746ae3bd2437e0d0 Mon Sep 17 00:00:00 2001
From: Matt Smith <me@mattthedev.codes>
Date: Thu, 14 May 2020 01:52:30 -0500
Subject: [PATCH] Additional documentation included.

---
 src/Discord.Net.Core/Entities/Messages/IUserMessage.cs     | 7 +++++--
 src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs  | 2 ++
 .../Entities/Messages/SocketUserMessage.cs                 | 2 ++
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
index 9430e9af2..e2fb25aae 100644
--- a/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
+++ b/src/Discord.Net.Core/Entities/Messages/IUserMessage.cs
@@ -58,14 +58,17 @@ namespace Discord
         Task UnpinAsync(RequestOptions options = null);
 
         /// <summary>
-        ///     Publish (crosspost) this message.
+        ///     Publishes (crossposts) this message.
         /// </summary>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
         ///     A task that represents the asynchronous operation for publishing this message.
         /// </returns>
         /// <remarks>
-        ///     Publishing (crossposting) is only available in news channels.
+        ///     <note type="warning">
+        ///         This call will throw an <see cref="InvalidOperationException"/> if attempted in a non-news channel.
+        ///     </note>
+        ///     This method will publish (crosspost) the message. Please note, publishing (crossposting), is only available in news channels.
         /// </remarks>
         Task CrosspostAsync(RequestOptions options = null);
 
diff --git a/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs b/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
index d116ae341..c55724f66 100644
--- a/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
+++ b/src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs
@@ -149,8 +149,10 @@ namespace Discord.Rest
             => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
 
         /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="RestNewsChannel"/> channel.</exception>
         public async Task CrosspostAsync(RequestOptions options = null)
         {
+            // Validate that the channel is of type RestNewsChannel
             if (!(Channel is RestNewsChannel))
             {
                 throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels.");
diff --git a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
index 56f0f593e..2d08356c7 100644
--- a/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
+++ b/src/Discord.Net.WebSocket/Entities/Messages/SocketUserMessage.cs
@@ -149,8 +149,10 @@ namespace Discord.WebSocket
             => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling);
 
         /// <inheritdoc />
+        /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="SocketNewsChannel"/> channel.</exception>
         public async Task CrosspostAsync(RequestOptions options = null)
         {
+            // Validate that the channel is of type SocketNewsChannel
             if (!(Channel is SocketNewsChannel))
             {
                 throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels.");