Merge pull request #43989 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

docs/azure/includes/dotnet-all.md

@@ -1,6 +1,6 @@
 | Name | Package | Docs | Source |
 | ---- | ------- | ---- | ------ |
-| AI Foundry | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.1/sdk/ai/Azure.AI.Projects/) |
+| AI Foundry | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.2/sdk/ai/Azure.AI.Projects/) |
 | AI Model Inference | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Inference/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Inference_1.0.0-beta.2/sdk/ai/Azure.AI.Inference/) |
 | Anomaly Detector | NuGet [3.0.0-preview.7](https://www.nuget.org/packages/Azure.AI.AnomalyDetector/3.0.0-preview.7) | [docs](/dotnet/api/overview/azure/AI.AnomalyDetector-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [3.0.0-preview.7](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AnomalyDetector_3.0.0-preview.7/sdk/anomalydetector/Azure.AI.AnomalyDetector/) |
 | App Configuration | NuGet [1.5.0](https://www.nuget.org/packages/Azure.Data.AppConfiguration/1.5.0) | [docs](/dotnet/api/overview/azure/Data.AppConfiguration-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.AppConfiguration_1.5.0/sdk/appconfiguration/Azure.Data.AppConfiguration/) |

docs/azure/includes/dotnet-new.md

@@ -1,6 +1,6 @@
 | Name | Package | Docs | Source |
 | ---- | ------- | ---- | ------ |
-| AI Foundry | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.1/sdk/ai/Azure.AI.Projects/) |
+| AI Foundry | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.2/sdk/ai/Azure.AI.Projects/) |
 | AI Model Inference | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Inference/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Inference_1.0.0-beta.2/sdk/ai/Azure.AI.Inference/) |
 | Anomaly Detector | NuGet [3.0.0-preview.7](https://www.nuget.org/packages/Azure.AI.AnomalyDetector/3.0.0-preview.7) | [docs](/dotnet/api/overview/azure/AI.AnomalyDetector-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [3.0.0-preview.7](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AnomalyDetector_3.0.0-preview.7/sdk/anomalydetector/Azure.AI.AnomalyDetector/) |
 | App Configuration | NuGet [1.5.0](https://www.nuget.org/packages/Azure.Data.AppConfiguration/1.5.0) | [docs](/dotnet/api/overview/azure/Data.AppConfiguration-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.AppConfiguration_1.5.0/sdk/appconfiguration/Azure.Data.AppConfiguration/) |

docs/core/extensions/configuration-providers.md

@@ -3,7 +3,7 @@ title: Configuration providers
 description: Discover how to configure .NET apps using the configuration provider API and the available configuration providers.
 author: IEvangelist
 ms.author: dapine
-ms.date: 09/10/2024
+ms.date: 12/16/2024
 ---
 
 # Configuration providers in .NET
@@ -236,7 +236,7 @@ Environment variables set in *launchSettings.json* override those set in the sys
 
 ### Azure App Service settings
 
-On [Azure App Service](https://azure.microsoft.com/services/app-service), select **New application setting** on the **Settings** > **Configuration** page. Azure App Service application settings are:
+On [Azure App Service](https://azure.microsoft.com/services/app-service), select **Add** on the **Settings** > **Environment variables** page. Azure App Service application settings are:
 
 - Encrypted at rest and transmitted over an encrypted channel.
 - Exposed as environment variables.

docs/core/install/includes/linux-install-80-apk.md

@@ -0,0 +1,33 @@
+---
+author: adegeo
+ms.author: adegeo
+ms.date: 11/14/2023
+ms.topic: include
+ms.custom: linux-related-content
+---
+
+### Install the SDK
+
+The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command:
+
+```bash
+sudo apk add dotnet8-sdk
+```
+
+To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
+
+### Install the runtime
+
+The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command:
+
+```bash
+sudo apk add aspnetcore8-runtime
+```
+
+As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore8-runtime` in the previous command with `dotnet8-runtime`:
+
+```bash
+sudo apk add dotnet8-runtime
+```
+
+To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

docs/core/install/linux-alpine.md

@@ -3,14 +3,12 @@ title: Install .NET on Alpine
 description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Alpine.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/01/2024
+ms.date: 12/13/2024
 ms.custom: linux-related-content
 ---
 
 # Install the .NET SDK or the .NET Runtime on Alpine
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 .NET is supported on Alpine and this article describes how to install .NET on Alpine. When an Alpine version falls out of support, .NET is no longer supported with that version.
 
 If you're using Docker, consider using [official .NET Docker images](../docker/introduction.md#net-images) instead of installing .NET yourself.
@@ -23,6 +21,7 @@ The following table is a list of currently supported .NET releases and the versi
 
 | Alpine | Supported Version | Available in Package Manager |
 |--------|-------------------|------------------------------|
+| 3.21   | 9.0, 8.0          | 9.0, 8.0                     |
 | 3.20   | 9.0, 8.0          | 8.0, 6.0                     |
 | 3.19   | 9.0, 8.0          | 7.0, 6.0                     |
 | 3.18   | 8.0               | 7.0, 6.0                     |
@@ -33,30 +32,28 @@ The following table is a list of currently supported .NET releases and the versi
 
 # [.NET 9](#tab/dotnet9)
 
-Not supported on Alpine 3.18.
-
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+**Not supported on Alpine 3.18.**
 
 [!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)]
 
 # [.NET 8](#tab/dotnet8)
 
-[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)]
+[!INCLUDE [linux-apk-install-80](includes/linux-install-80-apk.md)]
 
 ---
 
 ## Supported architectures
 
-The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager.
+The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager, if a package is available for that architecture.
 
 | Architecture | .NET 9                 | .NET 8                 |
 |--------------|------------------------|------------------------|
-| x86_64       | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
+| x86_64       | 3.19, 3.20, 3.21       | 3.18, 3.19, 3.20, 3.21 |
 | x86          | None                   | None                   |
-| aarch64      | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
-| armv7        | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 |
+| aarch64      | 3.19, 3.20, 3.21       | 3.18, 3.19, 3.20, 3.21 |
+| armv7        | 3.19, 3.20, 3.21       | 3.18, 3.19, 3.20, 3.21 |
 | armhf        | None                   | None                   |
-| s390x        | 3.17                   | 3.17                   |
+| s390x        | None                   | None                   |
 | ppc64le      | None                   | None                   |
 | riscv64      | None                   | None                   |
 

docs/core/install/linux-rhel.md

@@ -3,14 +3,12 @@ title: Install .NET on RHEL and CentOS Stream
 description: Learn about which versions of .NET are supported, and how to install .NET on Red Hat Enterprise Linux and CentOS Stream.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/11/2024
+ms.date: 12/13/2024
 ms.custom: linux-related-content
 ---
 
 # Install the .NET SDK or the .NET Runtime on RHEL and CentOS Stream
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 .NET is supported on Red Hat Enterprise Linux (RHEL). This article describes how to install .NET on RHEL and CentOS Stream.
 
 [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)]

docs/core/install/linux-snap-runtime.md

@@ -3,7 +3,7 @@ title: Install .NET Runtime on Linux with Snap
 description: Learn about how to install the .NET Runtime snap package. Canonical maintains and supports .NET-related snap packages.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/11/2024
+ms.date: 12/13/2024
 ms.topic: install-set-up-deploy
 ms.custom: linux-related-content
 #customer intent: As a Linux user, I want to install .NET Runtime through Snap.
@@ -31,8 +31,6 @@ Your Linux distribution might already include snap. Try running `snap` from a te
 
 ## 1. Install the runtime
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 The following steps install the .NET 9 runtime snap package:
 
 01. Open a terminal.
@@ -46,7 +44,7 @@ Each .NET Runtime is published as an individual snap package. The following tabl
 
 | .NET version                                      | Snap package        | .NET version supported by Microsoft |
 |---------------------------------------------------|---------------------|-----|
-| 9 (STS)                                           | Not yet available | Yes |
+| [9 (STS)](https://snapcraft.io/dotnet-runtime-90) | `dotnet-runtime-90` | Yes |
 | [8 (LTS)](https://snapcraft.io/dotnet-runtime-80) | `dotnet-runtime-80` | Yes |
 | [7 (STS)](https://snapcraft.io/dotnet-runtime-70) | `dotnet-runtime-70` | No  |
 | [6 (LTS)](https://snapcraft.io/dotnet-runtime-60) | `dotnet-runtime-60` | No  |

docs/core/install/linux-ubuntu-install.md

@@ -3,7 +3,7 @@ title: Install .NET on Ubuntu
 description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu. .NET is usually installed through APT.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/01/2024
+ms.date: 12/13/2024
 ms.custom: linux-related-content
 zone_pivot_groups: ubuntu-install-set-one
 ---
@@ -35,8 +35,6 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support,
 
 # [.NET 9](#tab/dotnet9)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]
 
 # [.NET 8](#tab/dotnet8)

docs/core/install/linux-ubuntu.md

@@ -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: 11/11/2024
+ms.date: 12/13/2024
 ms.custom: updateeachrelease, linux-related-content
 ---
 
@@ -223,8 +223,6 @@ sudo apt update
 
 ## Install .NET
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 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)):
 
 || Product      | Type    | Package                  |

docs/fsharp/language-reference/xml-documentation.md

@@ -14,8 +14,7 @@ The compiler-generated XML file can be distributed alongside your .NET assembly
 show quick information about types or members. Additionally, the XML file can be run through tools
 like [fsdocs](http://fsprojects.github.io/FSharp.Formatting/) to generate API reference websites.
 
-XML documentation comments, like all other comments, are ignored by the compiler, unless the options described below are enabled to check the validity and
-completeness of comments at compile time.
+By default, XML documentation comments are ignored by the compiler. To change this, set `--warnon:3390`. The compiler will then verify the syntax of the XML and the parameters referred to in `<param>` and `<paramref>` tags.
 
 You can generate the XML file at compile time by doing one of the following: