Remove remarks about out of support .NET versions (System.R*, System.S*, System.T*)#12862
Merged
Conversation
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 .NET API reference XML docs to remove or generalize remarks that reference out-of-support .NET (Core/5/6/7) versions, aligning the content with the goal in #12648.
Changes:
- Removed version-qualified remarks and notes across multiple APIs (threading, crypto, interop, reflection, text/JSON).
- Simplified framework/version language in tables and exception descriptions.
- Adjusted some wording to be version-neutral (for example, “starting in .NET X” → unconditional statements).
Reviewed changes
Copilot reviewed 19 out of 19 changed files in this pull request and generated 11 comments.
Show a summary per file
| File | Description |
|---|---|
| xml/System.Threading/ReaderWriterLockSlim.xml | Simplifies NOTE content about lock behavior. |
| xml/System.Threading.Tasks/Task.xml | Updates exception documentation to remove version-dependent limits. |
| xml/System.Text/Encoding.xml | Collapses encoding support table columns and updates UTF-7 note text. |
| xml/System.Text.Json/Utf8JsonWriter.xml | Removes framework/version-specific numeric formatting notes. |
| xml/System.Text.Json/Utf8JsonReader.xml | Removes version-specific performance guidance. |
| xml/System.Text.Json.Serialization/JsonIncludeAttribute.xml | Removes .NET 6/7 limitation note. |
| xml/System.Security.Cryptography/TripleDESCng.xml | Removes version prefix from exception descriptions. |
| xml/System.Security.Cryptography/Oid.xml | Removes version qualifiers around property semantics/exceptions. |
| xml/System.Security.Cryptography/FromBase64Transform.xml | Removes version-dependent behavior explanation for multi-block transform support. |
| xml/System.Security.Cryptography/CryptoStream.xml | Removes “Starting in .NET 6” qualifier from partial-read behavior notes. |
| xml/System.Security.Cryptography/AesCng.xml | Removes version prefix from exception descriptions. |
| xml/System.Security.Authentication/SslProtocols.xml | Removes “starting in .NET 7” phrasing from obsoletion summaries. |
| xml/System.Runtime.Loader/AssemblyLoadContext.xml | Removes .NET Core 2.0–2.2-specific guidance. |
| xml/System.Runtime.InteropServices/RuntimeInformation.xml | Rewords emulation behavior note to be version-neutral. |
| xml/System.Runtime.InteropServices/NativeLibrary.xml | Removes “Starting with .NET 5” qualifier in resolver behavior remark. |
| xml/System.Runtime.InteropServices/Marshal.xml | Removes version qualifiers around NativeMemory and last-error guidance. |
| xml/System.Runtime.InteropServices/DllImportAttribute.xml | Simplifies last-error retrieval guidance to version-neutral wording. |
| xml/System.Reflection/IReflect.xml | Adjusts version ranges described for COM casting behavior. |
| xml/System.Reflection/Assembly.xml | Removes/relaxes version qualifiers for bundled assembly exception and obsoletion remark. |
wadepickett
reviewed
Jul 7, 2026
wadepickett
approved these changes
Jul 8, 2026
wadepickett
left a comment
Contributor
There was a problem hiding this comment.
@gewarren , approved assuming current suggestions fixed. I only found one tiny nit beyond what Copilot already suggested.
Co-authored-by: Wade Pickett <wpickett@microsoft.com>
adegeo
approved these changes
Jul 8, 2026
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.