Add XML docs for ATM public API

[damianh]

Summary

• add XML documentation for all public types and public members in Duende.AccessTokenManagement and Duende.AccessTokenManagement.OpenIdConnect
• improve DPoP API documentation to clarify relationships between DPoPProofKey, DPoPProofRequest, IDPoPProofService, DPoPProof, and nonce/thumbprint types
• add missing docs for IClientCredentialsTokenManager and related API surfaces (token results, OTel, and extensions)
• re-enable CS1591 enforcement for ATM src projects by removing inherited suppression in access-token-management/src/Directory.Build.props

[Copilot]

Pull request overview

This pull request adds/updates XML documentation across the Access Token Management public API surface (core + OpenIdConnect + DPoP + OTel) and removes the inherited CS1591 suppression for the ATM src projects so missing public XML docs are enforced again.

Changes:

• Added/expanded XML docs for public types/members across token result APIs, strongly-typed value wrappers, DPoP APIs, and OpenTelemetry helpers.
• Clarified DPoP documentation to better describe how proof keys, proof requests, proofs, nonces, and thumbprints relate.
• Re-enabled CS1591 for ATM src projects by stripping CS1591 from the inherited NoWarn list.

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
access-token-management/src/Directory.Build.props	Removes inherited CS1591 suppression to enforce public XML docs.
access-token-management/src/AccessTokenManagement/TokenResultExtensions.cs	Adds type-level XML docs for token result extension methods.
access-token-management/src/AccessTokenManagement/TokenResult.cs	Adds/expands docs for token result types and members.
access-token-management/src/AccessTokenManagement/ServiceCollectionExtensions.cs	Documents default resiliency pipeline extension.
access-token-management/src/AccessTokenManagement/Scope.cs	Documents Scope value type and key members/constants.
access-token-management/src/AccessTokenManagement/Scheme.cs	Documents Scheme value type, constants, and members.
access-token-management/src/AccessTokenManagement/Resource.cs	Documents Resource value type and key members/constants.
access-token-management/src/AccessTokenManagement/RefreshToken.cs	Documents RefreshToken value type and key members/constants.
access-token-management/src/AccessTokenManagement/OTel/ActivitySources.cs	Documents activity sources/names emitted by instrumentation.
access-token-management/src/AccessTokenManagement/OTel/AccessTokenManagementMetrics.cs	Documents metrics publisher, meter name, enum values, and methods.
access-token-management/src/AccessTokenManagement/IdentityToken.cs	Documents IdentityToken value type and key members/constants.
access-token-management/src/AccessTokenManagement/IClientCredentialsTokenManager.cs	Documents primary client-credentials token manager API.
access-token-management/src/AccessTokenManagement/HybridCacheConstants.cs	Adds XML docs for cache tag constants container.
access-token-management/src/AccessTokenManagement/HttpRequestContext.cs	Documents request context fields used for HTTP request metadata.
access-token-management/src/AccessTokenManagement/ForceTokenRenewal.cs	Documents force-renewal flag value type.
access-token-management/src/AccessTokenManagement/FailedResult.cs	Documents protocol failure result type and formatting behavior.
access-token-management/src/AccessTokenManagement/DPoP/IDPoPProofService.cs	Clarifies DPoP proof creation/thumbprint responsibilities via docs.
access-token-management/src/AccessTokenManagement/DPoP/IDPoPNonceStoreKeyGenerator.cs	Clarifies nonce cache key generation semantics via docs.
access-token-management/src/AccessTokenManagement/DPoP/IDPoPNonceStore.cs	Clarifies nonce store behavior and async contract via docs.
access-token-management/src/AccessTokenManagement/DPoP/DPoPProofThumbPrint.cs	Improves docs for thumbprint value type and parsing/helpers.
access-token-management/src/AccessTokenManagement/DPoP/DPoPProofRequest.cs	Clarifies proof request parameters and meanings via docs.
access-token-management/src/AccessTokenManagement/DPoP/DPoPProofKey.cs	Adds high-level docs for proof key and related members.
access-token-management/src/AccessTokenManagement/DPoP/DPoPProof.cs	Clarifies proof JWT meaning and lifecycle via docs/remarks.
access-token-management/src/AccessTokenManagement/DPoP/DPoPNonceContext.cs	Clarifies nonce context identity (method + URL) via docs.
access-token-management/src/AccessTokenManagement/DPoP/DPoPNonce.cs	Adds docs for nonce parsing, defaults, and members.
access-token-management/src/AccessTokenManagement/DPoP/DPoPExtensions.cs	Documents HttpRequestMessage option extension methods for DPoP.
access-token-management/src/AccessTokenManagement/ClientSecret.cs	Documents ClientSecret value type and key members.
access-token-management/src/AccessTokenManagement/ClientId.cs	Documents ClientId value type, parsing helpers, and members.
access-token-management/src/AccessTokenManagement/ClientCredentialsTokenManagementBuilder.cs	Documents builder surface for configuring client-credentials clients.
access-token-management/src/AccessTokenManagement/ClientCredentialsClientName.cs	Documents client name value wrapper behavior.
access-token-management/src/AccessTokenManagement/ClientCredentialsCacheKey.cs	Documents cache key wrapper and max length constant.
access-token-management/src/AccessTokenManagement/AccessTokenRequestHandler.cs	Adds inheritdoc/member docs for handler and nested token interface.
access-token-management/src/AccessTokenManagement/AccessToken.cs	Documents access token wrapper and max length constant.
access-token-management/src/AccessTokenManagement.OpenIdConnect/UserToken.cs	Documents DPoP-related property on user token model.
access-token-management/src/AccessTokenManagement.OpenIdConnect/TokenForParameters.cs	Documents NoRefreshToken behavior and invariants.
access-token-management/src/AccessTokenManagement.OpenIdConnect/OpenIdConnectTokenManagementDefaults.cs	Documents scheme-to-client-name helper used internally.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.