Skip to content

Remove .NET Framework remarks (Numerics, Printing, Resources, ServiceProcess, Transactions)#12685

Open
gewarren wants to merge 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-ntot
Open

Remove .NET Framework remarks (Numerics, Printing, Resources, ServiceProcess, Transactions)#12685
gewarren wants to merge 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-ntot

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 29, 2026 21:47
@gewarren gewarren requested a review from a team as a code owner May 29, 2026 21:47
@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label May 29, 2026
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 cleans up the .NET API reference XML in this repo by removing .NET Framework-specific remarks/exceptions/examples (including CAS/app.config/app-domain guidance), aligning the content with the split to dotnetfw-api-docs and reducing legacy-framework noise in the docs set.

Changes:

  • Removed or rewrote .NET Framework-version-specific remarks across Transactions, Timers, Printing, Resources, ServiceProcess, and Numerics docs.
  • Simplified several remarks blocks by deleting CAS/.NET Framework guidance and trimming framework-only related references.
  • Updated some wording from “.NET Framework” to “.NET” and refreshed a resource documentation link.

Reviewed changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
xml/System.Transactions/TransactionScope.xml Removed “[Supported in .NET Framework …]” qualifiers from constructor summaries.
xml/System.Transactions/EnterpriseServicesInteropOption.xml Reworded remarks to remove “.NET Framework” framing.
xml/System.Transactions/DistributedTransactionPermission.xml Removed .NET Framework/CAS escalation explanation from remarks.
xml/System.Transactions/DependentTransaction.xml Removed app-domain-specific remark and reformatted method remarks.
xml/System.Timers/Timer.xml Removed .NET Framework-specific behavior-change wording and pruned a .NET Framework-only related timer reference.
xml/System.Speech.Recognition/SpeechHypothesizedEventArgs.xml Updated summary wording from “.NET Framework infrastructure” to “.NET infrastructure”.
xml/System.ServiceProcess/ServiceControllerPermissionEntry.xml Removed CAS remarks and multiple CAS-related altmembers; adjusted exception formatting.
xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml Trimmed remarks content to focus on CAS deprecation include.
xml/System.ServiceProcess/ServiceBase.xml Removed .NET Framework install guidance and app-domain unload mention.
xml/System.Resources/ResXResourceWriter.xml Removed .NET Framework-targeting remarks blocks and replaced with placeholders.
xml/System.Resources/ResXResourceReader.xml Removed .NET Framework assembly-reference note from an example.
xml/System.Resources/ResourceWriter.xml Reworded type-name guidance and removed .NET Framework-targeting remarks.
xml/System.Resources/ResourceReader.xml Reworded resource type guidance to remove “.NET Framework” wording.
xml/System.Resources/ResourceManager.xml Removed version qualifier from thread-safety note in remarks.
xml/System.Resources/MissingSatelliteAssemblyException.xml Reworded remarks to remove “.NET Framework” phrasing.
xml/System.Resources.Tools/StronglyTypedResourceBuilder.xml Updated remarks to modern .NET phrasing and refreshed a “Resources in .NET apps” link.
xml/System.Printing/PrintSystemJobInfo.xml Simplified JobStream remarks by removing version/OS qualifier.
xml/System.Printing/PrintQueue.xml Removed a .NET Framework-specific related article link.
xml/System.Numerics/Complex.xml Removed .NET Framework-specific formatting comparison from remarks.

Comment thread xml/System.Resources/ResourceReader.xml Outdated
Comment thread xml/System.Resources/ResourceManager.xml Outdated
Comment thread xml/System.Resources/MissingSatelliteAssemblyException.xml Outdated
Comment thread xml/System.Timers/Timer.xml Outdated
Comment thread xml/System.Resources/ResourceReader.xml Outdated
Comment thread xml/System.Timers/Timer.xml Outdated
Comment thread xml/System.Resources/ResourceReader.xml Outdated
Comment thread xml/System.Resources/ResourceManager.xml Outdated
Comment thread xml/System.Resources/MissingSatelliteAssemblyException.xml Outdated
Comment thread xml/System.Timers/Timer.xml Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants