Document .NET 10 SDK version requirements breaking change

[Copilot]

Summary

This PR documents the breaking change for .NET 10 SDK version requirements, addressing issue #494516.

Changes

New Breaking Change Documentation

Created comprehensive documentation at docs/core/compatibility/sdk/10.0/version-requirements.md that explains:

• Visual Studio 17.14 is now required to load .NET 10.0.100 SDK (starting with RC 2)
• Visual Studio 17.14 only supports targeting .NET 9 and earlier frameworks when using .NET 10 SDK
• Visual Studio 18.0 (Visual Studio 2026) or later is required to target net10.0
• Previous .NET 10 preview versions required Visual Studio 17.13, which has been updated to 17.14 for RC 2 and GA

Updated Index and Navigation

• Added the breaking change entry to the SDK and MSBuild section in docs/core/compatibility/10.0.md
• Added navigation entry to docs/core/compatibility/toc.yml for easy discovery

Updated Versioning Tables

Updated docs/core/porting/versioning-sdk-msbuild-vs.md with:

1. Targeting and support rules table: Added .NET 10.0.100 row showing that the SDK ships with Visual Studio 18.0, requires minimum Visual Studio 17.14, and supports targeting up to net9.0 in the minimum version
2. Preview versioning table: Added 10.0.100 RC 2 entry with Visual Studio 17.14 requirement
3. Support notes: Added clarification that targeting net10.0 is officially supported in Visual Studio 18.0+ only

Impact

Developers using .NET 10 SDK will need to:

• Upgrade to Visual Studio 17.14 or later to load the .NET 10.0.100 SDK (RC 2 and GA)
• Upgrade to Visual Studio 18.0 (Visual Studio 2026) or later to target net10.0 in their projects

This follows the established pattern from previous .NET releases where new SDKs require updated Visual Studio versions to support new framework targets.

Fixes #494516

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Breaking change]: Version requirements for the .NET 10 SDK</issue_title>
<issue_description>### Description

See previous breaking changes: https://learn.microsoft.com/en-us/dotnet/core/compatibility/sdk/8.0/version-requirements

10.0.1xx will require 17.14 to load but only support targeting .NET 9 in that version.

To target net10.0, you must use version 18.0 or later

Version

.NET 10 RC 2

Previous behavior

The previous minimum for .NET 10 previews was 17.13 to allow time for release and more adoption of 17.14

New behavior

10.0.1xx-rc.2 will only load on 17.14 and 10.0.100 will warn if targeting net10.0 on 17.14.

Type of breaking change

• Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
• Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
• Behavioral change: Existing binaries might behave differently at run time.

Reason for change

Planned change

Recommended action

Upgrade to Visual Studio 2026

Feature area

SDK

Affected APIs

No response

---

Associated WorkItem - 494516</issue_description>

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

Fixes #48320

---

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