Update language agnostic includes to use cross repo includes

.openpublishing.publish.config.json

@@ -86,8 +86,8 @@
       "branch_mapping": {}
     },
     {
-      "path_to_root": "azure-dev-docs-pr",
-      "url": "https://github.com/MicrosoftDocs/azure-dev-docs-pr",
+      "path_to_root": "azure-dev-docs",
+      "url": "https://github.com/MicrosoftDocs/azure-dev-docs",
       "branch": "main",
       "branch_mapping": {}
     }

docs/ai/get-started-app-chat-scaling-with-azure-container-apps.md

@@ -8,7 +8,7 @@ ms.topic: get-started
 
 # Scale Azure OpenAI for .NET chat using RAG with Azure Container Apps
 
-[!INCLUDE [aca-load-balancer-intro](~/azure-dev-docs-pr/articles/ai/includes//scaling-load-balancer-introduction-azure-container-apps.md)]
+[!INCLUDE [aca-load-balancer-intro](~/azure-dev-docs/articles/ai/includes//scaling-load-balancer-introduction-azure-container-apps.md)]
 
 ## Prerequisites
 
@@ -28,15 +28,15 @@ ms.topic: get-started
 
 ---
 
-[!INCLUDE [scaling-load-balancer-aca-procedure.md](~/azure-dev-docs-pr/articles/ai/includes//scaling-load-balancer-procedure-azure-container-apps.md)]
+[!INCLUDE [scaling-load-balancer-aca-procedure.md](~/azure-dev-docs/articles/ai/includes//scaling-load-balancer-procedure-azure-container-apps.md)]
 
-[!INCLUDE [redeployment-procedure](~/azure-dev-docs-pr/articles/ai/includes//redeploy-procedure-chat.md)]
+[!INCLUDE [redeployment-procedure](~/azure-dev-docs/articles/ai/includes//redeploy-procedure-chat.md)]
 
-[!INCLUDE [logs](~/azure-dev-docs-pr/articles/ai/includes//scaling-load-balancer-logs-azure-container-apps.md)]
+[!INCLUDE [logs](~/azure-dev-docs/articles/ai/includes//scaling-load-balancer-logs-azure-container-apps.md)]
 
-[!INCLUDE [capacity.md](~/azure-dev-docs-pr/articles/ai/includes//scaling-load-balancer-capacity.md)]
+[!INCLUDE [capacity.md](~/azure-dev-docs/articles/ai/includes//scaling-load-balancer-capacity.md)]
 
-[!INCLUDE [aca-cleanup](~/azure-dev-docs-pr/articles/ai/includes//scaling-load-balancer-cleanup-azure-container-apps.md)]
+[!INCLUDE [aca-cleanup](~/azure-dev-docs/articles/ai/includes//scaling-load-balancer-cleanup-azure-container-apps.md)]
 
 ## Sample code
 

docs/ai/resources/azure-ai.md

@@ -9,4 +9,4 @@ ms.topic: reference
 
 This article contains an organized list of the best learning resources for .NET developers who are building AI apps using Azure services. Resources include popular quickstart articles, reference samples, documentation, and training courses.
 
-[!INCLUDE [include-file-from-azure-dev-docs-pr](~/azure-dev-docs-pr/articles/ai/includes/azure-ai-for-developers-dotnet.md)]
+[!INCLUDE [include-file-from-azure-dev-docs-pr](~/azure-dev-docs/articles/ai/includes/azure-ai-for-developers-dotnet.md)]

docs/azure/sdk/authentication/local-development-broker.md

@@ -9,29 +9,29 @@ zone_pivot_groups: operating-systems-set-one
 
 # Authenticate .NET apps to Azure services during local development using brokered authentication
 
-[!INCLUDE [broker-intro](../includes/broker-intro.md)]
+[!INCLUDE [broker-intro](~/azure-dev-docs/articles/includes/authentication/broker-introduction.md)]
 
 :::zone target="docs" pivot="os-windows"
 
-[!INCLUDE [broker-windows](../includes/broker-windows.md)]
+[!INCLUDE [broker-windows](~/azure-dev-docs/articles/includes/authentication/broker-windows.md)]
 
 :::zone-end
 
 :::zone target="docs" pivot="os-macos"
 
-[!INCLUDE [broker-mac](../includes/broker-mac.md)]
+[!INCLUDE [broker-mac](~/azure-dev-docs/articles/includes/authentication/broker-mac.md)]
 
 :::zone-end
 
 :::zone target="docs" pivot="os-linux"
 
-[!INCLUDE [broker-linux](../includes/broker-linux.md)]
+[!INCLUDE [broker-linux](~/azure-dev-docs/articles/includes/authentication/broker-linux.md)]
 
 :::zone-end
 
-[!INCLUDE [broker-configure-app](../includes/broker-configure-app.md)]
+[!INCLUDE [broker-configure-app](~/azure-dev-docs/articles/includes/authentication/broker-configure-application.md)]
 
-[!INCLUDE [broker-assign-roles](../includes/broker-assign-roles.md)]
+[!INCLUDE [broker-assign-roles](~/azure-dev-docs/articles/includes/authentication/broker-assign-roles.md)]
 
 ## Implement the code
 
@@ -97,7 +97,7 @@ The Azure Identity library provide interactive brokered authentication using <xr
 2. Get a reference to the parent window on top of which the account picker dialog should appear.
 3. Create an instance of <xref:Azure.Identity.InteractiveBrowserCredential> using <xref:Azure.Identity.Broker.InteractiveBrowserCredentialBrokerOptions>.
 
-:::code language="csharp" source="../snippets/authentication/brokered/console-app/Program.cs" id="snippet_brokered_linux" highlight="15-21":::
+    :::code language="csharp" source="../snippets/authentication/brokered/console-app/Program.cs" id="snippet_brokered_linux" highlight="15-21":::
 
 :::zone-end
 

docs/azure/sdk/authentication/local-development-dev-accounts.md

@@ -39,9 +39,9 @@ The Azure Identity library can detect that the developer is signed-in from one o
 
 This approach takes advantage of the developer's existing Azure accounts to streamline the authentication process. However, a developer's account likely has more permissions than required by the app, therefore exceeding the permissions the app runs with in production. As an alternative, you can [create application service principals to use during local development](./local-development-service-principal.md), which can be scoped to have only the access needed by the app.
 
-[!INCLUDE [auth-create-entra-group](../includes/auth-create-entra-group.md)]
+[!INCLUDE [auth-create-entra-group](~/azure-dev-docs/articles/includes/authentication/create-entra-group.md)]
 
-[!INCLUDE [auth-assign-group-roles](../includes/auth-assign-group-roles.md)]
+[!INCLUDE [auth-assign-group-roles](~/azure-dev-docs/articles/includes/authentication/assign-group-roles.md)]
 
 ## Sign-in to Azure using developer tooling
 
@@ -53,72 +53,19 @@ Next, sign-in to Azure using one of several developer tools that can be used to
 
 ### [Visual Studio Code](#tab/sign-in-visual-studio-code)
 
-Developers using Visual Studio Code can authenticate with their developer account directly through the editor via the broker. Apps that use <xref:Azure.Identity.DefaultAzureCredential> or <xref:Azure.Identity.VisualStudioCodeCredential> can then use this account to authenticate app requests through a seamless single-sign-on experience.
-
-1. In Visual Studio Code, go to the **Extensions** panel and install the [Azure Resources](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureresourcegroups) extension. This extension lets you view and manage Azure resources directly from Visual Studio Code. It also uses the built-in Visual Studio Code Microsoft authentication provider to authenticate with Azure.
-
-    :::image type="content" source="../media/azure-resources-extension.png" alt-text="Screenshot showing the Azure Resources extension.":::
-
-1. Open the Command Palette in Visual Studio Code, then search for and select **Azure: Sign in**.
-
-    :::image type="content" source="../media/visual-studio-code-sign-in.png" alt-text="Screenshot showing how to sign in to Azure in Visual Studio Code.":::
-
-    > [!TIP]
-    > Open the Command Palette using `Ctrl+Shift+P` on Windows/Linux or `Cmd+Shift+P` on macOS.
-
-1. Add the [Azure.Identity.Broker](https://www.nuget.org/packages/Azure.Identity.Broker) NuGet package to your app:
-
-    ```dotnetcli
-    dotnet add package Azure.Identity.Broker
-    ```
+[!INCLUDE [sign-in-visual-studio-code](~/azure-dev-docs/articles/includes/authentication/sign-in-visual-studio-code.md)]
 
 ### [Azure CLI](#tab/sign-in-azure-cli)
 
-Developers can use [Azure CLI](/cli/azure/what-is-azure-cli) to authenticate. Apps using <xref:Azure.Identity.DefaultAzureCredential> or <xref:Azure.Identity.AzureCliCredential> can then use this account to authenticate app requests.
-
-To authenticate with the Azure CLI, run the `az login` command. On a system with a default web browser, the Azure CLI launches the browser to authenticate the user.
-
-```azurecli
-az login
-```
-
-For systems without a default web browser, the `az login` command uses the device code authentication flow. The user can also force the Azure CLI to use the device code flow rather than launching a browser by specifying the `--use-device-code` argument.
-
-```azurecli
-az login --use-device-code
-```
+[!INCLUDE [sign-in-azure-cli](~/azure-dev-docs/articles/includes/authentication/sign-in-azure-cli.md)]
 
 ### [Azure Developer CLI](#tab/sign-in-azure-developer-cli)
 
-Developers can use [Azure Developer CLI](/azure/developer/azure-developer-cli/overview) to authenticate. Apps using <xref:Azure.Identity.DefaultAzureCredential> or <xref:Azure.Identity.AzureDeveloperCliCredential> can then use this account to authenticate app requests.
-
-To authenticate with the Azure Developer CLI, run the `azd auth login` command. On a system with a default web browser, the Azure Developer CLI launches the browser to authenticate the user.
-
-```azdeveloper
-azd auth login
-```
-
-For systems without a default web browser, the `azd auth login --use-device-code` uses the device code authentication flow. The user can also force the Azure Developer CLI to use the device code flow rather than launching a browser by specifying the `--use-device-code` argument.
-
-```azdeveloper
-azd auth login --use-device-code
-```
+[!INCLUDE [sign-in-azure-developer-cli](~/azure-dev-docs/articles/includes/authentication/sign-in-azure-developer-cli.md)]
 
 ### [Azure PowerShell](#tab/sign-in-azure-powershell)
 
-Developers can use [Azure PowerShell](/powershell/azure/what-is-azure-powershell) to authenticate. Apps using <xref:Azure.Identity.DefaultAzureCredential> or <xref:Azure.Identity.AzurePowerShellCredential> can then use this account to authenticate app requests.
-
-To authenticate with Azure PowerShell, run the command `Connect-AzAccount`. On a system with a default web browser and version 5.0.0 or later of Azure PowerShell, it launches the browser to authenticate the user.
-
-```azurepowershell
-Connect-AzAccount
-```
-
-For systems without a default web browser, the `Connect-AzAccount` command uses the device code authentication flow. The user can also force Azure PowerShell to use the device code flow rather than launching a browser by specifying the `UseDeviceAuthentication` argument.
-
-```azurepowershell
-Connect-AzAccount -UseDeviceAuthentication
-```
+[!INCLUDE [sign-in-azure-PowerShell](~/azure-dev-docs/articles/includes/authentication/sign-in-azure-powershell.md)]
 
 ---
 
@@ -133,10 +80,17 @@ Complete the following steps:
 1. Add references to the [Azure.Identity](https://www.nuget.org/packages/Azure.Identity) and the [Microsoft.Extensions.Azure](https://www.nuget.org/packages/Microsoft.Extensions.Azure) packages in your project:
 
     ```dotnetcli
-    dotnet add package Azure.Identity
-    dotnet add package Microsoft.Extensions.Azure
+    dotnet package add Azure.Identity
+    dotnet package add Microsoft.Extensions.Azure
     ```
 
+    > [!NOTE]
+    > When using `VisualStudioCodeCredential`, you must also install the [Azure.Identity.Broker](https://www.nuget.org/packages/Azure.Identity.Broker) package:
+    >
+    > ```dotnetcli
+    > dotnet package add Azure.Identity.Broker
+    > ```
+
 1. In `Program.cs`, add `using` directives for the `Azure.Identity` and `Microsoft.Extensions.Azure` namespaces.
 
 1. Register the Azure service client using the corresponding `Add`-prefixed extension method.

docs/azure/sdk/authentication/local-development-service-principal.md

@@ -30,11 +30,11 @@ When the app is registered in Azure, an application service principal is created
 
 During local development, environment variables are set with the application service principal's identity. The Azure Identity library reads these environment variables to authenticate the app to the required Azure resources.
 
-[!INCLUDE [create-app-registration](../includes/auth-create-app-registration.md)]
+[!INCLUDE [create-app-registration](~/azure-dev-docs/articles/includes/authentication/create-app-registration.md)]
 
-[!INCLUDE [create-entra-group](../includes/auth-create-entra-group.md)]
+[!INCLUDE [create-entra-group](~/azure-dev-docs/articles/includes/authentication/create-entra-group.md)]
 
-[!INCLUDE [auth-assign-group-roles](../includes/auth-assign-group-roles.md)]
+[!INCLUDE [auth-assign-group-roles](~/azure-dev-docs/articles/includes/authentication/assign-group-roles.md)]
 
 [!INCLUDE [auth-set-environment-variables](../includes/auth-set-environment-variables.md)]
 

docs/azure/sdk/authentication/on-premises-apps.md

@@ -21,7 +21,7 @@ Using dedicated application service principals allows you to adhere to the princ
 
 A different app registration should be created for each environment the app is hosted in. This allows environment specific resource permissions to be configured for each service principal and make sure an app deployed to one environment doesn't talk to Azure resources that are part of another environment.
 
-[!INCLUDE [auth-create-app-registration](../includes/auth-create-app-registration.md)]
+[!INCLUDE [auth-create-app-registration](~/azure-dev-docs/articles/includes/authentication/create-app-registration.md)]
 
 ## Assign roles to the application service principal
 

docs/azure/sdk/authentication/system-assigned-managed-identity.md

@@ -15,7 +15,7 @@ The recommended approach to authenticate an Azure-hosted app to other Azure reso
 - How to assign roles to the system-assigned managed identity
 - How to authenticate using the system-assigned managed identity from your app code
 
-[!INCLUDE [managed-identity-concepts](../includes/managed-identity-concepts.md)]
+[!INCLUDE [managed-identity-concepts](~/azure-dev-docs/articles/includes/authentication/managed-identity-concepts.md)]
 
 The sections ahead describe the steps to enable and use a system-assigned managed identity for an Azure-hosted app. If you need to use a user-assigned managed identity, visit the [user-assigned managed identities](user-assigned-managed-identity.md) article for more information.
 

docs/azure/sdk/authentication/user-assigned-managed-identity.md

@@ -15,7 +15,7 @@ The recommended approach to authenticate an Azure-hosted app to other Azure reso
 - How to assign roles to the user-assigned managed identity
 - How to authenticate using the user-assigned managed identity from your app code
 
-[!INCLUDE [managed-identity-concepts](../includes/managed-identity-concepts.md)]
+[!INCLUDE [managed-identity-concepts](~/azure-dev-docs/articles/includes/authentication/managed-identity-concepts.md)]
 
 The sections ahead describe the steps to enable and use a user-assigned managed identity for an Azure-hosted app. If you need to use a system-assigned managed identity, visit the [system-assigned managed identities](system-assigned-managed-identity.md) article for more information.