Skip to content

Remove lost links (and a few manual anchors)#12544

Merged
gewarren merged 7 commits intodotnet:mainfrom
gewarren:lost-links
Apr 24, 2026
Merged

Remove lost links (and a few manual anchors)#12544
gewarren merged 7 commits intodotnet:mainfrom
gewarren:lost-links

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

Contributes to #10722.

(Hide whitespace changes.)

@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label Apr 22, 2026
@gewarren gewarren marked this pull request as ready for review April 22, 2026 21:09
Copilot AI review requested due to automatic review settings April 22, 2026 21:09
@gewarren gewarren requested a review from adegeo April 22, 2026 21:09
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 cleans up .NET API reference XML docs by removing manual HTML anchors and eliminating or fixing malformed / “lost” links, relying more on DocFX’s generated heading anchors and stable Learn URLs.

Changes:

  • Removed manual <a name="..."> anchors and updated intra-page links to match generated heading IDs.
  • Removed or corrected malformed external links (notably several learn.microsoft.com URLs).
  • Normalized some markdown formatting (lists, spacing, and minor punctuation tweaks).

Reviewed changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
xml/System/String.xml Removes a manual anchor before a formatting example section.
xml/System/Math.xml Removes manual anchors and updates intra-page links / remarks formatting around Math.Round.
xml/System/DateTime.xml Updates section links to generated heading IDs; removes manual anchors.
xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml Removes malformed CodeDOM reference links; adjusts repeated remarks text.
xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml Minor spacing cleanup in remarks text.
xml/System.Windows.Media.Effects/ShaderEffect.xml Reflows remarks content and removes a malformed external reference.
xml/System.Windows.Controls/TabItem.xml Removes a lost link in “Customizing” section.
xml/System.Windows.Controls/TabControl.xml Removes a lost link in “Customizing” section.
xml/System.Threading/Lock.xml Fixes Learn URL format for the C# lock-object proposal link.
xml/System.Text/Encoding.xml Updates a Learn blog URL to non-localized form.
xml/System.Runtime.InteropServices/PrimaryInteropAssemblyAttribute.xml Removes malformed external links in remarks.
xml/System.Runtime.InteropServices/InterfaceTypeAttribute.xml Cleans up malformed external references and markdown formatting.
xml/System.Runtime.InteropServices/DispIdAttribute.xml Removes malformed external link and normalizes markdown formatting.
xml/System.Runtime.InteropServices/CoClassAttribute.xml Removes malformed external reference and normalizes markdown formatting.
xml/System.Net/WebRequest.xml Removes malformed external links and leaves type names as plain text in remarks.
xml/System.Management.Instrumentation/WmiProviderInstallationException.xml Removes malformed MI APIs link and simplifies guidance text.
xml/System.Diagnostics/Process.xml Normalizes markdown list formatting and spacing in remarks/notes; minor text cleanup.

Comment thread xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml Outdated
Comment thread xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml Outdated
Comment thread xml/System.Net/WebRequest.xml Outdated
Comment thread xml/System.Text/Encoding.xml Outdated
@gewarren gewarren changed the title Remove lost links (and remove a few manual anchors) Remove lost links (and a few manual anchors) Apr 22, 2026
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Comment thread xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml Outdated
Comment thread xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml Outdated
Comment thread xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml Outdated
@gewarren gewarren enabled auto-merge (squash) April 24, 2026 18:04
@gewarren gewarren merged commit f31dadf into dotnet:main Apr 24, 2026
6 checks passed
@gewarren gewarren deleted the lost-links branch April 24, 2026 21:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants