Sync/Async wrapper article

[BillWagner]

Contributes to #17714

Port the first two articles for wrapping async methods in synchronous methods, and wrapping synchronous methods in asynchronous methods.

---

Internal previews

📄 File	🔗 Preview link
docs/navigate/advanced-programming/toc.yml	docs/navigate/advanced-programming/toc
docs/standard/asynchronous-programming-patterns/async-wrappers-for-synchronous-methods.md	Asynchronous wrappers for synchronous methods
docs/standard/asynchronous-programming-patterns/synchronous-wrappers-for-asynchronous-methods.md	"Synchronous wrappers for asynchronous methods"

[Copilot]

Pull request overview

Adds two new conceptual docs under Asynchronous programming patterns that explain why library authors should generally avoid sync-over-async and async-over-sync wrappers, plus accompanying C# and Visual Basic snippets, and wires the new articles into the Advanced .NET programming TOC.

Changes:

• Add new articles: Asynchronous wrappers for synchronous methods and Synchronous wrappers for asynchronous methods.
• Add runnable C# and VB snippet projects referenced by the new articles.
• Add both articles to docs/navigate/advanced-programming/toc.yml under TAP.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
docs/standard/asynchronous-programming-patterns/synchronous-wrappers-for-asynchronous-methods.md	New conceptual article describing sync-over-async risks and mitigations.
docs/standard/asynchronous-programming-patterns/async-wrappers-for-synchronous-methods.md	New conceptual article describing why async-over-sync wrappers (Task.Run) are usually inappropriate for libraries.
docs/navigate/advanced-programming/toc.yml	Adds the two new articles to the Advanced .NET programming navigation tree.
docs/standard/asynchronous-programming-patterns/snippets/synchronous-wrappers-for-async-methods/csharp/SyncWrappersForAsync.csproj	New C# snippet project for the sync-over-async article.
docs/standard/asynchronous-programming-patterns/snippets/synchronous-wrappers-for-async-methods/csharp/Program.cs	C# snippets demonstrating sync-over-async patterns, deadlock risk, and mitigations.
docs/standard/asynchronous-programming-patterns/snippets/synchronous-wrappers-for-async-methods/vb/SyncWrappersForAsync.vbproj	New VB snippet project for the sync-over-async article.
docs/standard/asynchronous-programming-patterns/snippets/synchronous-wrappers-for-async-methods/vb/Program.vb	VB snippets demonstrating sync-over-async patterns and mitigations.
docs/standard/asynchronous-programming-patterns/snippets/async-wrappers-for-synchronous-methods/csharp/AsyncWrappersForSync.csproj	New C# snippet project for the async-over-sync article.
docs/standard/asynchronous-programming-patterns/snippets/async-wrappers-for-synchronous-methods/csharp/Program.cs	C# snippets demonstrating Task.Run offloading vs scalability.
docs/standard/asynchronous-programming-patterns/snippets/async-wrappers-for-synchronous-methods/vb/AsyncWrappersForSync.vbproj	New VB snippet project for the async-over-sync article.
docs/standard/asynchronous-programming-patterns/snippets/async-wrappers-for-synchronous-methods/vb/Program.vb	VB snippets demonstrating Task.Run offloading vs scalability.