Remove .NET Framework remarks (System.Net/*)#12645
Merged
Merged
Conversation
Contributor
|
Tagging subscribers to this area: @dotnet/ncl |
Contributor
There was a problem hiding this comment.
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. |
gewarren
commented
May 22, 2026
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
.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:
Also remarks all remarks from obsolete APIs.
Hide whitespace changes