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
{
///
- /// 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.
///
/// The to transform.
/// The transformed principal.