diff --git a/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs b/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs
index 324d613cf8f5..47d381136f25 100644
--- a/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs
+++ b/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs
@@ -21,8 +21,8 @@ public static class AuthorizationServiceExtensions
/// The resource to evaluate the policy against.
/// The requirement to evaluate the policy against.
///
- /// A flag indicating whether requirement evaluation has succeeded or failed.
- /// This value is true when the user fulfills the policy, otherwise false.
+ /// A that contains an indicating whether requirement evaluation has succeeded or failed.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, object? resource, IAuthorizationRequirement requirement)
{
@@ -40,8 +40,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic
/// The resource to evaluate the policy against.
/// The policy to evaluate.
///
- /// A flag indicating whether policy evaluation has succeeded or failed.
- /// This value is true when the user fulfills the policy, otherwise false.
+ /// A that contains an indicating whether policy evaluation has succeeded or failed.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, object? resource, AuthorizationPolicy policy)
{
@@ -58,8 +58,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic
/// The user to evaluate the policy against.
/// The policy to evaluate.
///
- /// A flag indicating whether policy evaluation has succeeded or failed.
- /// This value is true when the user fulfills the policy, otherwise false.
+ /// A that contains an indicating whether policy evaluation has succeeded or failed.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, AuthorizationPolicy policy)
{
@@ -76,8 +76,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic
/// The user to evaluate the policy against.
/// The name of the policy to evaluate.
///
- /// A flag indicating whether policy evaluation has succeeded or failed.
- /// This value is true when the user fulfills the policy, otherwise false.
+ /// A that contains an indicating whether policy evaluation has succeeded or failed.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, string policyName)
{
diff --git a/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs b/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs
index 1a9474634485..0a1b4c37b382 100644
--- a/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs
+++ b/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs
@@ -56,8 +56,8 @@ public DefaultAuthorizationService(IAuthorizationPolicyProvider policyProvider,
/// The resource to evaluate the requirements against.
/// The requirements to evaluate.
///
- /// A flag indicating whether authorization has succeeded.
- /// This value is true when the user fulfills the policy, otherwise false.
+ /// A that contains an indicating whether authorization has succeeded.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public virtual async Task AuthorizeAsync(ClaimsPrincipal user, object? resource, IEnumerable requirements)
{
@@ -93,8 +93,8 @@ public virtual async Task AuthorizeAsync(ClaimsPrincipal us
/// The resource the policy should be checked with.
/// The name of the policy to check against a specific context.
///
- /// A flag indicating whether authorization has succeeded.
- /// This value is true when the user fulfills the policy otherwise false.
+ /// A that contains an indicating whether authorization has succeeded.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
public virtual async Task AuthorizeAsync(ClaimsPrincipal user, object? resource, string policyName)
{
diff --git a/src/Security/Authorization/Core/src/IAuthorizationService.cs b/src/Security/Authorization/Core/src/IAuthorizationService.cs
index 64ac3b5cd514..5c612869d4de 100644
--- a/src/Security/Authorization/Core/src/IAuthorizationService.cs
+++ b/src/Security/Authorization/Core/src/IAuthorizationService.cs
@@ -22,8 +22,8 @@ public interface IAuthorizationService
///
/// The requirements to evaluate.
///
- /// A flag indicating whether authorization has succeeded.
- /// This value is true when the user fulfills the policy; otherwise false.
+ /// A that contains an indicating whether authorization has succeeded.
+ /// The result's property is true when the user fulfills the policy; otherwise false.
///
///
/// Resource is an optional parameter and may be null. Please ensure that you check it is not
@@ -41,9 +41,8 @@ public interface IAuthorizationService
///
/// The name of the policy to check against a specific context.
///
- /// A flag indicating whether authorization has succeeded.
- /// Returns a flag indicating whether the user, and optional resource has fulfilled the policy.
- /// true when the policy has been fulfilled; otherwise false.
+ /// A that contains an indicating whether authorization has succeeded.
+ /// The result's property is true when the policy has been fulfilled; otherwise false.
///
///
/// Resource is an optional parameter and may be null. Please ensure that you check it is not