Landing page, ToC, Acrolinx

Author: RoseHJM

articles/dev-box/how-to-configure-customization-tasks.md

@@ -12,7 +12,7 @@ ms.date: 11/05/2024
 #customer intent: As a Dev Center Admin or Project Admin, I want to create additional tasks in a catalog so that I can create a specific customization in a customization or image definition file.
 ---
 
-# Create tasks for Dev Box team customizations
+# Configure tasks for Dev Box customizations
 
 When you create tasks for Microsoft Dev Box team customizations, you can define specific actions for your dev boxes to help ensure a consistent and efficient development environment. Creating new tasks in a catalog allows you to define reusable components tailored to your development teams and add guardrails around the configurations that are possible. This article guides you through creating a catalog for customization tasks, adding tasks, and attaching the catalog to a dev center or project.
 
@@ -33,7 +33,7 @@ To complete the steps in this article, you must have:
 
 A task performs a specific action, like installing software. Each task consists of one or more PowerShell scripts, along with a task.yaml file that provides parameters and defines how the scripts run. You can also include a PowerShell command in the task.yaml file.
 
-You can store a collection of curated tasks in a catalog that's attached to your dev center, with each task in a separate folder. Dev Box supports using a GitHub repository or an Azure Repos repository as a catalog. Dev Box scans a specified folder of the catalog recursively to find task definitions.
+You can store a collection of curated tasks in a catalog attached to your dev center, with each task in a separate folder. Dev Box supports using a GitHub repository or an Azure Repos repository as a catalog. Dev Box scans a specified folder of the catalog recursively to find task definitions.
 
 WinGet and PowerShell are available from any dev center without requiring a catalog. If your customizations use only WinGet or PowerShell, you can create tasks that use them in a customization file. If you need to use other tools or scripts, you can create tasks in a catalog.
 
@@ -71,7 +71,7 @@ To configure your key vault secrets for use in your YAML configurations:
 
 1. Ensure that your dev center project's managed identity has the Key Vault Reader role and Key Vault Secrets User role on your key vault.
 
-1. Grant the Key Vault Secrets User role for the key vault secret to each user or user group that should be able to consume the secret during the customization of a dev box. The user or group that's granted the role must include the managed identity for the dev center, your own user account, and any user or group that needs the secret during the customization of a dev box.
+1. Grant the Key Vault Secrets User role for the key vault secret to each user or user group that should be able to consume the secret during the customization of a dev box. The user or group granted the role must include the managed identity for the dev center, your own user account, and any user or group that needs the secret during the customization of a dev box.
 
 For more information on using key vault secrets in a customization file, see [Clone a private repository by using a customization file](how-to-write-customization-file.md#clone-a-private-repository-by-using-a-customization-file).
 

articles/dev-box/how-to-configure-dev-box-imaging.md

@@ -1,5 +1,5 @@
 ---
-title: Imaging for Dev Box Team Customizations
+title: Configure Imaging for Dev Box Team Customizations
 description: Configure dev box pools to use image definition files so that you can optimize customizations and create reusable images for your team.
 author: RoseHJM
 ms.author: rosemalcolm
@@ -69,7 +69,7 @@ For more information about attaching catalogs, see [Add and configure a catalog
 
 ## Configure a dev box pool to use an image definition
 
-Make customizations available to your development teams by configuring a dev box pool to use a customization file (imagedefinition.yaml). Store the customization file in a repository that's linked to a catalog in your dev center or project. Specify this file as the image definition for the pool, and the customizations are applied to new dev boxes.
+Make customizations available to your development teams by configuring a dev box pool to use a customization file (imagedefinition.yaml). Store the customization file in a repository linked to a catalog in your dev center or project. Specify this file as the image definition for the pool, and the customizations are applied to new dev boxes.
 
 The following steps show you how to create a dev box pool and specify an image definition:
 
@@ -86,7 +86,7 @@ The following steps show you how to create a dev box pool and specify an image d
    | **Network connection** | Select **Deploy to a Microsoft hosted network**, or use an existing network connection. |
    |**Enable single sign-on** | Select **Yes** to enable single sign-on for the dev boxes in this pool. Single sign-on must be configured for the organization. For more information, see [Enable single sign-on for dev boxes](https://aka.ms/dev-box/single-sign-on). |
    | **Dev box Creator Privileges** | Select **Local Administrator** or **Standard User**. |
-   | **Enable Auto-stop** | **Yes** is the default. Select **No** to disable an auto-stop schedule. You can configure an auto-stop schedule after the pool is created. |
+   | **Enable Auto-stop** | **Yes** is the default. Select **No** to disable an autostop schedule. You can configure an autostop schedule after the pool is created. |
    | **Stop time** | Select a time to shut down all the dev boxes in the pool. |
    | **Time zone** | Select the time zone that the stop time is in. |
    | **Licensing** | Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool. |
@@ -119,7 +119,7 @@ In order to generate an image, you need to assign the DevCenter service the requ
 
 1. Under that resource group, navigate to Access Control, and give the **Windows 365** and **Project Fidalgo** applications the roles **Storage Account Contributor**, **Storage Blob Data Contributor**, and **Reader**.
 
-During the process of building an image, Dev Box creates a temporary storage account in your subscription to store a snapshot, from which Dev Box generates an image. This storage account does not allow anonymous blob access and can only be accessed by identities with the Storage Blob Reader access. This storage account must be accessible from public networks, so that the Dev Box service can export your snapshot to it. If you have Azure policies that block the creation of storage accounts with public network access, create an exception for the subscription your DevCenter project is in.
+During the process of building an image, Dev Box creates a temporary storage account in your subscription to store a snapshot, from which Dev Box generates an image. This storage account doesn't allow anonymous blob access and can only be accessed by identities with the Storage Blob Reader access. This storage account must be accessible from public networks, so that the Dev Box service can export your snapshot to it. If you have Azure policies that block the creation of storage accounts with public network access, create an exception for the subscription your DevCenter project is in.
 
 ### Build the image
 

articles/dev-box/index.yml

@@ -87,16 +87,18 @@ landingContent:
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: What are Team Customizations
-            url: concept-what-are-team-customizations.md
-          - text: Write an image definition file
-            url: how-to-write-image-definition-file.md
-          - text: Use secrets in customization files
-            url: how-to-use-secrets-customization-files.md
+          - text: What are Dev Box Customizations
+            url: concept-what-are-dev-box-customizations.md
+          - text: Configure team customizations
+            url: how-to-configure-team-customizations.md
+          - text: Configure user customizations
+            url: how-to-configure-user-customizations.md
+          - text: Connect to resources and repositories
+            url: how-to-customizations-connect-resource-repository.md
           - text: Use GitHub Copilot to generate an image definition file
             url: how-to-use-copilot-generate-image-definition-file.md
-          - text: Configure imaging for Customizations
-            url: how-to-configure-customization-imaging.md
+          - text: Configure Dev Box imaging
+            url: how-to-configure-dev-box-imaging.md
           - text: Create customization tasks
             url: how-to-create-customization-tasks-catalog.md
 

articles/dev-box/toc.yml

@@ -75,19 +75,19 @@ items:
         href: how-to-customize-devbox-azure-image-builder.md
   - name: Customize dev boxes
     items:
-      - name: What are Team Customizations
-        href: concept-what-are-team-customizations.md
+      - name: What are Dev Box customizations
+        href: concept-what-are-dev-box-customizations.md
         displayName: customizations, image definition, team customization
-      - name: Write an image definition file
-        href: how-to-write-image-definition-file.md
+      - name: Configure team customizations
+        href: how-to-configure-team-customizations.md
         displayName: customizations, image definition, team customization
       - name: Create an image definition file with Copilot
         href: how-to-use-copilot-generate-image-definition-file.md
-      - name: Write an individual customization file
-        href: how-to-write-individual-customization-file.md
+      - name: Configure user customizations
+        href: how-to-configure-user-customizations.md
         displayName: customizations, image definition, personal customization, individual
-      - name: Configure imaging for Customizations
-        href: how-to-configure-customization-imaging.md
+      - name: Configure imaging for customizations
+        href: how-to-configure-dev-box-imaging.md
       - name: Create customization tasks
         href: how-to-create-customization-tasks-catalog.md
       - name: Use customization files to clone private repositories