From 227853e33a3e471b1dac0a008f3e7e0667cdc08b Mon Sep 17 00:00:00 2001
From: Chris Johnston <chjohnston@protonmail.com>
Date: Wed, 12 Jun 2019 21:03:49 -0700
Subject: [PATCH] clarify remark on inverted logic for system channel flags

---
 src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
index 2114d154a..c4cf3bab4 100644
--- a/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
+++ b/src/Discord.Net.Core/Entities/Guilds/GuildProperties.cs
@@ -72,8 +72,14 @@ namespace Discord
         public Optional<ExplicitContentFilterLevel> ExplicitContentFilter { get; set; }
         /// <summary>
         ///     Gets or sets the flags that DISABLE types of system channels.
-        ///     This logic is inverted!
         /// </summary>
+        /// <remarks>
+        ///     These flags are inverted. Setting a flag will disable that system channel message from being sent.
+        ///     A value of <see cref="SystemChannelMessageDeny.None"/> will allow all system channel message types to be sent,
+        ///     given that the <see cref="SystemChannelId"/> has also been sent.
+        ///     Refer to the extension methods <see cref="GuildExtensions.GetGuildBoostMessagesEnabled(IGuild)"/> and <see cref="GuildExtensions.GetWelcomeMessagesEnabled(IGuild)"/>
+        ///     to check if these system channel messages are enabled, without the need to manipulate the flags.
+        /// </remarks>
         public Optional<SystemChannelMessageDeny> SystemChannelFlags { get; set; }
     }
 }