Skip to content

Cross-link Thread.Abort articles to SYSLIB0006#52296

Open
Copilot wants to merge 4 commits intomainfrom
copilot/link-docs-on-thread-abort
Open

Cross-link Thread.Abort articles to SYSLIB0006#52296
Copilot wants to merge 4 commits intomainfrom
copilot/link-docs-on-thread-abort

Conversation

Copy link
Contributor

Copilot AI commented Mar 13, 2026

~10 conceptual threading articles mention Thread.Abort and discourage its use, but none linked back to the SYSLIB0006 obsoletions article that explains why it's unsupported in .NET 5+.

Changes

  • managed-threading-best-practices.md — Extended the "Don't use Thread.Abort" bullet with .NET 5+ obsolete/PlatformNotSupportedException note, SYSLIB0006 link, and CancellationToken as the alternative
  • exceptions-in-managed-threads.md — Clarified .NET Framework only bullet applies only to Framework; added .NET 5+ behavior and SYSLIB0006 link
  • the-managed-thread-pool.md — Added .NET Framework only scope and SYSLIB0006 link to ThreadAbortException bullet
  • pausing-and-resuming-threads.md — Added SYSLIB0006 link alongside existing destroying-threads.md reference
  • using-threads-and-threading.md — Split one overlong paragraph into two (Framework vs. .NET 5+); updated "not supported in .NET Core" → "not supported in .NET 5 and later"; added SYSLIB0006 link
  • managed-and-unmanaged-threading-in-windows.md — Added [!NOTE] callout after Win32 mapping table intro noting Thread.Abort throws PlatformNotSupportedException in .NET 5+ with SYSLIB0006 link
  • destroying-threads.md — Added SYSLIB0006 to See also section alongside the existing breaking-change article link
Original prompt

This section details on the original issue you should resolve

<issue_title>Remark about Thread.Abort</issue_title>
<issue_description>I did a quick check in our conceptual docs and we have ~10 articles that mention Thread.Abort. Most seem to discourage its use. Should we link those articles back to this one?

Originally posted by @BillWagner in #21156 (comment)</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

📄 File 🔗 Preview link
docs/standard/threading/destroying-threads.md docs/standard/threading/destroying-threads
docs/standard/threading/exceptions-in-managed-threads.md docs/standard/threading/exceptions-in-managed-threads
docs/standard/threading/managed-and-unmanaged-threading-in-windows.md docs/standard/threading/managed-and-unmanaged-threading-in-windows
docs/standard/threading/managed-threading-best-practices.md docs/standard/threading/managed-threading-best-practices
docs/standard/threading/pausing-and-resuming-threads.md docs/standard/threading/pausing-and-resuming-threads
docs/standard/threading/the-managed-thread-pool.md docs/standard/threading/the-managed-thread-pool
docs/standard/threading/using-threads-and-threading.md docs/standard/threading/using-threads-and-threading

Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
Copilot AI changed the title [WIP] Link articles about Thread.Abort usage Cross-link Thread.Abort articles to SYSLIB0006 Mar 13, 2026
Copilot AI requested a review from BillWagner March 13, 2026 16:17
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

This is ready for final review.

@BillWagner BillWagner marked this pull request as ready for review March 16, 2026 14:01
@BillWagner BillWagner requested a review from a team as a code owner March 16, 2026 14:01
@BillWagner BillWagner requested review from Copilot and gewarren March 16, 2026 14:02
Copy link
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 .NET threading conceptual documentation to cross-link Thread.Abort guidance to the SYSLIB0006 obsoletion details, so readers understand why Thread.Abort is unsupported on modern .NET.

Changes:

  • Adds/expands Thread.Abort guidance to distinguish .NET Framework behavior from .NET 5+ behavior and links to SYSLIB0006.
  • Updates related articles with additional references (including Destroying threads and SYSLIB0006) where ThreadAbortException/Thread.Abort is mentioned.
  • Refreshes article metadata (ms.date, and ai-usage where applicable).

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/standard/threading/managed-threading-best-practices.md Expands best-practices guidance for Thread.Abort with modern .NET behavior and SYSLIB0006 link.
docs/standard/threading/exceptions-in-managed-threads.md Clarifies ThreadAbortException applicability and links to SYSLIB0006 for modern .NET behavior.
docs/standard/threading/the-managed-thread-pool.md Adds .NET Framework scoping and SYSLIB0006 link for ThreadAbortException/Thread.Abort mention.
docs/standard/threading/pausing-and-resuming-threads.md Adds SYSLIB0006 link alongside existing Thread.Abort/thread interruption discussion.
docs/standard/threading/using-threads-and-threading.md Splits .NET Framework vs modern .NET guidance for forcibly terminating execution and adds SYSLIB0006 link.
docs/standard/threading/managed-and-unmanaged-threading-in-windows.md Adds a note clarifying modern .NET behavior for Thread.Abort with a SYSLIB0006 link.
docs/standard/threading/destroying-threads.md Adds SYSLIB0006 link to the See also section.

Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
…e and .NET 5+

Co-authored-by: BillWagner <493969+BillWagner@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.

Remark about Thread.Abort

4 participants