Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into erfreshness3

Author: duongau

articles/azure-resource-manager/management/create-private-link-access-commands.md

@@ -77,7 +77,7 @@ To create the private link association, use:
 
 # [Azure CLI](#tab/azure-cli)
 
-### Example
+  ### Example
 
   ```azurecli
   # Login first with az login if not using Cloud Shell

articles/azure-resource-manager/templates/template-specs-create-portal-forms.md

@@ -184,7 +184,7 @@ Copy this file and save it locally. This tutorial assumes you named it **keyvaul
 
 The Azure portal provides a sandbox for creating and previewing forms. This sandbox can render a form from an existing ARM template. Use this default form to get started with creating a form for your template spec. For more information about the form structure, see [FormViewType](https://github.com/Azure/portaldocs/blob/main/portal-sdk/generated/dx-view-formViewType.md).
 
-1. Open the [Form view sandbox](https://also known as.ms/form/sandbox).
+1. Open the [Form view sandbox](https://aka.ms/form/sandbox).
 
     :::image type="content" source="./media/template-specs-create-portal-forms/deploy-template-spec-config.png" alt-text="Screenshot of Azure portal form view sandbox interface.":::
 

articles/deployment-environments/how-to-authenticate.md

@@ -1,16 +1,20 @@
 ---
 title: Authenticate to Azure Deployment Environments REST APIs
-description: Learn how to authenticate to Azure Deployment Environments REST APIs by using Microsoft Entra ID.
+description: Learn how to authenticate to Azure Deployment Environments REST APIs as administrator or developer, by using the Azure CLI.
 ms.service: azure-deployment-environments
 ms.custom: build-2023
-ms.topic: conceptual
+ms.topic: concept-article
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 11/22/2023
+ms.date: 01/31/2025
+
+#customer intent: As a developer, I want to learn how to authenticate to Microsoft Dev Box REST APIs, so that I can securely interact with Microsoft Dev Box services.
 ---
 
 # Authenticate to Azure Deployment Environments REST APIs
 
+In this article, you'll learn how to authenticate to Microsoft Dev Box REST APIs using the Azure CLI. Authentication is a crucial step for accessing both administrator (control plane) and developer (data plane) APIs. This guide walks you through retrieving an access token from Microsoft Entra ID, understanding the token's structure and validity, and using the bearer token to access REST APIs. By following these steps, you can securely interact with Microsoft Dev Box services.
+
 > [!TIP]
 > Before authenticating, ensure that the user or identity has the appropriate permissions to perform the desired action. For more information, see [Provide access for dev team leads](./how-to-configure-project-admin.md) and [Provide access for developers](./how-to-configure-deployment-environments-user.md).
 
@@ -30,7 +34,7 @@ az login
 
 The command opens a browser window to the Microsoft Azure authentication page, where you can choose an account. The page requires you to give your Microsoft Entra ID username and password.
 
-Next, set the correct subscription context. If you authenticate from an incorrect subscription or tenant, you might receive unexpected **403 Forbidden** errors.
+Next, set the correct subscription context. If you authenticate from an incorrect subscription or tenant, you might receive unexpected *403 Forbidden* errors.
 
 ```azurecli
 az account set --subscription <subscription_id>
@@ -74,6 +78,6 @@ The token is a Base64 string. The token is valid for at least five minutes. The
 
 To access REST APIs, you must set the authorization header on your request. The header value should be the string `Bearer` followed by a space and the token you received in the previous step.
 
-## Next steps
+## Related content
 
-- [Review Microsoft Entra ID fundamentals](../../articles/active-directory/fundamentals/whatis.md)
+- Review [Microsoft Entra ID fundamentals](../../articles/active-directory/fundamentals/whatis.md)

articles/deployment-environments/how-to-install-devcenter-cli-extension.md

@@ -8,7 +8,8 @@ ms.custom: build-2023, devx-track-azurecli
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 11/22/2023
+ms.date: 01/31/2025
+
 #Customer intent: As a platform engineer, I want to install the devcenter extension so that I can create Deployment Environments resources from the command line.
 ---
 
@@ -74,6 +75,6 @@ You might find the following commands useful while you work with the devcenter e
     az devcenter admin --help
     ```
 
-## Next steps
+## Related content
 
 For complete command listings, see the [Microsoft Dev Box and Azure Deployment Environments Azure CLI documentation](https://aka.ms/CLI-reference).

articles/dev-box/how-to-authenticate.md

@@ -1,14 +1,18 @@
 ---
 title: Authenticate to Microsoft Dev Box REST APIs
-description: Learn how to authenticate to Microsoft Dev Box REST APIs.
+description: Learn how to authenticate to Microsoft Dev Box REST APIs as administrator or developer, by using the Azure CLI.
 ms.service: dev-box
-ms.topic: conceptual
+ms.topic: concept-article
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 09/07/2023
+ms.date: 01/31/2025
+
+#customer intent: As a developer, I want to learn how to authenticate to Microsoft Dev Box REST APIs, so that I can securely interact with Microsoft Dev Box services.
 ---
 # Authenticating to Microsoft Dev Box REST APIs
 
+In this article, you'll learn how to authenticate to Microsoft Dev Box REST APIs using the Azure CLI. Authentication is a crucial step for accessing both administrator (control plane) and developer (data plane) APIs. This guide walks you through retrieving an access token from Microsoft Entra ID, understanding the token's structure and validity, and using the bearer token to access REST APIs. By following these steps, you can securely interact with Microsoft Dev Box services.
+
 > [!TIP]
 > Before authenticating, ensure that the user or identity has the appropriate permissions to perform the desired action. For more information, see [configuring project admins](./how-to-project-admin.md) and [configuring Dev Box users](./how-to-dev-box-user.md).
 
@@ -29,7 +33,7 @@ az login
 
 The command opens a browser window to the Microsoft Entra authentication page. It requires you to give your Microsoft Entra user ID and password.
 
-Next, set the correct subscription context. If you authenticate from an incorrect subscription or tenant you may receive unexpected 403 Forbidden errors.
+Next, set the correct subscription context. If you authenticate from an incorrect subscription or tenant, you might receive unexpected *403 Forbidden* errors.
 
 ```azurecli
 az account set --subscription <subscription_id>
@@ -41,7 +45,7 @@ az account set --subscription <subscription_id>
 ### Retrieve the Microsoft Entra access token
 
 Use the Azure CLI to acquire an access token for the Microsoft Entra authenticated user.
-Note that the resource ID is different depending on if you are accessing administrator (control plane) APIs or developer (data plane) APIs.
+The resource ID is different depending on if you're accessing administrator (control plane) APIs or developer (data plane) APIs.
 
 For administrator APIs, use the following command:
 ```azurecli-interactive
@@ -65,14 +69,15 @@ After authentication is successful, Microsoft Entra ID returns an access token f
 }
 ```
 
-The token is a Base64 string. The token is valid for at least 5 minutes with the maximum of 90 minutes. The expiresOn defines the actual token expiration time.
+The token is a Base64 string. The token is valid for at least 5 minutes with the maximum of 90 minutes. The `expiresOn` defines the actual token expiration time.
 
 > [!TIP]
-> Developer API tokens for the service are encrypted and cannot be decoded using JWT decoding tools. They can only be processed by the service.
+> Developer API tokens for the service are encrypted and can't be decoded using JWT decoding tools. They can only be processed by the service.
 
 
 ### Using a bearer token to access REST APIs
 To access REST APIs, you must set the Authorization header on your request. The header value should be the string `Bearer` followed by a space and the token you received in the previous step.
 
-## Next steps
+## Related content
+
 - Review [Microsoft Entra fundamentals](../../articles/active-directory/fundamentals/whatis.md).

articles/dev-box/how-to-install-dev-box-cli.md

@@ -8,7 +8,8 @@ ms.custom: devx-track-azurecli
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 04/25/2023
+ms.date: 01/31/2025
+
 #Customer intent: As a platform engineer, I want to install the Dev Box CLI extension so that I can create Dev Box resources from the command line.
 ---
 
@@ -31,9 +32,9 @@ az extension add --name devcenter
 az extension list
 ```
 ### Update the devcenter extension
-You can update the devcenter extension if you already have it installed.
+You can update the devcenter extension if it's already installed.
 
-To update a version of the extension that's installed
+To update the extension:
 ``` azurecli
 az extension update --name devcenter
 ```
@@ -72,6 +73,6 @@ You might find the following commands useful as you work with Dev Box.
     az devcenter admin --help
     ```
 
-## Next steps
+## Related content
 
 For complete command listings, refer to the [Microsoft Dev Box and Azure Deployment Environments Azure CLI documentation](https://aka.ms/CLI-reference).

articles/dev-box/includes/developer-portal-landing-page.md

@@ -0,0 +1,25 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 11/13/2024
+ms.topic: include
+ms.service: dev-box
+---
+
+1. Go to the [developer portal](https://aka.ms/devbox-portal). The landing page contains useful information and links. When you're ready, select **Sign in**. 
+
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-landing-page-sign-in.png" alt-text="Screenshot of the developer portal landing page with sign-in highlighted.":::
+
+#### [No existing dev boxes](#tab/no-existing-dev-boxes)
+
+1. If you don't have any dev boxes, you see this screen. Select **New dev box**.
+
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-dev-box.png" alt-text="Screenshot of the developer portal with new dev box highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-dev-box.png":::
+
+#### [Existing dev boxes](#tab/existing-dev-boxes)
+
+1. Select **New** > **New dev box**.
+ 
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-menu.png" alt-text="Screenshot of the developer portal with the New menu and Dev box option highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-menu.png":::
+ 
+---