Skip to content

Remove references to .NET Framework only APIs#12775

Open
gewarren wants to merge 3 commits into
dotnet:mainfrom
gewarren:netfx-api-refs
Open

Remove references to .NET Framework only APIs#12775
gewarren wants to merge 3 commits into
dotnet:mainfrom
gewarren:netfx-api-refs

Conversation

@gewarren

Copy link
Copy Markdown
Collaborator

Contributes to #12513.

Work done by Copilot.

Copilot AI review requested due to automatic review settings June 22, 2026 22:25
@gewarren gewarren requested review from a team, 333fred and mconnew as code owners June 22, 2026 22:25
@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label Jun 22, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 the .NET API reference ECMA XML sources to remove <altmember> references that point to .NET Framework-only (or otherwise absent) APIs, reducing broken cross-links and modern-.NET confusion as part of issue #12513.

Changes:

  • Removed <altmember> entries across multiple type and namespace XML files where the referenced API is not part of the current documented surface area.
  • Reduced cross-references from modern APIs to legacy/.NET Framework-only types (e.g., remoting, installers, legacy web services).
  • Cleaned up related “see also” navigation in several System., System.Web, WCF, IdentityModel, and Visual Basic docs.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 13 comments.

Show a summary per file
File Description
xml/System/Type.xml Removes legacy COM registration-related <altmember> references.
xml/System/MissingMemberException.xml Removes <altmember> to legacy Emit token type.
xml/System/LocalDataStoreSlot.xml Removes <altmember> to remoting context type.
xml/System/ContextStaticAttribute.xml Removes <altmember> to remoting context type.
xml/System/ContextBoundObject.xml Removes <altmember> to remoting synchronization attribute.
xml/System/AppDomain.xml Removes <altmember> references to AppDomainSetup members that aren’t in the current surface area.
xml/System.Web/HttpUtility.xml Removes <altmember> references to ASP.NET Framework-only server/context APIs.
xml/System.Web.Services/WsiProfiles.xml Removes <altmember> reference to missing binding attribute property.
xml/System.Web.Services.Description/ServiceDescriptionFormatExtension.xml Removes <altmember> references to missing importer types.
xml/System.ServiceProcess/ServiceStartMode.xml Removes <altmember> references to missing installer types.
xml/System.ServiceProcess/ServiceBase.xml Removes <altmember> references to missing installer types.
xml/System.ServiceModel/ServiceSecurityContext.xml Removes <altmember> reference to missing authorization manager type.
xml/System.ServiceModel.Security.Tokens/ServiceModelSecurityTokenRequirement.xml Removes <altmember> references to missing recipient requirement members.
xml/System.ServiceModel.Dispatcher/FaultContractInfo.xml Removes <altmember> reference to dispatcher property.
xml/System.ServiceModel.Description/DataContractSerializerOperationBehavior.xml Removes <altmember> reference to legacy surrogate interface.
xml/System.IdentityModel.Tokens/SecurityToken.xml Removes <altmember> references to missing IdentityModel types.
xml/System.IdentityModel.Selectors/SecurityTokenRequirement.xml Removes <altmember> references to related members (legacy navigation cleanup).
xml/System.IdentityModel.Claims/ClaimTypes.xml Removes <altmember> references to related IdentityModel members/types.
xml/ns-System.Web.UI.WebControls.Expressions.xml Removes <altmember> reference to missing WebForms control.
xml/Microsoft.VisualBasic.Devices/ServerComputer.xml Removes <altmember> reference to missing Ports type.
xml/Microsoft.VisualBasic.Devices/Computer.xml Removes <altmember> reference to missing Ports type.
xml/Microsoft.VisualBasic.ApplicationServices/User.xml Removes <altmember> references to missing System.Web HttpContext APIs and legacy role enum link.
xml/Microsoft.VisualBasic.ApplicationServices/AssemblyInfo.xml Removes <altmember> reference to missing ClickOnce deployment property.

Comment thread xml/ns-System.Web.UI.WebControls.Expressions.xml Outdated
Comment thread xml/System.Web/HttpUtility.xml Outdated
Comment thread xml/System/LocalDataStoreSlot.xml
Comment thread xml/System/MissingMemberException.xml
Comment thread xml/Microsoft.VisualBasic.ApplicationServices/User.xml
Comment thread xml/System/AppDomain.xml
Comment thread xml/System/AppDomain.xml
Comment thread xml/System/AppDomain.xml
Comment thread xml/System/AppDomain.xml
Comment thread xml/System/AppDomain.xml

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Check the Copilot suggestions, but this LGTM.

@gewarren

Copy link
Copy Markdown
Collaborator Author

@BillWagner Could you reapprove after I resolved the merge conflict?

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.

3 participants