Remove remarks about out of support .NET versions (System.Data, System.Net, System.Numerics)#12863
Open
gewarren wants to merge 5 commits into
Open
Remove remarks about out of support .NET versions (System.Data, System.Net, System.Numerics)#12863gewarren wants to merge 5 commits into
gewarren wants to merge 5 commits into
Conversation
Removed detailed summary for System.Web namespace.
gewarren
commented
Jul 7, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates ECMA XML API reference documentation to remove explicit references to out-of-support .NET versions (notably .NET 5–7) across several namespaces, by rewording remarks, exception descriptions, and behavioral notes.
Changes:
- Rewords remarks and exceptions to remove version-specific qualifiers across System.Numerics, System.Net.*, System.IO.Compression, System.Data, System.Diagnostics, and System.Globalization.
- Simplifies/modernizes transport and behavior explanations for HTTP APIs (HttpClient/handlers).
- Updates enum/member descriptions that previously called out version-specific obsoletion or behavior changes.
Reviewed changes
Copilot reviewed 24 out of 24 changed files in this pull request and generated 19 comments.
Show a summary per file
| File | Description |
|---|---|
| xml/System.Numerics/Vector4.xml | Rewords Lerp remarks to remove the “.NET 5” reference while keeping the compatibility link. |
| xml/System.Numerics/Vector2.xml | Rewords Lerp remarks to remove the “.NET 5” reference while keeping the compatibility link. |
| xml/System.Numerics/Vector`1.xml | Removes “.NET 5 and later” qualifiers from repeated NotSupportedException text. |
| xml/System.Net.Sockets/Socket.xml | Removes version qualifiers from several APM cancellation and exception notes. |
| xml/System.Net.Sockets/MulticastOption.xml | Removes “.NET 5 and later” qualifier from an exception description. |
| xml/System.Net.Security/SslClientAuthenticationOptions.xml | Removes “.NET 7 and later” qualifier from SNI-related value text. |
| xml/System.Net.Security/SslCertificateTrust.xml | Rewords platform/version support notes for trusted issuer list behavior. |
| xml/System.Net.Security/EncryptionPolicy.xml | Removes “Starting in .NET 7” phrasing from member summaries. |
| xml/System.Net.NetworkInformation/Ping.xml | Removes “.NET 7 and later” qualifier from Linux-specific exception text. |
| xml/System.Net.Http/WinHttpHandler.xml | Removes “Starting in .NET 5” phrasing for runtime inclusion note. |
| xml/System.Net.Http/SocketsHttpHandler.xml | Simplifies default value description by removing older-version defaults. |
| xml/System.Net.Http/HttpClientHandler.xml | Removes historical “.NET Core 2.1” transport description. |
| xml/System.Net.Http/HttpClient.xml | Removes older-version transport/behavior distinctions and edits timeout notes. |
| xml/System.IO.Compression/GZipStream.xml | Removes “Starting in .NET 6” phrasing from partial read IMPORTANT notes. |
| xml/System.IO.Compression/DeflateStream.xml | Removes “Starting in .NET 6” phrasing from partial read IMPORTANT notes. |
| xml/System.IO.Compression/BrotliStream.xml | Removes “.NET 7 and later” qualifier from invalid CompressionLevel exception text. |
| xml/System.Globalization/CompareOptions.xml | Removes “.NET 5 and later” phrasing and rewords ICU behavior section. |
| xml/System.Diagnostics/Debug.xml | Rewords remarks to remove “introduced in .NET 6” phrasing. |
| xml/System.Diagnostics/ActivityLink.xml | Condenses equality behavior history into version-agnostic statements. |
| xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml | Removes “Starting with .NET Core 2.2” phrasing from runtime event subscription note. |
| xml/System.Data/SerializationFormat.xml | Removes “starting in .NET 7” phrasing from Binary obsoletion remarks. |
| xml/System.Data/DataTable.xml | Removes “.NET 7 and later” qualifiers from serialization/binary-related exception text. |
| xml/System.Data/DataSet.xml | Removes “.NET 7 and later” qualifiers from serialization/binary-related exception text. |
| xml/ns-System.Web.xml | Simplifies namespace summary by removing framework/moniker-specific wording. |
| For <see href="/dotnet/api/system.web?view=netframework-4.8">.NET Framework</see>, this namespace contains classes and interfaces that enable browser-server communication. These classes include the <see cref="T:System.Web.HttpRequest" /> class, which provides extensive information about the current HTTP request; the <see cref="T:System.Web.HttpResponse" /> class, which manages HTTP output to the client; | ||
| and the <see cref="T:System.Web.HttpServerUtility" /> class, which provides access to server-side utilities and processes. <see cref="N:System.Web" /> also includes classes for cookie manipulation, file transfer, exception information, and output cache control in .NET Framework. | ||
| </summary> | ||
| <summary>This namespace contains the <see cref="T:System.Web.HttpUtility" /> class.</summary> |
Collaborator
Author
There was a problem hiding this comment.
Suggested change
| <summary>This namespace contains the <see cref="T:System.Web.HttpUtility" /> class.</summary> | |
| <summary>To be added.</summary> |
|
|
||
| > [!NOTE] | ||
| > In case of timeout, <xref:System.OperationCanceledException> that nests a <xref:System.TimeoutException> is thrown. (On .NET Core versions, <xref:System.OperationCanceledException> without any inner exception is thrown.) | ||
| > In case of timeout, <xref:System.OperationCanceledException> without any inner exception is thrown. |
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.
Contributes to #12648.