Skip to content

Commit 2dec5a7

Browse files
meaghanlewisCopilot
meaghanlewis
and
Copilot
authored
update details to show .NET 10 as latest release (#49671)
* update details to show .net 10 as latest release * remove LTS from out of support versions * Update docs/core/install/linux-ubuntu-decision.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * edits * fix table format * clarify .NET 10 as LTS * revert changes to target frameworks * change back template version * add lts/stable back to .NET SDK 8 snap channel * revert changes to the main branch version --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 138cd04 commit 2dec5a7

18 files changed

+115
-111
lines changed

‎api/index.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ description: Explore Microsoft's comprehensive .NET API browser. Your ultimate r
33
layout: ApiBrowserPage
44
hide_bc: true
55
title: .NET API browser
6-
quickFilterColumn1: net-9.0,netframework-4.8.1,netstandard-2.1
7-
quickFilterColumn2: aspnetcore-9.0,dotnet-aspire-9.0,net-maui-9.0
6+
quickFilterColumn1: net-10.0,netframework-4.8.1,netstandard-2.1
7+
quickFilterColumn2: aspnetcore-10.0,dotnet-aspire-9.0,net-maui-10.0
88
quickFilterColumn3: efcore-9.0,azure-dotnet,ml-dotnet
99
ms.topic: landing-page
1010
ms.custom: "updateeachrelease"
11-
ms.date: 01/23/2025
11+
ms.date: 11/07/2025
1212
---
1313
# .NET API browser
1414

‎docs/core/install/how-to-detect-installed-versions.md‎

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Check installed .NET versions on Windows, Linux, and macOS
33
description: Learn how to list which versions of .NET are installed on your computer. This includes the .NET runtime and SDK.
44
author: adegeo
55
ms.author: adegeo
6-
ms.date: 11/11/2024
6+
ms.date: 11/07/2025
77
ms.custom: updateeachrelease, linux-related-content
88
zone_pivot_groups: operating-systems-set-one
99
---
@@ -29,35 +29,32 @@ You get output similar to the following.
2929
::: zone pivot="os-windows"
3030

3131
```console
32-
3.1.424 [C:\program files\dotnet\sdk]
33-
5.0.100 [C:\program files\dotnet\sdk]
34-
6.0.402 [C:\program files\dotnet\sdk]
3532
7.0.404 [C:\program files\dotnet\sdk]
3633
8.0.100 [C:\program files\dotnet\sdk]
34+
9.0.306 [C:\program files\dotnet\sdk]
35+
10.0.100 [C:\program files\dotnet\sdk]
3736
```
3837

3938
::: zone-end
4039

4140
::: zone pivot="os-linux"
4241

4342
```bash
44-
3.1.424 [/home/user/dotnet/sdk]
45-
5.0.100 [/home/user/dotnet/sdk]
46-
6.0.402 [/home/user/dotnet/sdk]
4743
7.0.404 [/home/user/dotnet/sdk]
4844
8.0.100 [/home/user/dotnet/sdk]
45+
9.0.306 [/home/user/dotnet/sdk]
46+
10.0.100 [/home/user/dotnet/sdk]
4947
```
5048

5149
::: zone-end
5250

5351
::: zone pivot="os-macos"
5452

5553
```bash
56-
3.1.424 [/usr/local/share/dotnet/sdk]
57-
5.0.100 [/usr/local/share/dotnet/sdk]
58-
6.0.402 [/usr/local/share/dotnet/sdk]
5954
7.0.404 [/usr/local/share/dotnet/sdk]
6055
8.0.100 [/usr/local/share/dotnet/sdk]
56+
9.0.306 [/usr/local/share/dotnet/sdk]
57+
10.0.100 [/usr/local/share/dotnet/sdk]
6158
```
6259

6360
::: zone-end
@@ -75,19 +72,18 @@ You get output similar to the following.
7572
::: zone pivot="os-windows"
7673

7774
```console
78-
Microsoft.AspNetCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
79-
Microsoft.AspNetCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
8075
Microsoft.AspNetCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
8176
Microsoft.AspNetCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
82-
Microsoft.NETCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
83-
Microsoft.NETCore.App 5.0.17 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
84-
Microsoft.NETCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
77+
Microsoft.AspNetCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
78+
Microsoft.AspNetCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
8579
Microsoft.NETCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
8680
Microsoft.NETCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
87-
Microsoft.WindowsDesktop.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
88-
Microsoft.WindowsDesktop.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
81+
Microsoft.NETCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
82+
Microsoft.NETCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
8983
Microsoft.WindowsDesktop.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
9084
Microsoft.WindowsDesktop.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
85+
Microsoft.WindowsDesktop.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
86+
Microsoft.WindowsDesktop.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
9187
```
9288

9389
::: zone-end
@@ -109,6 +105,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
109105
Microsoft.NETCore.App 6.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
110106
Microsoft.NETCore.App 7.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
111107
Microsoft.NETCore.App 8.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
108+
Microsoft.NETCore.App 9.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
109+
Microsoft.NETCore.App 10.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
112110
```
113111

114112
::: zone-end
@@ -130,6 +128,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.Ap
130128
Microsoft.NETCore.App 6.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
131129
Microsoft.NETCore.App 7.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
132130
Microsoft.NETCore.App 8.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
131+
Microsoft.NETCore.App 9.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
132+
Microsoft.NETCore.App 10.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
133133
```
134134

135135
::: zone-end

‎docs/core/install/includes/supported-versions.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
---
22
author: adegeo
33
ms.author: adegeo
4-
ms.date: 08/26/2025
4+
ms.date: 11/07/2025
55
ms.topic: include
66
---
77

88
Microsoft publishes .NET under two different support policies, Long Term Support (LTS) and Standard Term Support (STS). The quality of all releases is the same. The only difference is the length of support. LTS releases get free support and patches for three years. STS releases get free support and patches for two years. For more information, see [.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
99

1010
The versions of .NET that are currently supported by Microsoft are:
1111

12+
- 10.0 (LTS)&mdash;Support ends **November 14, 2028**.
1213
- 9.0 (STS)&mdash;Support ends **November 10, 2026**.
1314
- 8.0 (LTS)&mdash;Support ends **November 10, 2026**.
1415

‎docs/core/install/linux-scripted-manual.md‎

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Install .NET on Linux without using a package manager
33
description: Demonstrates how to install the .NET SDK and the .NET Runtime on Linux without a package manager. Use the install script or manually extract the binaries.
44
author: adegeo
55
ms.author: adegeo
6-
ms.date: 08/26/2025
6+
ms.date: 11/07/2025
77
ms.custom: linux-related-content, updateeachrelease
88
---
99

@@ -20,17 +20,17 @@ There are two types of supported releases, Long Term Support (LTS) and Standard
2020
The following table lists the support status of each version of .NET (and .NET Core):
2121

2222
| ✔️ Supported | ❌ Out of support |
23-
|-------------|------------------|
24-
| 9 (STS) | 7 |
25-
| 8 (LTS) | 6 (LTS) |
26-
| | 5 |
27-
| | 3.1 |
28-
| | 3.0 |
29-
| | 2.2 |
30-
| | 2.1 |
31-
| | 2.0 |
32-
| | 1.1 |
33-
| | 1.0 |
23+
|---------------|-------------------|
24+
| 10 (LTS) | 7 |
25+
| 9 (STS) | 6 |
26+
| 8 (LTS) | 5 |
27+
| | 3.1 |
28+
| | 3.0 |
29+
| | 2.2 |
30+
| | 2.1 |
31+
| | 2.0 |
32+
| | 1.1 |
33+
| | 1.0 |
3434

3535
## Dependencies
3636

@@ -122,6 +122,7 @@ As an alternative to the package managers, you can download and manually install
122122

123123
Download a **binary** release for either the SDK or the runtime from one of the following sites. The .NET SDK includes the corresponding runtime:
124124

125+
- ✔️ [.NET 10 downloads](https://dotnet.microsoft.com/download/dotnet/10.0)
125126
- ✔️ [.NET 9 downloads](https://dotnet.microsoft.com/download/dotnet/9.0)
126127
- ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0)
127128
- [All .NET Core downloads](https://dotnet.microsoft.com/download/dotnet)

‎docs/core/install/linux-snap-sdk.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Install .NET SDK on Linux with Snap
33
description: Learn about how to install the .NET SDK snap package. Canonical maintains and supports .NET-related snap packages.
44
author: adegeo
55
ms.author: adegeo
6-
ms.date: 11/11/2024
6+
ms.date: 11/07/2025
77
ms.topic: install-set-up-deploy
88
ms.custom: linux-related-content, updateeachrelease
99
#customer intent: As a Linux user, I want to install .NET SDK through Snap.
@@ -58,10 +58,11 @@ The following table lists the package channels you can install:
5858
5959
| .NET version | Snap package channel |
6060
|--------------|---------------------------------|
61+
| 10 (LTS) | *Not yet available |
6162
| 9 (STS) | *Not yet available |
6263
| 8 (LTS) | `8.0/stable`<br>`lts/stable` |
63-
| 7 (STS) | `7.0/stable` (out of support) |
64-
| 6 (LTS) | `6.0/stable` (out of support) |
64+
| 7 | `7.0/stable` (out of support) |
65+
| 6 | `6.0/stable` (out of support) |
6566
| 5 | `5.0/stable` (out of support) |
6667
| 3.1 | `3.1/stable` (out of support) |
6768
| 2.1 | `2.1/stable` (out of support) |

‎docs/core/project-sdk/msbuild-props.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: MSBuild properties for Microsoft.NET.Sdk
33
description: Reference for the MSBuild properties and items that are understood by the .NET SDK.
4-
ms.date: 09/30/2025
4+
ms.date: 11/07/2025
55
ms.topic: reference
66
ms.custom: updateeachrelease
77
---

‎docs/core/tools/dotnet-new-sdk-templates.md‎

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .NET default templates for 'dotnet new'
33
description: Learn about 'dotnet new' templates that ship with the .NET SDK.
44
ms.custom: updateeachrelease
55
no-loc: [Blazor, WebAssembly]
6-
ms.date: 08/29/2025
6+
ms.date: 11/07/2025
77
---
88
# Default templates for `dotnet new`
99

@@ -25,8 +25,8 @@ The following table shows the templates that come preinstalled with the .NET SDK
2525

2626
| Templates | Short name | Language | Tags | Introduced |
2727
|-----------------------------|-----------------------------------|----------|-------------------------|------------|
28-
| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 8.0 |
29-
| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 8.0 |
28+
| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 8.0 |
29+
| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 8.0 |
3030
| ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 1.0 |
3131
| ASP.NET Core Web API | [`webapi`](#webapi) | [C#], F# | Web/Web API/API/Service/WebAPI | 1.0 |
3232
| ASP.NET Core Web App (Model-View-Controller) | [`mvc`](#web-options) | [C#], F# | Web/MVC | 1.0 |
@@ -205,9 +205,9 @@ Creates a *Directory.Build.targets* file for customizing MSBuild targets and tas
205205

206206
| SDK version | Default value |
207207
|-------------|---------------|
208+
| 10.0 | `net10.0` |
208209
| 9.0 | `net9.0` |
209210
| 8.0 | `net8.0` |
210-
| 7.0 | `net7.0` |
211211

212212
The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK.
213213

@@ -289,9 +289,9 @@ The ability to create a project for an earlier TFM depends on having that versio
289289

290290
| SDK version | Default value |
291291
|-------------|---------------|
292+
| 10.0 | `net10.0` |
292293
| 9.0 | `net9.0` |
293294
| 8.0 | `net8.0` |
294-
| 7.0 | `net7.0` |
295295

296296
The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK.
297297

@@ -315,9 +315,9 @@ The ability to create a project for an earlier TFM depends on having that versio
315315

316316
| SDK version | Default value |
317317
|-------------|---------------|
318+
| 10.0 | `net10.0` |
318319
| 9.0 | `net9.0` |
319320
| 8.0 | `net8.0` |
320-
| 7.0 | `net7.0` |
321321

322322
The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK.
323323

@@ -419,9 +419,9 @@ The ability to create a project for an earlier TFM depends on having that versio
419419

420420
| SDK version | Default value |
421421
|-------------|---------------|
422+
| 10.0 | `net10.0` |
422423
| 9.0 | `net9.0` |
423424
| 8.0 | `net8.0` |
424-
| 7.0 | `net7.0` |
425425

426426
To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article.
427427

@@ -520,9 +520,9 @@ The ability to create a project for an earlier TFM depends on having that versio
520520

521521
| SDK version | Default value |
522522
|-------------|---------------|
523+
| 10.0 | `net10.0` |
523524
| 9.0 | `net9.0` |
524525
| 8.0 | `net8.0` |
525-
| 7.0 | `net7.0` |
526526

527527
To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article.
528528

@@ -580,6 +580,7 @@ Creates a web API project with AOT publish enabled. For more information, see [N
580580

581581
| SDK version | Default value |
582582
|-------------|---------------|
583+
| 10.0 | `net10.0` |
583584
| 9.0 | `net9.0` |
584585
| 8.0 | `net8.0` |
585586

@@ -664,9 +665,9 @@ Creates a web API project with AOT publish enabled. For more information, see [N
664665

665666
| SDK version | Default value |
666667
|-------------|---------------|
668+
| 10.0 | `net10.0` |
667669
| 9.0 | `net9.0` |
668670
| 8.0 | `net8.0` |
669-
| 7.0 | `net7.0` |
670671

671672
To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article.
672673

@@ -891,9 +892,9 @@ The following table shows templates that have been discontinued and no longer co
891892

892893
| SDK version | Default value |
893894
|-------------|---------------|
895+
| 10.0 | `net10.0` |
894896
| 9.0 | `net9.0` |
895897
| 8.0 | `net8.0` |
896-
| 7.0 | `net7.0` |
897898

898899
To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article.
899900

‎docs/core/versions/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: How the .NET Runtime and SDK are versioned
33
description: This article explains how the .NET SDK and Runtime are versioned (similar to semantic versioning).
44
ms.custom: updateeachrelease
5-
ms.date: 08/26/2025
5+
ms.date: 11/07/2025
66
---
77

88
# How .NET is versioned

‎docs/fundamentals/implementations.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: .NET implementations
33
description: Describes the various .NET implementations, including .NET 5+, .NET Framework, and Mono.
4-
ms.date: 11/22/2024
4+
ms.date: 11/07/2025
55
ms.custom: updateeachrelease
66
---
77
# .NET implementations
@@ -25,7 +25,7 @@ There are three main .NET implementations:
2525

2626
.NET, previously referred to as .NET Core, is currently the primary implementation. .NET is built on a single code base that supports multiple platforms and many workloads, such as Windows desktop apps and cross-platform console apps, cloud services, and websites. [Some workloads](../core/whats-new/dotnet-6.md#sdk-workloads), such as .NET WebAssembly build tools, are available as optional installations.
2727

28-
.NET 9 is the latest version of this .NET implementation. It implements .NET Standard, so code that targets .NET Standard can run on .NET. [ASP.NET Core](https://dotnet.microsoft.com/learn/aspnet/what-is-aspnet-core), [Windows Forms](/dotnet/desktop/winforms/windows-forms-overview), and [Windows Presentation Foundation (WPF)](/dotnet/desktop/wpf/) all run on .NET.
28+
.NET 10 is the latest version of this .NET implementation. It implements .NET Standard, so code that targets .NET Standard can run on .NET. [ASP.NET Core](https://dotnet.microsoft.com/learn/aspnet/what-is-aspnet-core), [Windows Forms](/dotnet/desktop/winforms/windows-forms-overview), and [Windows Presentation Foundation (WPF)](/dotnet/desktop/wpf/) all run on .NET.
2929

3030
For more information, see the following resources:
3131

‎docs/standard/choosing-core-framework-server.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Choose between .NET and .NET Framework for server apps
33
description: A guide to help you decide which implementation of .NET to use when building a server app.
4-
ms.date: 11/22/2024
4+
ms.date: 11/07/2025
55
ms.custom: updateeachrelease
66
---
77
# .NET vs. .NET Framework for server apps
88

9-
There are two supported [.NET implementations](glossary.md#implementation-of-net) for building server-side apps: .NET and .NET Framework. **The latest .NET version (currently .NET 9) is the preferred version of .NET to use for server development.** The reasons to continue using .NET Framework are specific and limited.
9+
There are two supported [.NET implementations](glossary.md#implementation-of-net) for building server-side apps: .NET and .NET Framework. **The latest .NET version (currently .NET 10) is the preferred version of .NET to use for server development.** The reasons to continue using .NET Framework are specific and limited.
1010

1111
| Implementation | Included versions |
1212
|----------------|-----------------------------------------------------|

0 commit comments

Comments
 (0)