From 30f9c0f5de922b0b6c9f684d707392bfbede2762 Mon Sep 17 00:00:00 2001
From: Taylor Southwick <tasou@microsoft.com>
Date: Wed, 11 Dec 2024 09:50:30 -0800
Subject: [PATCH] Add a remark to the documentation for
 AddAuthenticationClient(isDefaultScheme)

Fixes #520
---
 .../Authentication/RemoteAppAuthenticationExtensions.cs       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Microsoft.AspNetCore.SystemWebAdapters.CoreServices/Authentication/RemoteAppAuthenticationExtensions.cs b/src/Microsoft.AspNetCore.SystemWebAdapters.CoreServices/Authentication/RemoteAppAuthenticationExtensions.cs
index cb560a84b..f0622d1f9 100644
--- a/src/Microsoft.AspNetCore.SystemWebAdapters.CoreServices/Authentication/RemoteAppAuthenticationExtensions.cs
+++ b/src/Microsoft.AspNetCore.SystemWebAdapters.CoreServices/Authentication/RemoteAppAuthenticationExtensions.cs
@@ -67,6 +67,10 @@ public static AuthenticationBuilder AddRemoteAppAuthentication(this Authenticati
     /// </summary>
     /// <param name="isDefaultScheme">Specifies whether the remote authentication scheme should be the default authentication scheme. If false, remote authentication will only be used for endpoints specifically requiring the remote authentication scheme.</param>
     /// <param name="configureOptions">Configuration options for the remote authentication handler.</param>
+    /// <remarks>
+    /// This API allows you to decide if the remote authentication is the default scheme. However, starting in .NET 7, if there is only a single scheme, it will automatically be the default. To see how to configure this, please read the documentation
+    /// <see href="https://learn.microsoft.com/en-us/dotnet/core/compatibility/aspnet-core/7.0/default-authentication-scheme">here</see>.
+    /// </remarks>
     public static ISystemWebAdapterRemoteClientAppBuilder AddAuthenticationClient(this ISystemWebAdapterRemoteClientAppBuilder builder, bool isDefaultScheme, Action<RemoteAppAuthenticationClientOptions>? configureOptions = null)
     {
         ArgumentNullException.ThrowIfNull(builder);