MDB - Customizations updates - iteration 2

RoseHJM · RoseHJM · commit 7ded97b78f42 · 2025-05-09T12:39:15.000-07:00
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -227,7 +227,7 @@
     },
     {
       "source_path": "articles/databox-online/azure-stack-edge-2301-release-notes.md",
-      "redirect_url": "/previous-versions/azure/databox-online/azure-stack-edge-2301-release-notes",
+      "redirect_url": "/previous-versions/azure/databox-online/azure-stack-edge-2301-release-notes"
     },
     {
       "source_path": "articles/network-watcher/nsg-flow-logs-rest.md",
@@ -2393,7 +2393,7 @@
       "source_path_from_root": "/articles/app-service/manage-disaster-recovery.md",
       "redirect_url": "/azure/architecture/web-apps/guides/multi-region-app-service/multi-region-app-service",
       "redirect_document_id": false
-    },       
+    },
     {
       "source_path_from_root": "/articles/public-multi-access-edge-compute-mec/tutorial-create-vm-using-python-sdk.md",
       "redirect_url": "/previous-versions/azure/public-multi-access-edge-compute-mec/tutorial-create-vm-using-python-sdk",
@@ -6875,49 +6875,49 @@
       "redirect_document_id": false
     },
     {
-         "source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
+      "source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
       "redirect_url": "/azure/storage/files/storage-files-prevent-file-share-deletion",
       "redirect_document_id": false
-     },
-     {
+    },
+    {
       "source_path": "articles/defender-for-iot/organizations/release-notes-archive.md",
       "redirect_url": "/azure/defender-for-iot/organizations/release-notes-ot-monitoring-sensor-archive",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-portal.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-powershell.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-cli.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-template.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-terraform.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-bicep.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/defender-for-iot/organizations/eiot-sensor.md",
       "redirect_url": "/azure/defender-for-iot/organizations/concept-enterprise",
       "redirect_document_id": false
     }
   ]
-}
+}
diff --git a/articles/dev-box/.openpublishing.redirection.dev-box.json b/articles/dev-box/.openpublishing.redirection.dev-box.json
@@ -94,6 +94,11 @@
       "source_path_from_root": "/articles/dev-box/how-to-write-customization-file.md",
       "redirect_url": "/azure/dev-box/how-to-write-image-definition-file",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/dev-box/how-to-write-individual-customization-file.md",
+      "redirect_url": "../../azure/dev-box/how-to-write-user-customization-file",
+      "redirect_document_id": false
     }
   ]
 }
diff --git a/articles/dev-box/concept-what-are-team-customizations.md b/articles/dev-box/concept-what-are-team-customizations.md
@@ -7,7 +7,7 @@ ms.service: dev-box
 ms.custom:
   - ignite-2024
 ms.topic: concept-article
-ms.date: 04/18/2025
+ms.date: 05/09/2025
 
 #customer intent: As a Dev Center Admin or Project Admin, I want to understand how to use Dev Box customizations so that I can create efficient, ready-to-code configurations for my development teams.
 ---
@@ -24,9 +24,9 @@ Dev Box customizations let you:
 - Enforce organizational security policies.
 - Ensure consistency across dev boxes.
 
-Microsoft Dev Box offers two ways to use customizations. Team customizations are used to create a shared configuration for a team of developers. Individual customizations are used to create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
+Microsoft Dev Box offers two ways to use customizations. Team customizations are used to create a shared configuration for a team of developers. User customizations are used to create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
 
-| Feature                     | Team customizations       | Individual customizations |
+| Feature                     | Team customizations       | User customizations |
 |-----------------------------|---------------------------|---------------------------|
 | **Configure on**            | Dev box pool             | Dev box                   |
 | **Customizations apply to** | All dev boxes in pool    | Individual dev box        |
@@ -50,14 +50,14 @@ User customizations can only use system tasks if the user is an administrator, o
 When you're creating tasks, determine which of them need to run in a system context and which of them can run in a user context (after sign-in). 
 When creating tasks, determine which need to run in a system context and which run in a user context after sign-in.
 
-## Differences between team customizations and individual customizations
+## Differences between team customizations and user customizations
 
-Individual developers can upload a customization file when creating their dev box to control the development environment. Developers should use individual customizations only for personal settings and apps. Tasks specified in the individual customization file run only in the user context, after sign-in.
-Developers use individual customizations only for personal settings and apps.
+Individual developers can upload a customization file when creating their dev box to control the development environment. Developers should use user customizations only for personal settings and apps. Tasks specified in the user customization file run only in the user context, after sign-in.
+Developers use user customizations only for personal settings and apps.
 Sharing common YAML files among developer teams is inefficient, leads to errors, and violates compliance policies. Dev Box team customizations allow developer team leads and IT admins to preconfigure customization files, eliminating the need for developers to find and upload these files when creating a dev box.
 
 ## How do customizations work?
-Team customization and individual customizations are both YAML-based files that specify a list of tasks to apply when creating a dev box. Select the appropriate tab to learn more about how each type of customization works.
+Team customization and user customizations are both YAML-based files that specify a list of tasks to apply when creating a dev box. Select the appropriate tab to learn more about how each type of customization works.
 
 # [Team customizations](#tab/team-customizations)
 ### How do team customizations work?
@@ -100,17 +100,17 @@ To set up your Dev Box service to support team customizations, follow these step
 1. **Create a dev box**:
     a. Use the developer portal to create your dev box from the configured pool.
 
-For more information, see [Write a team customization file](how-to-write-customization-file.md).
+For more information, see [Write an image definition file for Dev Box team customizations](how-to-write-image-definition-file.md).
 
-# [Individual customizations](#tab/individual-customizations)
-### How do individual customizations work?
-Individual developers can attach a YAML-based customization file when creating their dev box to control the development environment. Developers use individual customizations only for personal settings and apps.  
+# [user customizations](#tab/user-customizations)
+### How do user customizations work?
+Individual developers can attach a YAML-based customization file when creating their dev box to control the development environment. Developers use user customizations only for personal settings and apps.  
 
-:::image type="content" source="media/concept-what-are-team-customizations/individual-customizations-workflow.png" alt-text="Diagram that shows the workflow for Dev Box individual customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-team-customizations/individual-customizations-workflow.png":::
+:::image type="content" source="media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg" alt-text="Diagram that shows the workflow for Dev Box user customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg":::
 
-#### Configure your Dev Box service for individual customizations
+#### Configure your Dev Box service for user customizations
 
-To set up your Dev Box service to support individual customizations, follow these steps:
+To set up your Dev Box service to support user customizations, follow these steps:
 
 1. **Use a PowerShell and WinGet tasks**:
     a. Platform supports PowerShell and WinGet.
@@ -127,13 +127,12 @@ To set up your Dev Box service to support individual customizations, follow thes
 1. **Dev box creation**:
     a. The dev box is created with the specified customizations.
 
-For more information, see [Write an individual customization file](how-to-write-customization-file.md).
+For more information, see [Write a user customization file for a dev box](how-to-write-user-customization-file.md).
 
 ---
 
 ## Related content
 
 - [Quickstart: Create a dev box by using team customizations](quickstart-team-customizations.md)
-- [Write a customization file for a dev box](how-to-write-customization-file.md)
 - [Configure imaging for Dev Box team customizations](how-to-configure-customization-imaging.md)
 
diff --git a/articles/dev-box/how-to-use-secrets-customization-files.md b/articles/dev-box/how-to-use-secrets-customization-files.md
@@ -1,6 +1,6 @@
 ---
 title: Use key vault secrets in customization files
-description: Learn how to use Azure Key Vault secrets in team and individual customization files to clone private repositories.
+description: Learn how to use Azure Key Vault secrets in team and user customization files to clone private repositories.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: dev-box
@@ -46,9 +46,9 @@ tasks:
       pat: '{{KEY_VAULT_SECRET_URI}}'
 ```
 
-## Use key vault secrets in individual customization files
+## Use key vault secrets in user customization files
 
-To clone a private Azure Repos repository from an individual customization file, you don't need to configure a secret in Azure Key Vault. If you want to clone a private Azure Repos repository from an individual customization file, you don't need to configure a secret in Azure Key Vault. Instead, you can use `{{ado}}` or `{{ado://your-ado-organization-name}}` as a parameter. This parameter fetches an access token on your behalf when you're creating a dev box. The access token has read-only permission to your repository.
+To clone a private Azure Repos repository from an user customization file, you don't need to configure a secret in Azure Key Vault. If you want to clone a private Azure Repos repository from an user customization file, you don't need to configure a secret in Azure Key Vault. Instead, you can use `{{ado}}` or `{{ado://your-ado-organization-name}}` as a parameter. This parameter fetches an access token on your behalf when you're creating a dev box. The access token has read-only permission to your repository.
 
 The `git-clone` task in the quickstart catalog uses the access token to clone your repository. Here's an example:
 
diff --git a/articles/dev-box/how-to-write-image-definition-file.md b/articles/dev-box/how-to-write-image-definition-file.md
@@ -10,7 +10,7 @@ ms.custom:
   - ai-gen-description
   - ai-seo-date:04/18/2025
 ms.topic: how-to
-ms.date: 04/18/2025
+ms.date: 05/09/2025
 
 #customer intent: As a Dev Center Admin or Project Admin, I want to create image definition files so that my development teams can create customized dev boxes.
 ---
@@ -22,9 +22,9 @@ ms.date: 04/18/2025
 
 The Dev Box customizations feature helps you streamline the setup of cloud-based development environments. Getting developers started on a new project or team can be complex and time-consuming. Customizations let you configure ready-to-code workstations with applications, tools, repositories, code libraries, packages, and build scripts. This article guides you through the process of creating, testing, and editing an image definition file for your dev box using Visual Studio Code (VS Code). 
 
-There are two ways to use customizations in Microsoft Dev Box. Team customizations create a shared configuration for a team of developers. Individual customizations create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
+There are two ways to use customizations in Microsoft Dev Box. Team customizations create a shared configuration for a team of developers. User customizations create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
 
-| Feature                     | Team customizations       | Individual customizations       |
+| Feature                     | Team customizations       | User customizations       |
 |-----------------------------|---------------------------|---------------------------------|
 | Configure on               | Dev box pool             | Dev box                           |
 | Customizations apply to    | All dev boxes in pool    | Individual dev box                |
diff --git a/articles/dev-box/how-to-write-user-customization-file.md b/articles/dev-box/how-to-write-user-customization-file.md
@@ -1,6 +1,6 @@
 ---
-title: Write an Individual Customization File for Your Dev Box
-description: Learn how to upload and validate individual customization files for dev boxes directly from your local drive or repository.
+title: Write an User Customization File for Your Dev Box
+description: Learn how to upload and validate user customization files for dev boxes directly from your local drive or repository.
 #customer intent: As a Dev Center Admin or Project Admin, I want to create image definition files so that my development teams can create customized dev boxes.
 author: RoseHJM
 ms.author: rosemalcolm
@@ -12,19 +12,19 @@ ms.custom:
   - ai-seo-date:04/19/2025
   - ai-gen-description
 ms.topic: how-to
-ms.date: 04/19/2025
+ms.date: 05/09/2025
 ---
 
-# Write an individual customization file for a dev box
+# Write an user customization file for a dev box
 
 [!INCLUDE [note-build-2025](includes/note-build-2025.md)]
 
 
-The Dev Box individual customizations feature helps you streamline the setup of your dev boxes. Starting a new project or joining a team is often complex and time consuming. With customizations, you can configure your dev boxes with the applications, tools, repositories, code libraries, packages, and build scripts that you need. This article guides you through the process of creating, testing, and editing an individual customization file for your dev box using Visual Studio Code (VS Code). 
+The Dev Box user customizations feature helps you streamline the setup of your dev boxes. Starting a new project or joining a team is often complex and time consuming. With customizations, you can configure your dev boxes with the applications, tools, repositories, code libraries, packages, and build scripts that you need. This article guides you through the process of creating, testing, and editing an user customization file for your dev box using Visual Studio Code (VS Code). 
 
-You can use customizations in Microsoft Dev Box in two ways. Team customizations are used to create a shared configuration for a team of developers. Individual customizations are used to create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
+You can use customizations in Microsoft Dev Box in two ways. Team customizations are used to create a shared configuration for a team of developers. User customizations are used to create a personal configuration for an individual developer. The following table summarizes the differences between the two types of customizations.
 
-| Feature                     | Team customizations       | Individual customizations       |
+| Feature                     | Team customizations       | User customizations       |
 |-----------------------------|---------------------------|----------------------------------|
 | Configure on                | Dev box pool             | Dev box                         |
 | Customizations apply to     | All dev boxes in pool    | Individual dev box              |
@@ -51,7 +51,7 @@ To perform the required actions for creating and applying customizations to a de
 | Use the developer portal to upload and apply a YAML file during dev box creation. | Dev Box User          |
 
 
-## Create an individual customization file
+## Create a user customization file
 
 You can create and manage customization files by using VS Code. You can use the Microsoft Dev Box extension in VS Code to discover the tasks in the attached catalog and test the customization file.
 
@@ -85,7 +85,7 @@ tasks:
 
 To learn more, see [WinGet configuration](https://aka.ms/winget-configuration).
 
-## Create a dev box using an individual customization file
+## Create a dev box using a user customization file
 
 You can use an individual customization file by uploading it from a local drive when creating your dev box, or by downloading it from a repository. 
 Customization files stored in a repository must be called *workload.yaml*. Customization files that are stored locally for upload should be called *myfilename.yaml*. Name customization files stored locally for upload as *myfilename.yaml*.
diff --git a/articles/dev-box/media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg b/articles/dev-box/media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg
diff --git a/articles/dev-box/media/concept-what-are-team-customizations/individual-customizations-workflow.png b/articles/dev-box/media/concept-what-are-team-customizations/individual-customizations-workflow.png

Original file line number	Diff line number	Diff line change
`@@ -94,6 +94,11 @@`
`94`	`94`	`"source_path_from_root": "/articles/dev-box/how-to-write-customization-file.md",`
`95`	`95`	`"redirect_url": "/azure/dev-box/how-to-write-image-definition-file",`
`96`	`96`	`"redirect_document_id": false`
	`97`	`+ },`
	`98`	`+ {`
	`99`	`+ "source_path": "articles/dev-box/how-to-write-individual-customization-file.md",`
	`100`	`+ "redirect_url": "../../azure/dev-box/how-to-write-user-customization-file",`
	`101`	`+ "redirect_document_id": false`
`97`	`102`	`}`
`98`	`103`	`]`
`99`	`104`	`}`