Skip to content

Remove .NET Framework remarks (System.Text)#12671

Open
gewarren wants to merge 7 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-text
Open

Remove .NET Framework remarks (System.Text)#12671
gewarren wants to merge 7 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-text

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

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

  • .NET Framework versions
  • Code-access security
  • Configuring apps via app.config file
  • App domains

Also removes all remarks from obsolete APIs.

Hide whitespace changes

Copilot AI review requested due to automatic review settings May 28, 2026 15:20
@gewarren gewarren requested a review from a team as a code owner May 28, 2026 15:20
@dotnet-policy-service
Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @dotnet/area-system-text-encoding

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 the ECMAXML API reference docs to remove or modernize .NET Framework-specific remarks, links, and behavioral notes, primarily within System.Text (and a couple related namespaces), now that .NET Framework API reference content lives in a separate repo.

Changes:

  • Rewrites/removes .NET Framework-specific remarks, notes, and examples (including version-specific behavior callouts).
  • Updates article link text from “in the .NET Framework” to “in .NET” and adjusts wording to be implementation-agnostic.
  • Normalizes/cleans up some markdown formatting (tables, blank lines, notes).

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
xml/System.Text/UTF8Encoding.xml Updates encoding remarks/link text and removes .NET Framework version-specific serialization note wording.
xml/System.Text/UTF7Encoding.xml Updates encoding remarks/link text and removes .NET Framework version-specific serialization note wording.
xml/System.Text/UnicodeEncoding.xml Cleans up markdown spacing and modernizes encoding article link text.
xml/System.Text/StringBuilder.xml Removes .NET Core/.NET Framework split language in usage notes and modernizes formatting/composite-formatting wording.
xml/System.Text/EncodingProvider.xml Rewords remarks to modern .NET framing and updates fallback/encoding-provider guidance.
xml/System.Text/EncodingInfo.xml Updates example wording to refer to .NET rather than .NET Framework.
xml/System.Text/Encoding.xml Removes .NET Framework-specific behavioral notes and simplifies/modernizes guidance around encodings and providers.
xml/System.Text/EncoderReplacementFallback.xml Modernizes wording from “.NET Framework classes” to “.NET classes”.
xml/System.Text/EncoderFallbackBuffer.xml Modernizes wording and updates related article title text.
xml/System.Text/EncoderFallback.xml Modernizes wording and updates related article title text.
xml/System.Text/EncoderExceptionFallback.xml Modernizes wording from “.NET Framework” to “.NET”.
xml/System.Text/DecoderReplacementFallback.xml Modernizes wording from “.NET Framework classes” to “.NET classes”.
xml/System.Text/DecoderFallbackBuffer.xml Modernizes wording and updates related article title text.
xml/System.Text/DecoderFallback.xml Modernizes wording and updates related article title text.
xml/System.Text/DecoderExceptionFallback.xml Modernizes wording from “.NET Framework” to “.NET”.
xml/System.Text/CodePagesEncodingProvider.xml Modernizes wording and reworks guidance to avoid .NET Core-specific framing while keeping provider usage instructions.
xml/System.Text.RegularExpressions/Regex.xml Updates remarks language around CompileToAssembly to remove .NET Framework-specific phrasing.
xml/System.Text.Json/JsonElement.xml Removes .NET Core callouts in remarks and adjusts whitespace/formatting.

Comment thread xml/System.Text/StringBuilder.xml Outdated
Comment thread xml/System.Text.Json/JsonElement.xml Outdated
Comment thread xml/System.Text/EncodingProvider.xml Outdated
Comment thread xml/System.Text/CodePagesEncodingProvider.xml Outdated
Comment on lines 956 to 957
The <xref:System.Text.RegularExpressions.Regex.CompileToAssembly(System.Text.RegularExpressions.RegexCompilationInfo[],System.Reflection.AssemblyName)> method generates a .NET assembly in which each regular expression defined in the `regexinfos` array is represented by a class. Typically, the <xref:System.Text.RegularExpressions.Regex.CompileToAssembly(System.Text.RegularExpressions.RegexCompilationInfo[],System.Reflection.AssemblyName)> method is called from a separate application that generates an assembly of compiled regular expressions. Each regular expression included in the assembly has the following characteristics:

Comment thread xml/System.Text/Encoding.xml
gewarren and others added 6 commits May 29, 2026 11:29
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants