Fix XML doc validation warnings

[mikekistler]

Summary

Fix the XML documentation issues called out in the AspNetApiDocs validation report by replacing broken <inheritdoc/>/cref usage with explicit, resolvable documentation.

Why these changes were needed

<inheritdoc/> did not work in these cases because the docs pipeline can only expand it when it can resolve an exact published API member to inherit from. In this set of warnings, that failed for three main reasons:

1. Some members do not actually have an inheritable parent doc source, such as constructors and newly introduced virtual methods.
2. Some parent members or xref targets existed in code, but were not resolvable by the Learn/ECMA2Yaml xref map used for API publishing.
3. Some <see cref="..."> links targeted internal or otherwise non-published types, which produced xref-not-found warnings during doc generation.

Result

This PR makes the generated API docs stable by using explicit summaries/parameter docs or by rewording descriptions to avoid non-resolvable references while preserving the original intent.

This should fix all the warnings in the recent API docs generation PR dotnet/AspNetApiDocs#313.

[Copilot]

Pull request overview

Updates public XML documentation across Security, Routing, OpenAPI, OutputCaching, and Components to eliminate AspNetApiDocs validation warnings by replacing non-resolvable <inheritdoc/> and problematic cref references with explicit summaries/parameter/return documentation.

Changes:

• Replaced <inheritdoc/> on various ToString() overrides with explicit <summary>/<returns> docs.
• Replaced constructor <inheritdoc/> with explicit <param> documentation in multiple authentication event context types.
• Reworded XML docs to avoid non-resolvable cref links while preserving meaning.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/Security/Authorization/Core/src/RolesAuthorizationRequirement.cs	Adds explicit ToString() XML docs to avoid <inheritdoc/> expansion issues.
src/Security/Authorization/Core/src/OperationAuthorizationRequirement.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/NameAuthorizationRequirement.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/DenyAnonymousAuthorizationRequirement.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/ClaimsAuthorizationRequirement.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/AuthorizeAttribute.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/AssertionRequirement.cs	Adds explicit ToString() XML docs.
src/Security/Authorization/Core/src/AllowAnonymousAttribute.cs	Adds explicit ToString() XML docs.
src/Security/Authentication/OpenIdConnect/src/OpenIdConnectHandler.cs	Replaces <inheritdoc/> on HandleRemoteSignOutAsync with explicit XML docs.
src/Security/Authentication/OpenIdConnect/src/Events/UserInformationReceivedContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/OpenIdConnect/src/Events/TokenValidatedContext.cs	Fixes summary punctuation and replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/OpenIdConnect/src/Events/RemoteSignoutContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/OpenIdConnect/src/Events/PushedAuthorizationContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs and removes trailing whitespace.
src/Security/Authentication/OpenIdConnect/src/Events/AuthenticationFailedContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/Negotiate/src/Events/LdapContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/Negotiate/src/Events/AuthenticationFailedContext.cs	Replaces constructor <inheritdoc/> with explicit <param> docs.
src/Security/Authentication/Core/src/TicketSerializer.cs	Replaces <inheritdoc/> with explicit docs for serialize/deserialize and claim-writing APIs.
src/Security/Authentication/Core/src/PropertiesSerializer.cs	Replaces <inheritdoc/> with explicit docs for serialize/deserialize and read/write APIs.
src/OpenApi/src/Extensions/OpenApiEndpointConventionBuilderExtensions.cs	Rewords delegate parameter docs to avoid problematic generic Func<...> cref usage.
src/Middleware/OutputCaching/src/OutputCacheApplicationBuilderExtensions.cs	Rewords summaries to avoid linking to non-resolvable middleware type docs.
src/Http/Routing/src/Builder/RoutingEndpointConventionBuilderExtensions.cs	Rewords summary to avoid cref to metadata type in the description.
src/Http/Routing/src/Builder/EndpointRoutingApplicationBuilderExtensions.cs	Rewords routing/endpoint middleware docs to avoid type cref links; uses method cref references instead.
src/Components/Web/src/WebRenderer.cs	Replaces <inheritdoc/> on Dispose(bool) with explicit XML docs.
src/Components/Forms/src/FieldIdentifier.cs	Replaces <inheritdoc/> with explicit docs for equality/hash code APIs.
src/Components/Forms/src/DataAnnotationsValidator.cs	Replaces <inheritdoc/> with explicit docs for lifecycle and disposal methods.

[mikekistler]

Adding inline rationale for each documentation-only change so the cause of the warnings is clear in the PR diff.

[mikekistler]

This replaces inheritdoc with an explicit summary because HandleRemoteSignOutAsync is its own virtual API here, so the docs pipeline had no resolvable parent member to inherit from.

[mikekistler]

This explicit ToString() documentation avoids the broken inherited reference to System.Attribute.ToString, which the API publishing xref map did not resolve in this build.

[mikekistler]

Same rationale here: explicit docs are more reliable than inheritdoc for this override because the publishing pipeline could not resolve the inherited ToString() reference cleanly.

[mikekistler]

These wording changes avoid linking to internal middleware implementation types that are not published in the Learn xref map, which is what triggered the xref-not-found warnings.

[mikekistler]

This rephrasing preserves the API meaning while avoiding a broken external xref target that the publishing pipeline could not resolve for OpenApiOperation in this context.

[mikekistler]

This change avoids a non-resolvable inherited-doc reference for the override by documenting the requirement directly.

[mikekistler]

This adds explicit text for the override because there is no richer inherited doc source that the published API pipeline can successfully use here.

[mikekistler]

This follows the same ToString() pattern: explicit docs eliminate the inherited-doc publishing suggestion and clarify the API output.

[mikekistler]

These equality/hash members now use direct XML docs because the inherited object/member documentation path was producing doc-generation suggestions instead of stable API text.