From e5450200f3933cf78e72f378c8eea75597dfe4d9 Mon Sep 17 00:00:00 2001
From: Gehongyan <gehongyan1996@126.com>
Date: Sun, 26 Feb 2023 00:17:25 +0800
Subject: [PATCH] Adds warning to IGuildUser.Color

---
 src/Kook.Net.Core/Entities/Users/IGuildUser.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/Kook.Net.Core/Entities/Users/IGuildUser.cs b/src/Kook.Net.Core/Entities/Users/IGuildUser.cs
index 99e71866..ee610c60 100644
--- a/src/Kook.Net.Core/Entities/Users/IGuildUser.cs
+++ b/src/Kook.Net.Core/Entities/Users/IGuildUser.cs
@@ -75,6 +75,16 @@ public interface IGuildUser : IUser, IVoiceState
     /// <returns>
     ///     A <see cref="Color"/> struct representing the color the user's display name is being displayed in.
     /// </returns>
+    /// <remarks>
+    ///     <note type="warning">
+    ///         At present, the color of a role may be a solid color or a gradient. See <see cref="IRole.ColorType"/>,
+    ///         which is guaranteed due to the fact that the guild's user list API endpoint returns the color type
+    ///         and the gradient color information if exists. However, the value of this property is fetched
+    ///         from the guild's user list API endpoint, which does not return the color type and the gradient
+    ///         color information. Hence, the value of this property may be incorrect if the color of a role is
+    ///         a gradient.
+    ///     </note>
+    /// </remarks>
     Color Color { get; }
     /// <summary>
     ///     Gets whether this user owns the current guild.