From bab16971ae3fe0d117154ab2697b25b5b2056657 Mon Sep 17 00:00:00 2001
From: Hao Kung <haok@microsoft.com>
Date: Wed, 20 Sep 2017 13:04:06 -0700
Subject: [PATCH] Add comment for claims transform

---
 .../IClaimsTransformation.cs                                  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs b/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs
index 8371901506..0193d95783 100644
--- a/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs
+++ b/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs
@@ -12,7 +12,9 @@ namespace Microsoft.AspNetCore.Authentication
     public interface IClaimsTransformation
     {
         /// <summary>
-        /// Provides a central transformation point to change the specified principal.
+        /// Provides a central transformation point to change the specified principal. 
+        /// Note: this will be run on each AuthenticateAsync call, so its safer to
+        /// return a new ClaimsPrincipal if your transformation is not idempotent.
         /// </summary>
         /// <param name="principal">The <see cref="ClaimsPrincipal"/> to transform.</param>
         /// <returns>The transformed principal.</returns>