Skip to content

update details to show .NET 10 as latest release #49671

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: net10-release
Choose a base branch
from
+149 −138
Open

update details to show .NET 10 as latest release #49671

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
38e355f
update details to show .net 10 as latest release
meaghanlewis Nov 7, 2025
eea34f6
remove LTS from out of support versions
meaghanlewis Nov 7, 2025
cf1c760
Update docs/core/install/linux-ubuntu-decision.md
meaghanlewis Nov 7, 2025
630d141
edits
meaghanlewis Nov 7, 2025
bfcf55d
fix table format
meaghanlewis Nov 7, 2025
24ddb07
clarify .NET 10 as LTS
meaghanlewis Nov 7, 2025
3689227
revert changes to target frameworks
meaghanlewis Nov 7, 2025
537ea6f
change back template version
meaghanlewis Nov 7, 2025
1edca1c
add lts/stable back to .NET SDK 8 snap channel
meaghanlewis Nov 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions api/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@ description: Explore Microsoft's comprehensive .NET API browser. Your ultimate r
layout: ApiBrowserPage
hide_bc: true
title: .NET API browser
quickFilterColumn1: net-9.0,netframework-4.8.1,netstandard-2.1
quickFilterColumn2: aspnetcore-9.0,dotnet-aspire-9.0,net-maui-9.0
quickFilterColumn1: net-10.0,netframework-4.8.1,netstandard-2.1
quickFilterColumn2: aspnetcore-10.0,dotnet-aspire-9.0,net-maui-10.0
quickFilterColumn3: efcore-9.0,azure-dotnet,ml-dotnet
ms.topic: landing-page
ms.custom: "updateeachrelease"
ms.date: 01/23/2025
ms.date: 11/07/2025
---
# .NET API browser

Expand Down
34 changes: 17 additions & 17 deletions docs/core/install/how-to-detect-installed-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Check installed .NET versions on Windows, Linux, and macOS
description: Learn how to list which versions of .NET are installed on your computer. This includes the .NET runtime and SDK.
author: adegeo
ms.author: adegeo
ms.date: 11/11/2024
ms.date: 11/07/2025
ms.custom: updateeachrelease, linux-related-content
zone_pivot_groups: operating-systems-set-one
---
Expand All @@ -29,35 +29,32 @@ You get output similar to the following.
::: zone pivot="os-windows"

```console
3.1.424 [C:\program files\dotnet\sdk]
5.0.100 [C:\program files\dotnet\sdk]
6.0.402 [C:\program files\dotnet\sdk]
7.0.404 [C:\program files\dotnet\sdk]
8.0.100 [C:\program files\dotnet\sdk]
9.0.306 [C:\program files\dotnet\sdk]
10.0.100 [C:\program files\dotnet\sdk]
```

::: zone-end

::: zone pivot="os-linux"

```bash
3.1.424 [/home/user/dotnet/sdk]
5.0.100 [/home/user/dotnet/sdk]
6.0.402 [/home/user/dotnet/sdk]
7.0.404 [/home/user/dotnet/sdk]
8.0.100 [/home/user/dotnet/sdk]
9.0.306 [/home/user/dotnet/sdk]
10.0.100 [/home/user/dotnet/sdk]
```

::: zone-end

::: zone pivot="os-macos"

```bash
3.1.424 [/usr/local/share/dotnet/sdk]
5.0.100 [/usr/local/share/dotnet/sdk]
6.0.402 [/usr/local/share/dotnet/sdk]
7.0.404 [/usr/local/share/dotnet/sdk]
8.0.100 [/usr/local/share/dotnet/sdk]
9.0.306 [/usr/local/share/dotnet/sdk]
10.0.100 [/usr/local/share/dotnet/sdk]
```

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

```console
Microsoft.AspNetCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.NETCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 5.0.17 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.AspNetCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.NETCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.WindowsDesktop.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.NETCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.WindowsDesktop.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
```

::: zone-end
Expand All @@ -109,6 +105,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 6.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 7.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 8.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 9.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
```

::: zone-end
Expand All @@ -130,6 +128,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.Ap
Microsoft.NETCore.App 6.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 7.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 8.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 9.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]
```

::: zone-end
Expand Down
3 changes: 2 additions & 1 deletion docs/core/install/includes/supported-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
---
author: adegeo
ms.author: adegeo
ms.date: 08/26/2025
ms.date: 11/07/2025
ms.topic: include
---

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).

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

- 10.0 (LTS)—Support ends **November 14, 2028**.
- 9.0 (STS)—Support ends **November 10, 2026**.
- 8.0 (LTS)—Support ends **November 10, 2026**.

Expand Down
25 changes: 13 additions & 12 deletions docs/core/install/linux-scripted-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Linux without using a package manager
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.
author: adegeo
ms.author: adegeo
ms.date: 08/26/2025
ms.date: 11/07/2025
ms.custom: linux-related-content, updateeachrelease
---

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

| ✔️ Supported | ❌ Out of support |
|-------------|------------------|
| 9 (STS) | 7 |
| 8 (LTS) | 6 (LTS) |
| | 5 |
| | 3.1 |
| | 3.0 |
| | 2.2 |
| | 2.1 |
| | 2.0 |
| | 1.1 |
| | 1.0 |
|---------------|-------------------|
| 10 (LTS) | 7 |
| 9 (STS) | 6 |
| 8 (LTS) | 5 |
| | 3.1 |
| | 3.0 |
| | 2.2 |
| | 2.1 |
| | 2.0 |
| | 1.1 |
| | 1.0 |

## Dependencies

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

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

- ✔️ [.NET 10 downloads](https://dotnet.microsoft.com/download/dotnet/10.0)
- ✔️ [.NET 9 downloads](https://dotnet.microsoft.com/download/dotnet/9.0)
- ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0)
- [All .NET Core downloads](https://dotnet.microsoft.com/download/dotnet)
Expand Down
7 changes: 4 additions & 3 deletions docs/core/install/linux-snap-sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET SDK on Linux with Snap
description: Learn about how to install the .NET SDK snap package. Canonical maintains and supports .NET-related snap packages.
author: adegeo
ms.author: adegeo
ms.date: 11/11/2024
ms.date: 11/07/2025
ms.topic: install-set-up-deploy
ms.custom: linux-related-content, updateeachrelease
#customer intent: As a Linux user, I want to install .NET SDK through Snap.
Expand Down Expand Up @@ -58,10 +58,11 @@ The following table lists the package channels you can install:

| .NET version | Snap package channel |
|--------------|---------------------------------|
| 10 (LTS) | *Not yet available |
| 9 (STS) | *Not yet available |
| 8 (LTS) | `8.0/stable`<br>`lts/stable` |
| 7 (STS) | `7.0/stable` (out of support) |
| 6 (LTS) | `6.0/stable` (out of support) |
| 7 | `7.0/stable` (out of support) |
| 6 | `6.0/stable` (out of support) |
| 5 | `5.0/stable` (out of support) |
| 3.1 | `3.1/stable` (out of support) |
| 2.1 | `2.1/stable` (out of support) |
Expand Down
21 changes: 12 additions & 9 deletions docs/core/install/linux-ubuntu-decision.md
View file
Open in desktop
Copy link
Contributor

@adegeo adegeo Nov 8, 2025

Choose a reason for hiding this comment

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

Can you remove this from the PR? We can't assume things for Ubuntu, it has a wild history that's settling down, but I need to go through everything closely to make sure it's accurate. I'm going through all the Linux docs in a different branch.

Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: .NET and Ubuntu overview
description: Learn about the ways you can install .NET on Ubuntu, either from the built-in package feed, the .NET backports repository, or the Microsoft repository.
author: adegeo
ms.author: adegeo
ms.date: 03/27/2025
ms.date: 11/07/2025
ms.custom: updateeachrelease, linux-related-content
---

Expand All @@ -21,9 +21,9 @@ The following table is a list of currently supported .NET releases and the versi

| Ubuntu | Supported .NET versions | Available in<br>built-in Ubuntu feed | [Available in<br>.NET backports<br>Ubuntu feed](#register-the-ubuntu-net-backports-package-repository) | [Available in<br>Microsoft feed](#register-the-microsoft-package-repository) |
|--------------------------------------------------------------------|-------------------------|--------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| [25.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2504) | 9.0, 8.0 | 9.0, 8.0 | None | None |
| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 9.0, 8.0 | 8.0 | 9.0, 7.0, 6.0 | None |
| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 9.0, 8.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 |
| [25.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2504) | 10.0, 9.0, 8.0 | 10.0, 9.0, 8.0 | None | None |
| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 10.0, 9.0, 8.0 | 8.0 | 10.0, 9.0, 7.0, 6.0 | None |
| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 10.0, 9.0, 8.0 | 8.0, 7.0, 6.0 | 10.0, 9.0 | 8.0, 7.0, 6.0, 3.1 |

When an [Ubuntu version](https://wiki.ubuntu.com/Releases) reaches the end of its support period, .NET is no longer supported with that particular Ubuntu version.

Expand Down Expand Up @@ -238,10 +238,13 @@ The following sections describe how to manage .NET through the package manager.

### Install .NET

Install .NET through the package manager with the `sudo apt install <package-name>` command. Replace `<package-name>` with the name of the .NET package you want to install. For example, to install .NET SDK 9.0, use the command `sudo apt install dotnet-sdk-9.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)):
Install .NET through the package manager with the `sudo apt install <package-name>` command. Replace `<package-name>` with the name of the .NET package you want to install. For example, to install .NET SDK 10.0, use the command `sudo apt install dotnet-sdk-10.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)):

|| Product | Type | Package |
|---------|--------------|---------|--------------------------|
| | Product | Type | Package |
|------------|--------------|---------|--------------------------|
| **10.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-10.0`|
| **10.0** | .NET | Runtime | `dotnet-runtime-10.0` |
| **10.0** | .NET | SDK | `dotnet-sdk-10.0` |
| **9.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-9.0` |
| **9.0** | .NET | Runtime | `dotnet-runtime-9.0` |
| **9.0** | .NET | SDK | `dotnet-sdk-9.0` |
Expand All @@ -266,11 +269,11 @@ For more information, see [Uninstall .NET](remove-runtime-sdk-versions.md?pivots

### Update .NET

If you installed .NET through a package manager, you can upgrade the package with the `apt upgrade` command. For example, the following commands upgrade the `dotnet-sdk-9.0` package with the latest version:
If you installed .NET through a package manager, you can upgrade the package with the `apt upgrade` command. For example, the following commands upgrade the `dotnet-sdk-10.0` package with the latest version:

```bash
sudo apt update
sudo apt upgrade dotnet-sdk-9.0
sudo apt upgrade dotnet-sdk-10.0
```

> [!TIP]
Expand Down
6 changes: 5 additions & 1 deletion docs/core/project-sdk/msbuild-props.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: MSBuild properties for Microsoft.NET.Sdk
description: Reference for the MSBuild properties and items that are understood by the .NET SDK.
ms.date: 09/30/2025
ms.date: 11/07/2025
ms.topic: reference
ms.custom: updateeachrelease
---
Expand Down Expand Up @@ -977,6 +977,10 @@ The following table shows the values you can specify.
| `latest-<mode>` | The latest code analyzers that have been released are used. The `<mode>` value determines which rules are enabled. |
| `preview` | The latest code analyzers are used, even if they are in preview. |
| `preview-<mode>` | The latest code analyzers are used, even if they are in preview. The `<mode>` value determines which rules are enabled. |
| `10.0` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. |
| `10.0-<mode>` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. The `<mode>` value determines which rules are enabled. |
| `10` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. |
| `10-<mode>` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. The `<mode>` value determines which rules are enabled. |
| `9.0` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. |
| `9.0-<mode>` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. The `<mode>` value determines which rules are enabled. |
| `9` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. |
Expand Down
Loading