Skip to content

Remove .NET Framework remarks (System.Net/*)#12645

Merged
gewarren merged 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-net
May 23, 2026
Merged

Remove .NET Framework remarks (System.Net/*)#12645
gewarren merged 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-net

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

.NET Framework API ref has moved to its own repo (https://github.com/dotnet/dotnetfw-api-docs), so we can clean up .NET Framework remarks, exceptions, and code examples out of this repo. Contributes to #12513.

Removes remarks and examples related to:

  • .NET Framework versions
  • Code-access security
  • Configuring apps via app.config file
  • App domains

Also remarks all remarks from obsolete APIs.

Hide whitespace changes

@gewarren gewarren requested a review from a team as a code owner May 21, 2026 23:26
Copilot AI review requested due to automatic review settings May 21, 2026 23:26
@dotnet-policy-service
Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @dotnet/ncl

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 the System.Net API reference XML to remove .NET Framework-specific remarks, links, and guidance (for example, CAS, app.config, and application domain notes) now that .NET Framework reference docs live in a separate repo.

Changes:

  • Removed or simplified .NET Framework-targeted remarks, examples, and cross-links across System.Net types.
  • Updated various “network tracing” notes to remove .NET Framework article links and other framework-specific phrasing.
  • Simplified/removed documentation for obsolete APIs and some legacy behaviors.

Reviewed changes

Copilot reviewed 31 out of 33 changed files in this pull request and generated 11 comments.

Show a summary per file
File Description
xml/System.Net/WriteStreamClosedEventArgs.xml Updates Obsolete attribute text (non-Docs metadata) and leaves placeholders in Docs.
xml/System.Net/WebResponse.xml Removes .NET Framework-specific notes; introduces placeholder remarks.
xml/System.Net/WebRequest.xml Removes .NET Framework-specific serialization remark/link; introduces placeholder remarks.
xml/System.Net/WebProxy.xml Updates “not supported” note/exception text; note wording now mismatches API kind.
xml/System.Net/WebPermissionAttribute.xml Removes CAS/declarative security guidance; replaces multiple remarks with placeholders.
xml/System.Net/WebPermission.xml Removes CAS guidance; replaces many member remarks with placeholders.
xml/System.Net/WebHeaderCollection.xml Removes .NET Framework vs .NET Core header restrictions/length-validation notes and exceptions.
xml/System.Net/WebException.xml Removes Windows Store/Windows 8.x-specific warning.
xml/System.Net/SocketPermissionAttribute.xml Removes CAS/declarative security guidance; replaces multiple remarks with placeholders.
xml/System.Net/SocketPermission.xml Removes CAS guidance; replaces many member remarks with placeholders.
xml/System.Net/ServicePointManager.xml Removes .NET Framework version-specific text/links; rewrites TLS opt-out guidance; adds default-value statement.
xml/System.Net/ServicePoint.xml Removes extensive remarks/examples and several .NET Framework-only notes; keeps obsolete include blocks.
xml/System.Net/SecurityProtocolType.xml Removes “.NET Framework” wording and related article link.
xml/System.Net/IWebProxyScript.xml Removes app-domain/PAC/WPAD discussion; replaces with placeholder remark.
xml/System.Net/ICredentialPolicy.xml Removes “application domain” phrasing and minor formatting changes.
xml/System.Net/HttpWebResponse.xml Removes .NET Framework-only tracing links; adjusts exception wording; introduces a markdown formatting issue.
xml/System.Net/HttpWebRequest.xml Removes large amounts of remarks/examples/links and some framework-specific guidance; replaces multiple remarks with placeholders.
xml/System.Net/HttpListenerResponse.xml Removes version-specific header-length exception; adjusts exception formatting.
xml/System.Net/HttpListenerRequest.xml Removes tracing link and network settings schema links.
xml/System.Net/HttpListenerPrefixCollection.xml Removes tracing link text in usage blocks.
xml/System.Net/HttpListenerContext.xml Removes tracing link text in usage blocks.
xml/System.Net/HttpListener.xml Removes tracing link text in usage blocks; retains older OS PNSE text.
xml/System.Net/GlobalProxySelection.xml Removes .NET Framework configuration article link.
xml/System.Net/FtpWebResponse.xml Removes .NET Framework tracing link and framework-version remark; introduces placeholder remark.
xml/System.Net/FtpWebRequest.xml Removes .NET Framework mentions; changes tracing notes; documents Proxy as unsupported and removes related altmembers/examples.
xml/System.Net/FileWebResponse.xml Removes CAS mention and framework-version remark; introduces placeholder remark.
xml/System.Net/FileWebRequest.xml Removes CAS mention; simplifies tracing note and whitespace.
xml/System.Net/DnsPermissionAttribute.xml Removes CAS/declarative security guidance and altmember; introduces placeholder remarks.
xml/System.Net/DnsPermission.xml Removes security-zone defaults; replaces many member remarks with placeholders.
xml/System.Net/Dns.xml Removes .NET Framework tracing links across many members.
xml/System.Net/BindIPEndPoint.xml Removes “.NET Framework” phrasing from remarks.
xml/System.Net/AuthenticationManager.xml Removes detailed remarks and parameter exceptions; marks APIs as always PlatformNotSupported with placeholder remarks.

Comment thread xml/System.Net/WriteStreamClosedEventArgs.xml
Comment thread xml/System.Net/WebProxy.xml Outdated
Comment thread xml/System.Net/FtpWebRequest.xml Outdated
Comment thread xml/System.Net/HttpWebResponse.xml Outdated
Comment thread xml/System.Net/WebResponse.xml
Comment thread xml/System.Net/FtpWebResponse.xml
Comment thread xml/System.Net/ServicePointManager.xml
Comment thread xml/System.Net/HttpWebRequest.xml
Comment thread xml/System.Net/WebPermission.xml
Comment thread xml/System.Net/FtpWebRequest.xml
Comment thread xml/System.Net/ServicePointManager.xml Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren gewarren requested a review from a team May 22, 2026 00:51
Copy link
Copy Markdown
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

This LGTM. Let's :shipit:

@gewarren gewarren merged commit b79c8ec into dotnet:main May 23, 2026
6 checks passed
@gewarren gewarren deleted the fw-remarks-system-net branch May 23, 2026 01:41
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.

3 participants