From f65c572230458bc47213c62dc039f57f43d26c9a Mon Sep 17 00:00:00 2001
From: Lala Sabathil <aiko@aitsys.dev>
Date: Thu, 9 Nov 2023 01:05:38 +0100
Subject: [PATCH] docs: mark features as experimental

---
 DisCatSharp.Attributes/Features.cs               |  5 ++++-
 .../DisCatSharpExtensions.cs                     | 16 ++++++++++++++--
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/DisCatSharp.Attributes/Features.cs b/DisCatSharp.Attributes/Features.cs
index ea9374438..30e7a4fec 100644
--- a/DisCatSharp.Attributes/Features.cs
+++ b/DisCatSharp.Attributes/Features.cs
@@ -31,7 +31,10 @@ public enum Features : long
 	ServerSubscription = 1<<6,
 
 	[FeatureDescription("Requires that the application has monetization enabled.")]
-	MonetizedApplication = 1<<7
+	MonetizedApplication = 1<<7,
+
+	[FeatureDescription("Requires that the user and/or guild has a specific experiment and/or treatment.")]
+	Experiment = 1<<8,
 }
 
 
diff --git a/DisCatSharp.Experimental/DisCatSharpExtensions.cs b/DisCatSharp.Experimental/DisCatSharpExtensions.cs
index 6f42bd2de..c984a3dd3 100644
--- a/DisCatSharp.Experimental/DisCatSharpExtensions.cs
+++ b/DisCatSharp.Experimental/DisCatSharpExtensions.cs
@@ -26,7 +26,7 @@ public static async Task<string> GetUsernameAsync(this DiscordClient client, ulo
 	/// </summary>
 	/// <param name="client">The discord client.</param>
 	/// <param name="profileId">The profile id to get.</param>
-	/// <returns></returns>
+	[RequiresFeature(Features.Override, "This method requires the guild and/or user to have access to clyde with treatment 5.")] // TODO: Change to Features.Experiment
 	public static async Task<ClydeProfile> GetClydeProfileAsync(this DiscordClient client, ulong profileId)
 	{
 		DiscordApiClientHook hook = new(client.ApiClient);
@@ -37,6 +37,7 @@ public static async Task<ClydeProfile> GetClydeProfileAsync(this DiscordClient c
 	/// Gets the clyde settings for the given <paramref name="guild"/>.
 	/// </summary>
 	/// <param name="guild">The guild to get clyde's settings for.</param>
+	[RequiresFeature(Features.Override, "This method requires the guild and/or user to have access to clyde with treatment 5.")] // TODO: Change to Features.Experiment
 	public static async Task<ClydeSettings> GetClydeSettingsAsync(this DiscordGuild guild)
 	{
 		DiscordApiClientHook hook = new(guild.Discord.ApiClient);
@@ -48,13 +49,23 @@ public static async Task<ClydeSettings> GetClydeSettingsAsync(this DiscordGuild
 	/// </summary>
 	/// <param name="guild">The guild to modify clyde's settings for.</param>
 	/// <param name="profileId">The profile id to apply.</param>
-	/// <returns></returns>
+	[RequiresFeature(Features.Override, "This method requires the guild and/or user to have access to clyde with treatment 5.")] // TODO: Change to Features.Experiment
 	public static async Task<ClydeSettings> ModifyClydeSettingsAsync(this DiscordGuild guild, ulong profileId)
 	{
 		DiscordApiClientHook hook = new(guild.Discord.ApiClient);
 		return await hook.ModifyClydeSettingsAsync(guild.Id, profileId);
 	}
 
+	/// <summary>
+	/// Modifies the clyde settings for the given <paramref name="guild"/>.
+	/// </summary>
+	/// <param name="guild">The guild to modify clyde's settings for.</param>
+	/// <param name="name">The new name.</param>
+	/// <param name="personality">The new basePersonality.</param>
+	/// <param name="avatar">The new avatar.</param>
+	/// <param name="banner">The new banner.</param>
+	/// <param name="themeColors">The new theme colors.</param>
+	[RequiresFeature(Features.Override, "This method requires the guild and/or user to have access to clyde with treatment 5.")] // TODO: Change to Features.Experiment
 	public static async Task<ClydeSettings> ModifyClydeSettingsAsync(
 		this DiscordGuild guild,
 		Optional<string?> name,
@@ -78,6 +89,7 @@ public static async Task<ClydeSettings> ModifyClydeSettingsAsync(
 	/// </summary>
 	/// <param name="client">The discord client.</param>
 	/// <param name="basePersonality">The base base personality to generate a new one from.</param>
+	[RequiresFeature(Features.Override, "This method requires the guild and/or user to have access to clyde with treatment 5.")] // TODO: Change to Features.Experiment
 	public static async Task<string> GenerateClydePersonalityAsync(this DiscordClient client, string? basePersonality = null)
 	{
 		DiscordApiClientHook hook = new(client.ApiClient);