Merge main into live

.github/policies/label-prs-services.yml

@@ -45,9 +45,9 @@ configuration:
                 pattern: (?i).*_vblang/spec.*
             then:
             - addLabel:
-                label: dotnet-visualbasic/svc
+                label: dotnet-visual-basic/svc
             - addLabel:
-                label: vb-spec/subsvc
+                label: vb-language-spec/subsvc
           - if:
             - filesMatchPattern:
                 matchAny: true
@@ -653,14 +653,14 @@ configuration:
                 pattern: (?i).*docs/visual-basic.*
             then:
             - addLabel:
-                label: dotnet-visualbasic/svc
+                label: dotnet-visual-basic/svc
           - if:
             - filesMatchPattern:
                 matchAny: true
                 pattern: (?i).*docs/visual-basic/language-reference/error-messages.*
             then:
             - addLabel:
-                label: dotnet-visualbasic/svc
+                label: dotnet-visual-basic/svc
             - addLabel:
                 label: errors-warnings/subsvc
           - if:
@@ -669,7 +669,7 @@ configuration:
                 pattern: (?i).*docs/visual-basic/misc.*
             then:
             - addLabel:
-                label: dotnet-visualbasic/svc
+                label: dotnet-visual-basic/svc
             - addLabel:
                 label: errors-warnings/subsvc
 onFailure:

.github/skills/redirect-article/SKILL.md

@@ -52,7 +52,7 @@ To determine the correct redirection file for an article:
 |--------------|------------------|
 | AI | `.openpublishing.redirection.ai.json` |
 | Architecture | `.openpublishing.redirection.architecture.json` |
-| .NET Aspire | `.openpublishing.redirection.aspire.json` |
+| Aspire | `.openpublishing.redirection.aspire.json` |
 | Azure | `.openpublishing.redirection.azure.json` |
 | .NET Core | `.openpublishing.redirection.core.json` |
 | C# | `.openpublishing.redirection.csharp.json` |

docfx.json

@@ -214,7 +214,7 @@
                 "_csharplang/**/*.{md,yml}": "dotnet-csharp",
                 "_csharpstandard/**/*.{md,yml}": "dotnet-csharp",
                 "_roslyn/docs/compilers/CSharp/*.{md,yml}": "dotnet-csharp",
-                "_vblang/spec/*.{md,yml}": "dotnet-visualbasic",
+                "_vblang/spec/*.{md,yml}": "dotnet-visual-basic",
                 "docs/architecture/**/**.{md,yml}": "dotnet-architecture",
                 "docs/azure/**/*.{md,yml}": "dotnet-azure",
                 "docs/core/**/*.{md,yml}": "dotnet-fundamentals",
@@ -227,7 +227,7 @@
                 "docs/standard/data/**/**.{md,yml}": "dotnet-data",
                 "docs/standard/design-guidelines/*.{md,yml}": "dotnet",
                 "docs/standard/security/*.{md,yml}": "dotnet",
-                "docs/visual-basic/**/**.{md,yml}": "dotnet-visualbasic",
+                "docs/visual-basic/**/**.{md,yml}": "dotnet-visual-basic",
                 "docs/orleans/**/**.{md,yml}": "dotnet-orleans"
             },
             "ms.topic": {
@@ -522,7 +522,7 @@
                 "_csharplang/**/*.{md,yml}": "lang-spec",
                 "_csharpstandard/**/*.{md,yml}": "lang-spec",
                 "_roslyn/docs/compilers/CSharp/*.{md,yml}": "whats-new",
-                "_vblang/spec/*.{md,yml}": "vb-spec",
+                "_vblang/spec/*.{md,yml}": "vb-language-spec",
                 "docs/ai/**/**.{md,yml}": "intelligent-apps",
                 "docs/architecture/blazor-for-web-forms-developers/**/**.{md,yml}": "blazor",
                 "docs/architecture/cloud-native/**/**.{md,yml}": "cloud-native",

docs/ai/quickstarts/text-to-image.md

@@ -119,7 +119,7 @@ The `Aspire.Azure.AI.OpenAI` package provides extension methods to register Azur
 
    :::code language="csharp" source="snippets/text-to-image/hosting/Program.cs" id="SnippetSetup":::
 
-   The <xref:Microsoft.Extensions.Hosting.AspireAzureOpenAIExtensions.AddAzureOpenAIClient(Microsoft.Extensions.Hosting.IHostApplicationBuilder,System.String,System.Action{Aspire.Azure.AI.OpenAI.AzureOpenAISettings},System.Action{Azure.Core.Extensions.IAzureClientBuilder{Azure.AI.OpenAI.AzureOpenAIClient,Azure.AI.OpenAI.AzureOpenAIClientOptions}})> method registers the Azure OpenAI client with dependency injection. The connection string (named `"openai"`) is retrieved from configuration, typically from `appsettings.json` or environment variables:
+   The [AddAzureOpenAIClient](https://aspire.dev/reference/api/csharp/aspire.azure.ai.openai/aspireazureopenaiextensions/methods/#addazureopenaiclient) method registers the Azure OpenAI client with dependency injection. The connection string (named `"openai"`) is retrieved from configuration, typically from `appsettings.json` or environment variables:
 
    ```json
    {
@@ -156,7 +156,7 @@ This hosting approach provides several benefits:
 - **Dependency injection**: The image generator is available throughout your application via DI.
 - **Lifecycle management**: Services are properly initialized and disposed of by the hosting infrastructure.
 - **Testability**: Mock implementations can be easily substituted for testing.
-- **Integration with .NET Aspire**: When using .NET Aspire, the `AddAzureOpenAIClient` method integrates with service discovery and telemetry.
+- **Integration with Aspire**: When using Aspire, the `AddAzureOpenAIClient` method integrates with service discovery and telemetry.
 
 ## Best practices
 

docs/azure/includes/dotnet-all.md

@@ -170,7 +170,7 @@
 | Provisioning - Event Hubs | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Provisioning.EventHubs/1.1.0) | [docs](/dotnet/api/overview/azure/Provisioning.EventHubs-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.EventHubs_1.1.0/sdk/provisioning/Azure.Provisioning.EventHubs/) |
 | Provisioning - Frontdoor | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.FrontDoor/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.FrontDoor-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.FrontDoor_1.0.0-beta.1/sdk/provisioning/Azure.Provisioning.FrontDoor/) |
 | Provisioning - Key Vault | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Provisioning.KeyVault/1.1.0)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.KeyVault/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.KeyVault-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KeyVault_1.1.0/sdk/provisioning/Azure.Provisioning.KeyVault/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KeyVault_1.2.0-beta.1/sdk/provisioning/Azure.Provisioning.KeyVault/) |
-| Provisioning - Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Provisioning.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Provisioning.Kubernetes-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Kubernetes_1.0.0-beta.4/sdk/provisioning/Azure.Provisioning.Kubernetes/) |
+| Provisioning - Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Provisioning.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Provisioning.Kubernetes-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [main](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/hybridkubernetes/Azure.Provisioning.Kubernetes) |
 | Provisioning - Kubernetes Configuration | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.Provisioning.KubernetesConfiguration/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/Provisioning.KubernetesConfiguration-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KubernetesConfiguration_1.0.0-beta.3/sdk/provisioning/Azure.Provisioning.KubernetesConfiguration/) |
 | Provisioning - Kusto | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.Provisioning.Kusto/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/Provisioning.Kusto-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Kusto_1.0.0-beta.2/sdk/provisioning/Azure.Provisioning.Kusto/) |
 | Provisioning - Logic | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.Logic/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.Logic-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Logic_1.0.0-beta.1/sdk/logic/Azure.Provisioning.Logic/) |

docs/azure/includes/dotnet-new.md

@@ -183,7 +183,7 @@
 | Provisioning - Event Hubs | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Provisioning.EventHubs/1.1.0) | [docs](/dotnet/api/overview/azure/Provisioning.EventHubs-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.EventHubs_1.1.0/sdk/provisioning/Azure.Provisioning.EventHubs/) |
 | Provisioning - Frontdoor | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.FrontDoor/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.FrontDoor-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.FrontDoor_1.0.0-beta.1/sdk/provisioning/Azure.Provisioning.FrontDoor/) |
 | Provisioning - Key Vault | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Provisioning.KeyVault/1.1.0)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.KeyVault/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.KeyVault-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KeyVault_1.1.0/sdk/provisioning/Azure.Provisioning.KeyVault/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KeyVault_1.2.0-beta.1/sdk/provisioning/Azure.Provisioning.KeyVault/) |
-| Provisioning - Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Provisioning.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Provisioning.Kubernetes-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Kubernetes_1.0.0-beta.4/sdk/provisioning/Azure.Provisioning.Kubernetes/) |
+| Provisioning - Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.Provisioning.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/Provisioning.Kubernetes-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [main](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/hybridkubernetes/Azure.Provisioning.Kubernetes) |
 | Provisioning - Kubernetes Configuration | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.Provisioning.KubernetesConfiguration/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/Provisioning.KubernetesConfiguration-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.KubernetesConfiguration_1.0.0-beta.3/sdk/provisioning/Azure.Provisioning.KubernetesConfiguration/) |
 | Provisioning - Kusto | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.Provisioning.Kusto/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/Provisioning.Kusto-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Kusto_1.0.0-beta.2/sdk/provisioning/Azure.Provisioning.Kusto/) |
 | Provisioning - Logic | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Provisioning.Logic/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Provisioning.Logic-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Provisioning.Logic_1.0.0-beta.1/sdk/logic/Azure.Provisioning.Logic/) |

docs/core/compatibility/globalization/6.0/culture-creation-invariant-mode.md

@@ -7,10 +7,10 @@ ms.date: 07/23/2021
 
 This breaking change affects *[globalization-invariant mode](https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md)* in two ways:
 
-- Previously, .NET allowed any culture to be created in globalization-invariant mode, as long as the culture name conformed to [BCP-47](https://tools.ietf.org/rfc/bcp/bcp47.txt). However, [the invariant culture](/dotnet/api/system.globalization.cultureinfo#invariant-neutral-and-specific-cultures) data was used instead of the real culture data. Starting in .NET 6, an exception is thrown if you create any culture other than the invariant culture in globalization-invariant mode.
+- Previously, .NET allowed any culture to be created in globalization-invariant mode, as long as the culture name conformed to [BCP-47](https://www.rfc-editor.org/info/bcp47/). However, [the invariant culture](/dotnet/api/system.globalization.cultureinfo#invariant-neutral-and-specific-cultures) data was used instead of the real culture data. Starting in .NET 6, an exception is thrown if you create any culture other than the invariant culture in globalization-invariant mode.
 - Previously, globalization-invariant mode only supported case mapping for ASCII characters. Starting in .NET 6, globalization-invariant mode provides full case-mapping support for all Unicode-defined characters. Case mapping is used in operations such as string comparisons, string searches, and upper or lower casing strings.
 
-[Globalization-invariant mode](https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md) is used for apps that don't required any globalization support. That is, the app runs without access to culture-specific data and behavior. Globalization-invariant mode is enabled by default on some Docker containers, for example, Alpine containers.
+[Globalization-invariant mode](https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md) is used for apps that don't require any globalization support. That is, the app runs without access to culture-specific data and behavior. Globalization-invariant mode is enabled by default on some Docker containers, for example, Alpine containers.
 
 ## Old behavior
 

docs/core/diagnostics/dotnet-debug.md

@@ -15,24 +15,11 @@ ai-usage: ai-assisted
 
 ## Install
 
-There are two ways to download and install `dotnet-debug`:
+To install the latest release version of the `dotnet-debug` [NuGet package](https://www.nuget.org/packages/dotnet-debug), use the [dotnet tool install](../tools/dotnet-tool-install.md) command:
 
-- **dotnet global tool:**
-
-  To install the latest release version of the `dotnet-debug` [NuGet package](https://www.nuget.org/packages/dotnet-debug), use the [dotnet tool install](../tools/dotnet-tool-install.md) command:
-
-  ```dotnetcli
-  dotnet tool install --global dotnet-debug
-  ```
-
-- **Direct download:**
-
-  Download the tool executable that matches your platform:
-
-  | OS      | Platform                                                                                                                                                                                                                                                                 |
-  | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-  | Windows | [x86](https://aka.ms/dotnet-debug/win-x86) \| [x64](https://aka.ms/dotnet-debug/win-x64) \| [Arm](https://aka.ms/dotnet-debug/win-arm) \| [Arm-x64](https://aka.ms/dotnet-debug/win-arm64)                                                                               |
-  | Linux   | [x64](https://aka.ms/dotnet-debug/linux-x64) \| [Arm](https://aka.ms/dotnet-debug/linux-arm) \| [Arm64](https://aka.ms/dotnet-debug/linux-arm64) \| [musl-x64](https://aka.ms/dotnet-debug/linux-musl-x64) \| [musl-Arm64](https://aka.ms/dotnet-debug/linux-musl-arm64) |
+```dotnetcli
+dotnet tool install --global dotnet-debug
+```
 
 ## Synopsis
 

docs/core/extensions/generic-host.md

@@ -140,7 +140,7 @@ When you call either <xref:Microsoft.Extensions.Hosting.IHostBuilder.Build?displ
 
 If you're building for the web or writing a distributed application, you might need to use a different host builder. Consider the following list of additional host builders:
 
-- <xref:Aspire.Hosting.DistributedApplicationBuilder>: A builder for creating distributed apps. For more information, see [Aspire](/dotnet/aspire).
+- [DistributedApplicationBuilder](https://aspire.dev/reference/api/csharp/aspire.hosting/distributedapplicationbuilder/): A builder for creating distributed apps. For more information, see [Aspire](/dotnet/aspire).
 - <xref:Microsoft.AspNetCore.Builder.WebApplicationBuilder>: A builder for web applications and services. For more information, see [ASP.NET Core](/aspnet/core).
 - <xref:Microsoft.AspNetCore.Hosting.WebHostBuilder>: A builder for `IWebHost`. For more information, see [ASP.NET Core web host](/aspnet/core/fundamentals/host/web-host).
 

docs/core/install/linux-package-mixup.md

@@ -263,7 +263,6 @@ Many other users have reported these problems. The following is a list of those
 
 - Generic errors without clear messages
 
-  - [Core #4605: cannot run "dotnet new console"](https://github.com/dotnet/core/issues/4605)
   - [Core #4644: Cannot install .NET Core SDK 2.1 on Fedora 32](https://github.com/dotnet/core/issues/4655)
   - [Runtime #49375: After updating to 5.0.200-1 using package manager, it appears that no sdks are installed](https://github.com/dotnet/runtime/issues/49375)
   - [Installer #16438: The application '--version' does not exist](https://github.com/dotnet/installer/issues/16438)

docs/core/project-sdk/overview.md

@@ -22,7 +22,7 @@ The available SDKs include:
 | `Microsoft.NET.Sdk.Razor`  | The .NET [Razor SDK](/aspnet/core/razor-pages/sdk)                                   | <https://github.com/dotnet/aspnetcore> |
 | `Microsoft.NET.Sdk.BlazorWebAssembly` | The .NET [Blazor WebAssembly SDK](/aspnet/core/blazor#blazor-webassembly) | <https://github.com/dotnet/aspnetcore> |
 | `Microsoft.NET.Sdk.Worker` | The .NET [Worker Service SDK](../extensions/workers.md)                              | <https://github.com/dotnet/aspnetcore> |
-| `Aspire.AppHost.Sdk`       | The .NET [Aspire SDK](/dotnet/aspire/fundamentals/dotnet-aspire-sdk)                 | <https://github.com/dotnet/aspire>     |
+| `Aspire.AppHost.Sdk`       | The [Aspire SDK](/dotnet/aspire/fundamentals/dotnet-aspire-sdk)                      | <https://github.com/dotnet/aspire>     |
 | `MSTest.Sdk`               | The [MSTest SDK](../testing/unit-testing-mstest-sdk.md)                              | <https://github.com/microsoft/testfx>  |
 
 The .NET SDK is the base SDK for .NET. The other SDKs reference the .NET SDK, and projects that are associated with the other SDKs have all the .NET SDK properties available to them. The Web SDK, for example, depends on both the .NET SDK and the Razor SDK.

docs/core/sdk/file-based-apps.md

@@ -420,9 +420,9 @@ Caching improves build performance but can cause confusion when:
 
 - Clear cache artifacts for file-based apps by using the following command:
 
-```dotnetcli
-dotnet clean file-based-apps
-```
+  ```dotnetcli
+  dotnet clean file-based-apps
+  ```
 
 - Force a clean build to bypass cache:
 

docs/fundamentals/code-analysis/quality-rules/ca1066.md

@@ -7,7 +7,6 @@ f1_keywords:
 helpviewer_keywords:
 - CA1066
 author: mavasani
-ms.author: mavasani
 ---
 # CA1066: Implement IEquatable when overriding Equals
 
@@ -17,8 +16,8 @@ ms.author: mavasani
 | **Title**                           | Implement IEquatable when overriding Equals |
 | **Category**                        | [Design](design-warnings.md)                |
 | **Fix is breaking or non-breaking** | Non-breaking                                |
-| **Enabled by default in .NET 10**    | No                                          |
-| **Applicable languages** | C# and Visual Basic |
+| **Enabled by default in .NET 10**   | No                                          |
+| **Applicable languages**            | C# and Visual Basic                         |
 
 ## Cause