Skip to content

Un-encode characters in xref links (Microsoft*, System.IdentityModel, Windows*)#12463

Open
gewarren wants to merge 9 commits intodotnet:mainfrom
gewarren:encoding-8
Open

Un-encode characters in xref links (Microsoft*, System.IdentityModel, Windows*)#12463
gewarren wants to merge 9 commits intodotnet:mainfrom
gewarren:encoding-8

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

@gewarren gewarren commented Mar 30, 2026

  • Replace %60 with `
  • Replace %40 with @
  • Replace %2A with *
  • Replace %2C with ,
  • Replace %28 with (
  • Replace %29 with )
  • Replace %5B with [
  • Replace %5D with ]
  • Replace %7B with {
  • Replace %7D with }

@dotnet-policy-service
Copy link
Copy Markdown
Contributor

@@gewarren - This PR edits one or more files whose 'source of truth' for documentation is not in this repo. Please make documentation updates in the /// comments in the dotnet/runtime repo (or dotnet/extensions repo) instead.

This reverts commit 4eaaf46.
This reverts commit b9a8751.
@gewarren gewarren changed the title Un-encode characters in xref links (System.Linq/System.R*/Microsoft*) Un-encode characters in xref links (Microsoft*, System.IdentityModel, Windows*) Mar 30, 2026
@gewarren gewarren closed this Mar 31, 2026
@gewarren gewarren reopened this Mar 31, 2026
@gewarren gewarren marked this pull request as ready for review April 1, 2026 17:18
@gewarren gewarren requested review from a team and 333fred as code owners April 1, 2026 17:18
Copilot AI review requested due to automatic review settings April 1, 2026 17:18
@gewarren
Copy link
Copy Markdown
Contributor Author

gewarren commented Apr 1, 2026

Build errors are pre-existing.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates ECMAXML documentation content to replace URL-encoded characters in <xref:...> links (notably %60, %2A, %28, %29, %2C, %40) with their literal equivalents (`, *, (, ), ,, @) across multiple namespaces, improving xref readability and consistency.

Changes:

  • Replaced URL-encoded characters in xref DocIDs (for generics, overload markers, and signatures) with literal characters.
  • Normalized some markdown/CDATAs (trimmed trailing spaces / adjusted blank lines) in touched remark blocks.

Reviewed changes

Copilot reviewed 198 out of 288 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
xml/Windows.UI/Color.xml Un-encodes * in xref DocID.
xml/Windows.UI.Xaml.Media/Matrix.xml Un-encodes * in operator xref DocIDs.
xml/Windows.Foundation/Size.xml Un-encodes * in method xref DocIDs.
xml/Windows.Foundation/Point.xml Un-encodes * in method/operator xref DocIDs.
xml/System.IdentityModel/UnsupportedTokenTypeBadRequestException.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel/TypedAsyncResult`1.xml Un-encodes generic marker in xref; markdown whitespace cleanup.
xml/System.IdentityModel/Scope.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel/RsaSignatureCookieTransform.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel/EnvelopedSignatureWriter.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel/DelegatingXmlDictionaryWriter.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel/DelegatingXmlDictionaryReader.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel/AsyncResult.xml Un-encodes generic marker in type xref.
xml/System.IdentityModel.Tokens/X509WindowsSecurityToken.xml Un-encodes * in Dispose xref DocIDs.
xml/System.IdentityModel.Tokens/X509IssuerSerialKeyIdentifierClause.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/X509AsymmetricSecurityKey.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Tokens/WindowsSecurityToken.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/TokenReplayCache.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Tokens/SessionSecurityTokenCacheKey.xml Un-encodes * in method/operator xref DocIDs.
xml/System.IdentityModel.Tokens/SessionSecurityToken.xml Un-encodes * in method xref DocIDs with query string.
xml/System.IdentityModel.Tokens/SecurityTokenValidationException.xml Un-encodes * in method xref DocID; markdown whitespace cleanup.
xml/System.IdentityModel.Tokens/SecurityTokenElement.xml Un-encodes * and parentheses in xref DocIDs.
xml/System.IdentityModel.Tokens/SecurityKeyIdentifierClause.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SecurityKeyIdentifier.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlSubjectStatement.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlStatement.xml Un-encodes * and parentheses in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlSecurityTokenHandler.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlSecurityToken.xml Un-encodes parentheses and generic markers in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlEvidence.xml Un-encodes * and parentheses in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlDoNotCacheCondition.xml Un-encodes * and parentheses in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlConditions.xml Un-encodes * and parentheses in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlCondition.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlAuthorizationDecisionStatement.xml Un-encodes parentheses in method xref DocIDs; un-encodes * in method xrefs.
xml/System.IdentityModel.Tokens/SamlAuthorityBinding.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlAuthenticationStatement.xml Un-encodes parentheses in method xref DocIDs; un-encodes * in method xrefs.
xml/System.IdentityModel.Tokens/SamlAudienceRestrictionCondition.xml Un-encodes parentheses in ctor xref DocIDs; un-encodes * in method xrefs.
xml/System.IdentityModel.Tokens/SamlAttributeStatement.xml Un-encodes parentheses in method xref DocIDs; un-encodes * in method xrefs.
xml/System.IdentityModel.Tokens/SamlAssertionKeyIdentifierClause.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlAdvice.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/SamlAction.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/Saml2SecurityToken.xml Un-encodes parentheses in ctor xref DocIDs; un-encodes generic markers in method xrefs.
xml/System.IdentityModel.Tokens/Saml2AuthenticationContext.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/Saml2Assertion.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Tokens/RsaSecurityToken.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/RsaKeyIdentifierClause.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/LocalIdKeyIdentifierClause.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Tokens/KerberosTicketHashKeyIdentifierClause.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Tokens/KerberosRequestorSecurityToken.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/KerberosReceiverSecurityToken.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/GenericXmlSecurityToken.xml Un-encodes generic markers and * in method xref DocIDs.
xml/System.IdentityModel.Tokens/EncryptedKeyIdentifierClause.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Tokens/AggregateTokenResolver.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/WSFederationMessage.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/SignOutRequestMessage.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/SignOutCleanupRequestMessage.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Services/SignInResponseMessage.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Services/SignInRequestMessage.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Services/SessionSecurityTokenReceivedEventArgs.xml Un-encodes * in method xref DocID with query string.
xml/System.IdentityModel.Services/SessionSecurityTokenCreatedEventArgs.xml Un-encodes * in method xref DocID with query string.
xml/System.IdentityModel.Services/HttpModuleBase.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/FederatedPassiveSecurityTokenServiceOperations.xml Un-encodes parentheses in xref DocIDs; un-encodes * in method xrefs.
xml/System.IdentityModel.Services/FederatedAuthenticationSessionEndingException.xml Un-encodes * in method xref DocID; markdown whitespace cleanup.
xml/System.IdentityModel.Services/FederatedAuthentication.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/ClaimsPrincipalPermissionAttribute.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Services/ChunkedCookieHandler.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Services/AttributeRequestMessage.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Selectors/X509SecurityTokenProvider.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/X509CertificateValidator.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/WindowsUserNameSecurityTokenAuthenticator.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Selectors/WindowsSecurityTokenAuthenticator.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/UserNameSecurityTokenProvider.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Selectors/UserNameSecurityTokenAuthenticator.xml Un-encodes * in method xref DocIDs; un-encodes generic marker in type xref.
xml/System.IdentityModel.Selectors/UserNamePasswordValidator.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/SecurityTokenVersion.xml Un-encodes parentheses in method xref DocID; markdown whitespace cleanup.
xml/System.IdentityModel.Selectors/SamlSecurityTokenAuthenticator.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/RsaSecurityTokenAuthenticator.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Selectors/KerberosSecurityTokenProvider.xml Un-encodes * / parentheses in method xref DocIDs.
xml/System.IdentityModel.Selectors/AudienceUriMode.xml Un-encodes * in method xref DocID.
xml/System.IdentityModel.Protocols.WSTrust/RequestSecurityToken.xml Un-encodes * in method xref DocID with query string.
xml/System.IdentityModel.Protocols.WSTrust/EndpointReference.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Policy/IAuthorizationPolicy.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Policy/AuthorizationContext.xml Un-encodes * and generic marker in type xrefs.
xml/System.IdentityModel.Configuration/SecurityTokenServiceConfiguration.xml Un-encodes parentheses and * in method xref DocIDs.
xml/System.IdentityModel.Configuration/IdentityConfigurationElementCollection.xml Un-encodes * in method xref DocID; markdown whitespace cleanup.
xml/System.IdentityModel.Configuration/IdentityConfiguration.xml Un-encodes * in method xref DocIDs.
xml/System.IdentityModel.Configuration/ICustomIdentityConfiguration.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Claims/X509CertificateClaimSet.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/System.IdentityModel.Claims/DefaultClaimSet.xml Un-encodes * and parentheses in method xref DocIDs; un-encodes generic marker in type xref.
xml/System.IdentityModel.Claims/ClaimSet.xml Un-encodes * / parentheses in method xref DocIDs.
xml/System.IdentityModel.Claims/Claim.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.Windows.Themes/SystemDropShadowChrome.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.Windows.Themes/ScrollChrome.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.Windows.Themes/ListBoxChrome.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.Windows.Themes/DataGridHeaderBorder.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.Win32/SystemEvents.xml Un-encodes * in method xref DocID.
xml/Microsoft.Win32/RegistryView.xml Un-encodes * / parentheses in method xref DocIDs.
xml/Microsoft.Win32/RegistryValueOptions.xml Un-encodes parentheses in method xref DocID; markdown whitespace cleanup.
xml/Microsoft.Win32/RegistryValueKind.xml Un-encodes * in method xref DocIDs; markdown whitespace cleanup.
xml/Microsoft.Win32/RegistryOptions.xml Un-encodes * in method xref DocID; markdown whitespace cleanup.
xml/Microsoft.Win32/RegistryHive.xml Un-encodes * in method xref DocID; markdown whitespace cleanup.
xml/Microsoft.Win32/IntranetZoneCredentialPolicy.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.Win32/CommonDialog.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.Win32.SafeHandles/SafeWaitHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeRegistryHandle.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.Win32.SafeHandles/SafeProcessHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafePipeHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeNCryptSecretHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeNCryptProviderHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeNCryptKeyHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeMemoryMappedViewHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeMemoryMappedFileHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeHandleZeroOrMinusOneIsInvalid.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeHandleMinusOneIsInvalid.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/SafeFileHandle.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/CriticalHandleZeroOrMinusOneIsInvalid.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.Win32.SafeHandles/CriticalHandleMinusOneIsInvalid.xml Un-encodes * in IDisposable xref DocID.
xml/Microsoft.VisualC.StlClr.Generic/ReverseBidirectionalIterator`1.xml Markdown whitespace cleanup; un-encodes parentheses in xref DocID.
xml/Microsoft.VisualBasic/VBCodeProvider.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic/TabInfo.xml Markdown whitespace cleanup; un-encodes * in xref DocIDs.
xml/Microsoft.VisualBasic/SpcInfo.xml Markdown whitespace cleanup; un-encodes * in xref DocIDs.
xml/Microsoft.VisualBasic/OpenMode.xml Markdown whitespace cleanup; un-encodes * in method xref DocID.
xml/Microsoft.VisualBasic/FileSystem.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic/ErrObject.xml Un-encodes * in xref DocIDs.
xml/Microsoft.VisualBasic/DateInterval.xml Markdown whitespace cleanup; un-encodes * in method xref DocID.
xml/Microsoft.VisualBasic/AudioPlayMode.xml Markdown whitespace cleanup; un-encodes * in method xref DocID.
xml/Microsoft.VisualBasic.MyServices.Internal/ContextValue`1.xml Un-encodes generic marker in xref DocID.
xml/Microsoft.VisualBasic.Logging/Log.xml Un-encodes * in xref DocIDs.
xml/Microsoft.VisualBasic.Logging/AspLog.xml Un-encodes * in xref DocIDs.
xml/Microsoft.VisualBasic.FileIO/UIOption.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.FileIO/TextFieldParser.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.FileIO/SearchOption.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.FileIO/RecycleOption.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.FileIO/DeleteDirectoryOption.xml Markdown whitespace cleanup; un-encodes * in method xref DocID.
xml/Microsoft.VisualBasic.Devices/Keyboard.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Devices/Computer.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.CompilerServices/NewLateBinding.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/ZOrderConstants.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/MBindingCollection.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/FormShowConstants.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/FixedLengthString.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/DriveListBox.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.Compatibility.VB6/BaseControlArray.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/WebUser.xml Un-encodes * in method/property xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/ShutdownMode.xml Un-encodes * in method xref DocID.
xml/Microsoft.VisualBasic.ApplicationServices/NoStartupFormException.xml Un-encodes * in property/method xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/ConsoleApplicationBase.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/CantStartSingleInstanceException.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/BuiltInRoleConverter.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.VisualBasic.ApplicationServices/AuthenticationMode.xml Markdown whitespace cleanup; un-encodes * in ctor xref DocID.
xml/Microsoft.VisualBasic.ApplicationServices/AssemblyInfo.xml Un-encodes * in method/property xref DocIDs.
xml/Microsoft.VisualBasic.Activities/VisualBasicValue`1.xml Markdown whitespace cleanup; un-encodes * / generic marker in xref DocIDs.
xml/Microsoft.VisualBasic.Activities/VisualBasicReference`1.xml Markdown whitespace cleanup; un-encodes * / generic marker in xref DocIDs.
xml/Microsoft.VisualBasic.Activities/VisualBasicImportReference.xml Markdown whitespace cleanup; un-encodes generic markers in xref DocIDs.
xml/Microsoft.VisualBasic.Activities/VisualBasic.xml Markdown whitespace cleanup; un-encodes * / generic markers in xref DocIDs.
xml/Microsoft.SqlServer.Server/SqlUserDefinedAggregateAttribute.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.SqlServer.Server/SqlTriggerContext.xml Un-encodes * in method xref DocID.
xml/Microsoft.SqlServer.Server/SqlMethodAttribute.xml Un-encodes * in property xref DocID.
xml/Microsoft.SqlServer.Server/SqlFunctionAttribute.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.SqlServer.Server/SqlFacetAttribute.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.SqlServer.Server/SqlDataRecord.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.SqlServer.Server/SqlContext.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.JScript/ScriptFunction.xml Markdown whitespace cleanup; un-encodes * in xref DocIDs.
xml/Microsoft.JScript/JSScanner.xml Markdown whitespace cleanup; un-encodes parentheses and * in xref DocIDs.
xml/Microsoft.JScript/JSParser.xml Markdown whitespace cleanup; un-encodes parentheses in xref DocIDs.
xml/Microsoft.JScript/IDebugVsaScriptCodeItem.xml Markdown whitespace cleanup; un-encodes * in xref DocIDs.
xml/Microsoft.JScript/ErrorObject.xml Markdown whitespace cleanup; un-encodes * in xref DocIDs.
xml/Microsoft.JScript.Vsa/JSVsaError.xml Un-encodes * in xref DocID query.
xml/Microsoft.CSharp/CSharpCodeProvider.xml Un-encodes * in method xref DocIDs.
xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderInternalCompilerException.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.CSharp.RuntimeBinder/RuntimeBinderException.xml Un-encodes * in property xref DocIDs.
xml/Microsoft.Build.Tasks.Windows/GenerateTemporaryTargetAssembly.xml Un-encodes * in property xref DocID.
xml/Accessibility/IAccIdentity.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.
xml/Accessibility/IAccessibleHandler.xml Markdown whitespace cleanup; un-encodes * in method xref DocIDs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants