[New article]: Runtime async in .NET 11

[meaghanlewis]

Proposed topic or title

Runtime async

Location in table of contents.

https://learn.microsoft.com/dotnet/csharp/asynchronous-programming/

Reason for the article

.NET 11 introduces runtime-native async (Runtime Async V2), which moves async suspension and resumption from compiler-generated state machines into the runtime.

The .NET 11 What's New documentation currently provides substantial guidance for this feature, including:

• How to opt in to Runtime Async.
• Cleaner live stack traces.
• NativeAOT and ReadyToRun support.
• Debugging improvements.
• Runtime Async performance improvements.
• Async continuations without ExecutionContext.
• Related runtime diagnostics improvements.

This information is currently concentrated in the .NET 11 What's New content. Because Runtime Async introduces a new execution model for async code, developers need durable conceptual documentation that remains discoverable outside the release-specific What's New article.

Article abstract

Create an evergreen conceptual article for Runtime Async and link to it from the existing async programming, runtime, diagnostics, and Native AOT documentation where appropriate.

The article should cover:

• What Runtime Async is and how it differs from compiler-generated async state machines.
• Feature status and requirements.
• How to enable Runtime Async.
• What code is eligible to use Runtime Async.
• Stack trace and debugging behavior.
• NativeAOT and ReadyToRun support.
• ExecutionContext behavior.
• Performance characteristics that affect developers.
• Diagnostics and profiler considerations.
• Known limitations or unsupported scenarios.
• How to disable or opt out of Runtime Async when necessary.

The .NET 11 What's New article should remain the release summary and link to the evergreen article for detailed guidance.

Acceptance criteria

• An evergreen Runtime Async conceptual article exists.
• The article documents how to enable Runtime Async.
• The article explains the runtime execution model at a developer-appropriate level.
• Debugging and stack-trace behavior are documented.
• NativeAOT and ReadyToRun considerations are documented.
• ExecutionContext behavior is addressed.
• Diagnostics/profiling considerations are documented or linked.
• Preview/feature-status information is clearly identified.
• The .NET 11 Runtime What's New article links to the evergreen guidance.
• Relevant async/runtime documentation links to the new article.

Relevant searches

No response