Make xrefs more readable

[gewarren]

%2A -> *
%2C -> ,
%28 -> (
%29 -> )
%60 -> `

---

Internal previews

Toggle expand/collapse

📄 File	🔗 Preview link
docs/fundamentals/runtime-libraries/system-boolean.md	System.Boolean struct
docs/fundamentals/runtime-libraries/system-collections-generic-hashset{t}.md	System.Collections.Generic.HashSet<T> class
docs/fundamentals/runtime-libraries/system-collections-generic-list{t}.md	System.Collections.Generic.List<T> class
docs/fundamentals/runtime-libraries/system-console.md	System.Console class
docs/fundamentals/runtime-libraries/system-convert.md	docs/fundamentals/runtime-libraries/system-convert
docs/fundamentals/runtime-libraries/system-datetime.md	System.DateTime struct
docs/fundamentals/runtime-libraries/system-double.md	System.Double struct
docs/fundamentals/runtime-libraries/system-globalization-cultureinfo.md	System.Globalization.CultureInfo class
docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo.md	docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo
docs/fundamentals/runtime-libraries/system-globalization-numberformatinfo.md	System.Globalization.NumberFormatInfo class
docs/fundamentals/runtime-libraries/system-idisposable.md	System.IDisposable interface
docs/fundamentals/runtime-libraries/system-invalidoperationexception.md	System.InvalidOperationException class
docs/fundamentals/runtime-libraries/system-linq-expressions-binaryexpression.md	docs/fundamentals/runtime-libraries/system-linq-expressions-binaryexpression
docs/fundamentals/runtime-libraries/system-net-http-httpclient.md	System.Net.Http.HttpClient class
docs/fundamentals/runtime-libraries/system-numerics-biginteger.md	System.Numerics.BigInteger struct
docs/fundamentals/runtime-libraries/system-object-equals.md	System.Object.Equals method
docs/fundamentals/runtime-libraries/system-object-finalize.md	docs/fundamentals/runtime-libraries/system-object-finalize
docs/fundamentals/runtime-libraries/system-object-tostring.md	System.Object.ToString method
docs/fundamentals/runtime-libraries/system-random.md	System.Random class
docs/fundamentals/runtime-libraries/system-security-securestring.md	System.Security.SecureString class
docs/fundamentals/runtime-libraries/system-string-ctor.md	docs/fundamentals/runtime-libraries/system-string-ctor
docs/fundamentals/runtime-libraries/system-string-format.md	System.String.Format method
docs/fundamentals/runtime-libraries/system-string.md	System.String class
docs/fundamentals/runtime-libraries/system-text-rune.md	System.Text.Rune struct
docs/fundamentals/runtime-libraries/system-text-stringbuilder.md	System.Text.StringBuilder class
docs/fundamentals/runtime-libraries/system-threading-monitor-wait.md	docs/fundamentals/runtime-libraries/system-threading-monitor-wait
docs/fundamentals/runtime-libraries/system-threading-monitor.md	System.Threading.Monitor class
docs/fundamentals/runtime-libraries/system-xml-xmlreader-create.md	System.Xml.XmlReader.Create methods
docs/fundamentals/runtime-libraries/system-xml-xmlreader.md	System.Xml.XmlReader class
docs/fundamentals/runtime-libraries/system-xml-xmlwriter.md	docs/fundamentals/runtime-libraries/system-xml-xmlwriter

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

[gewarren]

Policheck failure is a false positive.

[Copilot]

Pull request overview

This PR improves readability of API cross-references in runtime library docs by replacing URL-encoded characters (for example, %2A, %28, %29, %60) with their unescaped equivalents.

Changes:

• Decodes URL-encoded characters in <xref:...> values (for example, %2A → *, %60 → `).
• Updates various method/type xref IDs to more human-readable forms (including generic arity rendering such as `1/`2).
• Applies the same decoding across a wide set of runtime library reference articles and include files.

Reviewed changes

Copilot reviewed 113 out of 147 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
docs/fundamentals/runtime-libraries/system-xml-xsl-xslcompiledtransform.md	Decodes method wildcard xrefs (Load*, Transform*) for readability.
docs/fundamentals/runtime-libraries/system-xml-xmltextwriter.md	Decodes Create*, WriteDocType*, and WriteRaw* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmltextreader.md	Decodes Create*, NodeType*, ReadValueChunk*, ResolveEntity* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmlresolver.md	Decodes Create*, GetEntity*, ResolveUri* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmlreadersettings.md	Decodes Create*, XmlResolver* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmlreadersettings-schemas.md	Decodes Create*, XmlResolver* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmlreadersettings-dtdprocessing.md	Decodes DtdProcessing*, ValidationType*, Create* xrefs.
docs/fundamentals/runtime-libraries/system-xml-xmldocument.md	Decodes various XmlDocument/XmlNode method xrefs to * form.
docs/fundamentals/runtime-libraries/system-xml-xmlconvert.md	Decodes XmlConvert method xrefs (EncodeName*, etc.).
docs/fundamentals/runtime-libraries/system-xml-serialization-xmlserializer.md	Decodes serializer method/ctor xrefs and improves generic type readability.
docs/fundamentals/runtime-libraries/system-xml-linq-xnamespace.md	Decodes XNamespace member xrefs to readable forms.
docs/fundamentals/runtime-libraries/system-xml-linq-xname.md	Decodes XName.Get* and XNamespace.None* xrefs.
docs/fundamentals/runtime-libraries/system-version.md	Decodes * method/property xrefs for readability.
docs/fundamentals/runtime-libraries/system-uri.md	Decodes Uri method xrefs (MakeRelativeUri*, ToString*, etc.).
docs/fundamentals/runtime-libraries/system-typeinitializationexception.md	Decodes ctor/method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-type.md	Decodes Type-related method xrefs and makes them readable.
docs/fundamentals/runtime-libraries/system-type-makegenerictype.md	Decodes MakeGenericType* and related reflection xrefs.
docs/fundamentals/runtime-libraries/system-type-getproperty.md	Decodes GetProperty* and String.Chars* xrefs.
docs/fundamentals/runtime-libraries/system-timespan.md	Decodes TimeSpan method/operator xrefs and ToString* reference.
docs/fundamentals/runtime-libraries/system-timespan-tryparse.md	Decodes DateTimeFormat* and GetFormat* xrefs.
docs/fundamentals/runtime-libraries/system-timespan-parse.md	Decodes TimeSpan.Parse* xrefs.
docs/fundamentals/runtime-libraries/system-threading-tasks-taskscheduler.md	Decodes TPL method xrefs and improves generic type naming.
docs/fundamentals/runtime-libraries/system-text-regularexpressions-regex-match.md	Decodes NextMatch* xref.
docs/fundamentals/runtime-libraries/system-text-encoding.md	Decodes encoding-related method xrefs.
docs/fundamentals/runtime-libraries/system-text-encoding-default.md	Decodes Encoding.Default* / UTF8* xrefs.
docs/fundamentals/runtime-libraries/system-stringcomparer.md	Improves generic type arity display (`2) in xrefs.
docs/fundamentals/runtime-libraries/system-string-isnullorempty.md	Decodes IsNullOrEmpty*, IsNullOrWhiteSpace*, Length* xrefs.
docs/fundamentals/runtime-libraries/system-string-intern.md	Decodes String.Intern* xrefs.
docs/fundamentals/runtime-libraries/system-span{t}.md	Improves generic arity display and decodes method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-single-equals.md	Improves generic arity display and decodes method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-single-compareto.md	Improves generic arity display and decodes method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-security-cryptography-rsaparameters.md	Decodes crypto method xrefs (ExportParameters*).
docs/fundamentals/runtime-libraries/system-security-cryptography-rsacryptoserviceprovider.md	Decodes Array.Reverse* xref.
docs/fundamentals/runtime-libraries/system-runtime-versioning-componentguaranteesattribute.md	Improves generic type arity display in xrefs.
docs/fundamentals/runtime-libraries/system-runtime-serialization-xsddatacontractexporter.md	Decodes exporter method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-runtime-serialization-iextensibledataobject.md	Decodes DataContractAttribute property xrefs.
docs/fundamentals/runtime-libraries/system-runtime-serialization-datacontractserializer.md	Decodes serializer method xrefs and improves generic arity display.
docs/fundamentals/runtime-libraries/system-runtime-serialization-datacontractattribute.md	Decodes DataContractAttribute property xrefs.
docs/fundamentals/runtime-libraries/system-runtime-interopservices-safehandle.md	Decodes Object.Finalize* xref.
docs/fundamentals/runtime-libraries/system-runtime-interopservices-marshal-getactiveobject.md	Decodes Marshal.GetActiveObject* xref.
docs/fundamentals/runtime-libraries/system-runtime-interopservices-icustommarshaler.md	Decodes multiple interface method xrefs.
docs/fundamentals/runtime-libraries/system-runtime-compilerservices-internalsvisibletoattribute.md	Decodes ctor/method/property wildcard xrefs.
docs/fundamentals/runtime-libraries/system-resources-resourcemanager-getobject.md	Decodes GetObject* and CurrentUICulture* xrefs.
docs/fundamentals/runtime-libraries/system-resources-resourcemanager-ctor.md	Decodes CreateFileBasedResourceManager* and Type.Assembly* xrefs.
docs/fundamentals/runtime-libraries/system-resources-missingmanifestresourceexception.md	Decodes ctor/method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-reflection-emit-typebuilder.md	Decodes reflection emit method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-reflection-emit-persistedassemblybuilder.md	Decodes Save* / debug directory builder method xrefs.
docs/fundamentals/runtime-libraries/system-reflection-emit-methodbuilder.md	Decodes module/type/method builder xrefs.
docs/fundamentals/runtime-libraries/system-reflection-emit-assemblybuilder.md	Decodes assembly builder method xrefs.
docs/fundamentals/runtime-libraries/system-object.md	Decodes Object method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-numerics-complex.md	Decodes numeric method/property xrefs.
docs/fundamentals/runtime-libraries/system-nullable{t}.md	Improves generic arity display and decodes member xrefs.
docs/fundamentals/runtime-libraries/system-nullable.md	Improves generic arity display and decodes member xrefs.
docs/fundamentals/runtime-libraries/system-notsupportedexception.md	Decodes ctor/method xrefs.
docs/fundamentals/runtime-libraries/system-notimplementedexception.md	Decodes ctor/method xrefs.
docs/fundamentals/runtime-libraries/system-net-sockets-socket.md	Decodes socket method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-net-httplistener.md	Decodes listener method/property wildcard xrefs.
docs/fundamentals/runtime-libraries/system-net-http-httpclient.md	Improves generic arity display (Task`1) and decodes method xrefs.
docs/fundamentals/runtime-libraries/system-net-ftpwebrequest-proxy.md	Decodes proxy-related xrefs.
docs/fundamentals/runtime-libraries/system-midpointrounding.md	Decodes rounding method xrefs.
docs/fundamentals/runtime-libraries/system-linq-expressions-expression-add.md	Decodes expressions API method/property xrefs.
docs/fundamentals/runtime-libraries/system-linq-expressions-binaryexpression.md	Decodes multiple expression factory xrefs.
docs/fundamentals/runtime-libraries/system-io-filesystemwatcher.md	Decodes watcher method/property xrefs.
docs/fundamentals/runtime-libraries/system-io-filestream.md	Decodes stream/file method xrefs for readability.
docs/fundamentals/runtime-libraries/system-invalidcastexception.md	Decodes conversion/to-string xrefs.
docs/fundamentals/runtime-libraries/system-int64.md	Decodes parse/compare xrefs and unescapes method signatures.
docs/fundamentals/runtime-libraries/system-int32.md	Decodes parse/compare xrefs and unescapes method signatures.
docs/fundamentals/runtime-libraries/system-iasyncdisposable.md	Decodes DisposeAsync* xrefs.
docs/fundamentals/runtime-libraries/system-globalization-sortversion.md	Decodes ctor/property/operator xrefs.
docs/fundamentals/runtime-libraries/system-globalization-regioninfo.md	Decodes ToString* xref.
docs/fundamentals/runtime-libraries/system-globalization-persiancalendar.md	Decodes IsLeapYear* xref.
docs/fundamentals/runtime-libraries/system-globalization-cultureinfo-invariantculture.md	Decodes invariant culture-related property xrefs.
docs/fundamentals/runtime-libraries/system-globalization-cultureinfo-currentuiculture.md	Decodes UI culture xrefs.
docs/fundamentals/runtime-libraries/system-globalization-cultureandregioninfobuilder-ctor.md	Decodes ctor/method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-globalization-compareoptions.md	Decodes compare options method xrefs.
docs/fundamentals/runtime-libraries/system-globalization-compareinfo.md	Decodes compare APIs xrefs used in guidance text.
docs/fundamentals/runtime-libraries/system-flagsattribute.md	Decodes Enum.ToString* / HasFlag* xrefs.
docs/fundamentals/runtime-libraries/system-exception-message.md	Decodes Exception.ToString* xref.
docs/fundamentals/runtime-libraries/system-environment-getenvironmentvariable.md	Decodes environment variable method xrefs.
docs/fundamentals/runtime-libraries/system-dynamic-expandoobject.md	Improves generic type arity display for IDictionary in xrefs.
docs/fundamentals/runtime-libraries/system-drawing-drawing2d-matrix.md	Decodes matrix method xrefs.
docs/fundamentals/runtime-libraries/system-double-equals.md	Improves generic arity display and decodes method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-double-compareto.md	Improves generic arity display and decodes method wildcard xrefs.
docs/fundamentals/runtime-libraries/system-diagnostics-tracing-eventwritteneventargs.md	Decodes tracing callback xrefs.
docs/fundamentals/runtime-libraries/system-diagnostics-tracing-eventsource.md	Decodes WriteEvent* xrefs.
docs/fundamentals/runtime-libraries/system-delegate-createdelegate.md	Decodes CreateDelegate* xrefs.
docs/fundamentals/runtime-libraries/system-decimal.md	Decodes numeric ctor/method xrefs and unescapes signatures.
docs/fundamentals/runtime-libraries/system-datetime-tryparse.md	Decodes parsing-related xrefs and method references.
docs/fundamentals/runtime-libraries/system-datetime-tobinary.md	Decodes ToBinary*/FromBinary* and related xrefs.
docs/fundamentals/runtime-libraries/system-data-datatable.md	Decodes DataTable members/ctor xrefs.
docs/fundamentals/runtime-libraries/system-data-dataset.md	Decodes DataSet method/property xrefs.
docs/fundamentals/runtime-libraries/system-data-commandbehavior.md	Decodes ExecuteReader* xref.
docs/fundamentals/runtime-libraries/system-collections-objectmodel-observablecollection{t}.md	Improves generic arity display for collection xrefs.
docs/fundamentals/runtime-libraries/system-collections-objectmodel-keyedcollection{tkey,titem}-changeitemkey.md	Improves generic arity display for KeyedCollection xrefs.
docs/fundamentals/runtime-libraries/system-byte.md	Decodes parse/compare and method signature xrefs.
docs/fundamentals/runtime-libraries/system-appdomain-unhandledexception.md	Decodes SetUnhandledExceptionMode* xref.
docs/fundamentals/runtime-libraries/system-appcontext.md	Unescapes SetSwitch signature xrefs and decodes TryGetSwitch*.
docs/fundamentals/runtime-libraries/microsoft-win32-registry.md	Decodes GetValue* / SetValue* xrefs.
docs/fundamentals/runtime-libraries/includes/stringbuilder-perf-note.md	Unescapes Chars(Int32) and decodes related StringBuilder xrefs.

Comments suppressed due to low confidence (1)

docs/fundamentals/runtime-libraries/system-notsupportedexception.md:1

• Correct typo: 'Ycan' should be 'You can'.