Installer updates windows/mac/linux #49686
Conversation
There was a problem hiding this comment.
Pull Request Overview
This PR updates the .NET installation documentation to include .NET 10, which was released on November 11, 2025. The changes add .NET 10 support across all platform installation guides, update version tables, add new package references, and update examples to use .NET 10 instead of previous versions.
Key changes include:
- Adding .NET 10 to all supported platform version tables
- Updating code examples to reference .NET 10 packages and versions
- Adding Ubuntu 25.10 support and reorganizing Ubuntu version documentation
- Updating release dates across documentation files
- Creating new include files for .NET 10 installation instructions
Reviewed Changes
Copilot reviewed 25 out of 25 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| zone-pivot-groups.yml | Added Ubuntu 25.10 pivot and removed "Other" option |
| windows.md | Added .NET 10 column to tables, updated examples to 10.0, expanded verification section |
| templates.md | Added .NET 10.0 template packages |
| macos.md | Added macOS 26 and .NET 10 support, updated examples |
| linux-ubuntu-install.md | Major reorganization: added Ubuntu 25.10, updated dependencies, restructured version sections |
| linux-ubuntu-decision.md | Added Ubuntu 25.10 to version table, updated examples to .NET 10 |
| linux-rhel.md | Added RHEL 10 and CentOS Stream 10, updated instructions |
| linux-sles.md | Added SLES 16.0 and 15.7, updated version table |
| linux-opensuse.md | Added openSUSE Leap 16 support with .NET 10 |
| linux-fedora.md | Added Fedora 43 and 42 with .NET 10 |
| linux-debian.md | Added Debian 13 support, restructured dependencies |
| linux-alpine.md | Added Alpine 3.22 support, updated architecture table |
| linux-scripted-manual.md | Updated default LTS version claim and examples |
| linux.md | Fixed markdown escaping for issue reference |
| includes/*.md | Created new include files for .NET 10 installation commands, updated existing includes |
| | ASP.NET Core 7.0 | [`Microsoft.DotNet.Web.ProjectTemplates.7.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.7.0) | | ||
| | ASP.NET Core 8.0 | [`Microsoft.DotNet.Web.ProjectTemplates.8.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.8.0) | | ||
| | ASP.NET Core 9.0 | [`Microsoft.DotNet.Web.ProjectTemplates.8.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.9.0) | | ||
| | ASP.NET Core 10.0 | [`Microsoft.DotNet.Web.ProjectTemplates108.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.10.0) | |
There was a problem hiding this comment.
Corrected package name from 'ProjectTemplates108.0' to 'ProjectTemplates.10.0'. The period is missing between '10' and '8', creating an incorrect package identifier.
| | ASP.NET Core 10.0 | [`Microsoft.DotNet.Web.ProjectTemplates108.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.10.0) | | |
| | ASP.NET Core 10.0 | [`Microsoft.DotNet.Web.ProjectTemplates.10.0`](https://www.nuget.org/packages/Microsoft.DotNet.Web.ProjectTemplates.10.0) | |
| Installing .NET through the `dotnet-install` PowerShell script is recommended for continuous integration and nonadmin installs. If you're installing .NET for normal use on your system, use either the [.NET Installer](#net-installer) or [Windows Package Manager](#install-with-windows-package-manager-winget) installation methods. | ||
|
|
||
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 8. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at <https://dot.net/v1/dotnet-install.ps1> and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). | ||
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 10. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at <https://dot.net/v1/dotnet-install.ps1> and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). |
There was a problem hiding this comment.
.NET 10 is not an LTS release. According to Microsoft's support policy, even-numbered releases (like .NET 8) are LTS, while odd-numbered releases (like .NET 9) are Standard Term Support (STS). .NET 10 would be LTS, but the script defaults to the latest LTS version, which would currently be .NET 8 until .NET 10 is released and becomes the latest LTS.
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 10. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at <https://dot.net/v1/dotnet-install.ps1> and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). | |
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is currently .NET 8. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at <https://dot.net/v1/dotnet-install.ps1> and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). |
| ``` | ||
|
|
||
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) SDK version, which is .NET 8. To install the latest release, which might not be an (LTS) version, use the `--version latest` parameter. | ||
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) SDK version, which is .NET 10. To install the latest release, which might not be an (LTS) version, use the `--version latest` parameter. |
There was a problem hiding this comment.
While .NET 10 would be an LTS release (even-numbered versions are LTS), the statement is misleading because it says 'which is .NET 10' followed by 'To install the latest release, which might not be an (LTS) version'. If .NET 10 is LTS and is the default, the distinction being made doesn't make sense. The sentence structure implies .NET 10 might not be LTS.
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) SDK version, which is .NET 10. To install the latest release, which might not be an (LTS) version, use the `--version latest` parameter. | |
| The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) SDK version (currently .NET 10). If you want to install the absolute latest release, which might be a preview or not an LTS version, use the `--version latest` parameter. |
| sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo | ||
| ``` | ||
|
|
||
| # [.NET 10](#tab/dotnet9) |
There was a problem hiding this comment.
Tab label identifier is incorrect. The heading says '.NET 10' but the tab identifier is 'dotnet9'. It should be 'dotnet10' to match the heading.
| # [.NET 10](#tab/dotnet9) | |
| # [.NET 10](#tab/dotnet10) |
| sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo | ||
| ``` | ||
|
|
||
| # [.NET 10](#tab/dotnet9) |
There was a problem hiding this comment.
Tab label identifier is incorrect. The heading says '.NET 10' but the tab identifier is 'dotnet9'. It should be 'dotnet10' to match the heading.
| [!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] | ||
|
|
||
| **Not supported on Alpine 3.18.** | ||
| [!INCLUDE [linux-apk-install-100](includes/linux-install-90-apk.md)] |
There was a problem hiding this comment.
The include file reference is incorrect. The directive is for 'linux-install-100' but references 'linux-install-90-apk.md'. It should reference 'linux-install-100-apk.md' instead.
| [!INCLUDE [linux-apk-install-100](includes/linux-install-90-apk.md)] | |
| [!INCLUDE [linux-apk-install-100](includes/linux-install-100-apk.md)] |
| | Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | | ||
| | Windows 10 (22H2) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | |
There was a problem hiding this comment.
The .NET 10 column is missing x86 architecture support that was present in the .NET 9 and .NET 8 columns for Windows client operating systems. According to the original table, Windows 11 and Windows 10 supported x64, x86, and Arm64 for both .NET 9 and .NET 8. The .NET 10 column should also include x86 support unless this is an intentional breaking change.
| | Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | | |
| | Windows 10 (22H2) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | | |
| | Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | | |
| | Windows 10 (22H2) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | |
| ``` | ||
| If you see an error message, you need to install the templates. | ||
| If you see an error message, you need to install the templates, as detailed in the next step. |
There was a problem hiding this comment.
[nitpick] The phrase 'as detailed in the next step' adds unnecessary words. According to the style guide, use concise language. Consider: 'If you see an error message, install the templates in the next step.' or 'If you see an error message, follow the next step to install the templates.'
| If you see an error message, you need to install the templates, as detailed in the next step. | |
| If you see an error message, install the templates in the next step. |
Summary
Updates for .NET 10.
Some things I didn't update to .NET 10, which I'll do after the full release, such as the instructions for the download file and sha crc validation stuff.
One important change is that I did remove the old Ubuntu verisons.
Fixes #49685
Internal previews
Toggle expand/collapse