Skip to content

Remove remarks about out of support .NET versions (System.Data, System.Net, System.Numerics)#12863

Open
gewarren wants to merge 5 commits into
dotnet:mainfrom
gewarren:netcore-set4
Open

Remove remarks about out of support .NET versions (System.Data, System.Net, System.Numerics)#12863
gewarren wants to merge 5 commits into
dotnet:mainfrom
gewarren:netcore-set4

Conversation

@gewarren

@gewarren gewarren commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Contributes to #12648.

Comment thread xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml Outdated
Comment thread xml/System.Diagnostics/Debug.xml Outdated
Comment thread xml/System.Diagnostics/Debug.xml Outdated
Comment thread xml/System.Diagnostics/Debug.xml Outdated
Comment thread xml/System.Diagnostics/Debug.xml Outdated
Comment thread xml/System.Globalization/CompareOptions.xml Outdated
Comment thread xml/System.Net.Http/HttpClient.xml Outdated
Comment thread xml/System.Net.Http/HttpClient.xml Outdated
Comment thread xml/System.Net.Security/SslCertificateTrust.xml Outdated
Comment thread xml/System.Net.Sockets/Socket.xml Outdated
gewarren added 2 commits July 6, 2026 20:38
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren gewarren marked this pull request as ready for review July 7, 2026 03:43
Copilot AI review requested due to automatic review settings July 7, 2026 03:43
@gewarren gewarren requested review from a team as code owners July 7, 2026 03:43

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 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.

Comment thread xml/ns-System.Web.xml
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>

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Suggested change
<summary>This namespace contains the <see cref="T:System.Web.HttpUtility" /> class.</summary>
<summary>To be added.</summary>

Comment thread xml/System.Net.Http/HttpClientHandler.xml
Comment thread xml/System.Net.Http/HttpClient.xml

> [!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.
Comment thread xml/System.Globalization/CompareOptions.xml
Comment thread xml/System.Data/DataSet.xml
Comment thread xml/System.Data/DataTable.xml
Comment thread xml/System.Data/DataSet.xml
Comment thread xml/System.Data/SerializationFormat.xml
Comment thread xml/System.Data/SerializationFormat.xml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants