From 44da57ce9c296d3cdb80c25c7709afb8f1255e7f Mon Sep 17 00:00:00 2001
From: Mike Kistler <mikekistler@microsoft.com>
Date: Tue, 11 Jun 2024 12:40:16 -0700
Subject: [PATCH 1/3] Minor doc fix

---
 .../src/IAuthenticationHandler.cs                           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
index 7b5287ddfdb2..f477542e1067 100644
--- a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
+++ b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
@@ -18,19 +18,19 @@ public interface IAuthenticationHandler
     Task InitializeAsync(AuthenticationScheme scheme, HttpContext context);
 
     /// <summary>
-    /// Authenticate the current request.
+    /// Authenticate the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
     /// </summary>
     /// <returns>The <see cref="AuthenticateResult"/> result.</returns>
     Task<AuthenticateResult> AuthenticateAsync();
 
     /// <summary>
-    /// Challenge the current request.
+    /// Challenge the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ChallengeAsync(AuthenticationProperties? properties);
 
     /// <summary>
-    /// Forbid the current request.
+    /// Forbid the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ForbidAsync(AuthenticationProperties? properties);

From df4b87257a343e391494fb715635f9e0497233ac Mon Sep 17 00:00:00 2001
From: Mike Kistler <mikekistler@microsoft.com>
Date: Wed, 12 Jun 2024 09:53:44 -0700
Subject: [PATCH 2/3] Apply suggestions from code review

Co-authored-by: Stephen Halter <halter73@gmail.com>
---
 .../src/IAuthenticationHandler.cs                           | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
index f477542e1067..89ce2ef78e02 100644
--- a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
+++ b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
@@ -18,19 +18,19 @@ public interface IAuthenticationHandler
     Task InitializeAsync(AuthenticationScheme scheme, HttpContext context);
 
     /// <summary>
-    /// Authenticate the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
+    /// Authenticate the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
     /// </summary>
     /// <returns>The <see cref="AuthenticateResult"/> result.</returns>
     Task<AuthenticateResult> AuthenticateAsync();
 
     /// <summary>
-    /// Challenge the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
+    /// Challenge the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ChallengeAsync(AuthenticationProperties? properties);
 
     /// <summary>
-    /// Forbid the request associated with the <see cref="HttpContext"/> passed to the InitializeAsync method.
+    /// Forbid the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ForbidAsync(AuthenticationProperties? properties);

From b62f4a8c338cf58bfc3330b66a03fdfe154bbe0d Mon Sep 17 00:00:00 2001
From: Mike Kistler <mikekistler@microsoft.com>
Date: Wed, 12 Jun 2024 09:56:54 -0700
Subject: [PATCH 3/3] simpler fix

---
 .../src/IAuthenticationHandler.cs                         | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
index 89ce2ef78e02..4f2168c5b18a 100644
--- a/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
+++ b/src/Http/Authentication.Abstractions/src/IAuthenticationHandler.cs
@@ -14,23 +14,23 @@ public interface IAuthenticationHandler
     /// Initialize the authentication handler. The handler should initialize anything it needs from the request and scheme as part of this method.
     /// </summary>
     /// <param name="scheme">The <see cref="AuthenticationScheme"/> scheme.</param>
-    /// <param name="context">The <see cref="HttpContext"/> context.</param>
+    /// <param name="context">The <see cref="HttpContext"/> context for the current request.</param>
     Task InitializeAsync(AuthenticationScheme scheme, HttpContext context);
 
     /// <summary>
-    /// Authenticate the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
+    /// Authenticate the current request.
     /// </summary>
     /// <returns>The <see cref="AuthenticateResult"/> result.</returns>
     Task<AuthenticateResult> AuthenticateAsync();
 
     /// <summary>
-    /// Challenge the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
+    /// Challenge the current request.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ChallengeAsync(AuthenticationProperties? properties);
 
     /// <summary>
-    /// Forbid the current request using the <see cref="HttpContext"/> passed to the <see cref="InitializeAsync"/> method.
+    /// Forbid the current request.
     /// </summary>
     /// <param name="properties">The <see cref="AuthenticationProperties"/> that contains the extra meta-data arriving with the authentication.</param>
     Task ForbidAsync(AuthenticationProperties? properties);