Remove remarks about out of support .NET versions (System namespace)#12860
Open
gewarren wants to merge 3 commits into
Open
Remove remarks about out of support .NET versions (System namespace)#12860gewarren wants to merge 3 commits into
gewarren wants to merge 3 commits into
Conversation
Updated remarks section to indicate that content is to be added.
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 System namespace reference docs to remove or generalize remarks that call out out-of-support .NET/.NET Core versions, aligning with issue #12648.
Changes:
- Rephrases several remarks to remove explicit references to older .NET/.NET Core versions.
- Simplifies or removes version-specific behavioral notes in various System API topics.
- Updates a few links / phrasing to be version-agnostic (for example, tutorial titles and project wording).
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| xml/System/Uri.xml | Rewords Unix implicit file path remark to remove “.NET Core” mention. |
| xml/System/UIntPtr.xml | Removes explicit .NET 7 targeting qualifiers from remarks about interfaces / C# behavior. |
| xml/System/Type.xml | Rephrases reflection-ordering remarks to remove older-version comparisons. |
| xml/System/TimeZoneInfo.xml | Removes older-version qualifiers around IANA support and caching behavior; refines ICU-related remarks. |
| xml/System/String.xml | Removes a table mapping Unicode versions to older .NET releases; rewords a sample-project reference. |
| xml/System/MarshalByRefObject.xml | Generalizes obsolescence remarks without referencing .NET 5. |
| xml/System/IntPtr.xml | Removes explicit .NET 7 targeting qualifiers from remarks about interfaces / C# behavior. |
| xml/System/IAsyncDisposable.xml | Updates tutorial link text to remove older-version naming. |
| xml/System/Guid.xml | Removes “starting with .NET 6” qualifier from non-Windows entropy note. |
| xml/System/GC.xml | Removes version-specific remark in AllocateArray/AllocateUninitializedArray docs (currently replaced with a placeholder in one spot). |
| xml/System/Environment.xml | Removes “.NET 5 and later” / “starting with .NET 6” qualifiers from remarks. |
| xml/System/Char.xml | Removes “introduced in .NET Core 3.0” qualifier for System.Text.Rune. |
| ``` | ||
|
|
||
| These implicit file paths are not compliant with the URI specification and should be avoided when possible. When using .NET Core on Unix-based systems, implicit file paths can be especially problematic, because an absolute implicit file path is *indistinguishable* from a relative path. When such ambiguity is present, <xref:System.Uri> default to interpreting the path as an absolute URI. | ||
| These implicit file paths are not compliant with the URI specification and should be avoided when possible. When using .NET on Unix-based systems, implicit file paths can be especially problematic, because an absolute implicit file path is *indistinguishable* from a relative path. When such ambiguity is present, <xref:System.Uri> default to interpreting the path as an absolute URI. |
| ## Examples | ||
|
|
||
| Numerous examples that call the <xref:System.String.Format*> method are interspersed throughout this article. You can also download a complete set of `String.Format` examples, which are included a [.NET Core project for C#](/samples/dotnet/samples/string-format/). | ||
| Numerous examples that call the <xref:System.String.Format*> method are interspersed throughout this article. You can also download a complete set of `String.Format` examples, which are included a [.NET project for C#](/samples/dotnet/samples/string-format/). |
|
|
||
| ]]></format> | ||
| </remarks> | ||
| <remarks>To be added.</remarks> |
Comment on lines
278
to
281
| ## Remarks | ||
|
|
||
| In .NET 7 and earlier versions: If pinned is set to `true`, `T` must not be a reference type or a type that contains object references. | ||
|
|
||
| Skipping zero-initialization is a security risk. The uninitialized array can contain invalid valuetype instances or sensitive information created by other parts of the application. | ||
| The code operating on uninitialized arrays should be heavily scrutinized to ensure that the uninitialized data is never read. |
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.