You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/dev-box/concept-authoring-troubleshooting-guide-team-customizations.md
+10-13Lines changed: 10 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,17 +5,19 @@ description: "Enhance your Microsoft Dev Box workflows with this guide to author
5
5
author: mikeparker104
6
6
ms.author: miparker
7
7
ms.reviewer: rosemalcolm
8
-
ms.date: 12/11/2025
8
+
ms.date: 02/06/2026
9
9
ms.topic: concept-article
10
10
ms.service: dev-box
11
+
ms.custom:
12
+
- ai-usage: ai-assisted
11
13
---
12
14
13
15
# Authoring and troubleshooting guide for team customizations
14
16
15
17
This guide provides recommendations for creating Microsoft Dev Box image definition files (`imagedefinition.yaml`). It pulls together and extends content from existing documentation to raise visibility of effective approaches, common pitfalls, and troubleshooting guidance. The intent is to aid in onboarding and building reliable, maintainable customizations that work consistently for your development teams.
16
18
17
19
> [!NOTE]
18
-
> This guide builds on the [Create a dev box by using team customizations quickstart](/azure/dev-box/quickstart-team-customizations). If you're new to Dev Box customizations, complete that tutorial first.
20
+
> This guide builds on [Configure team customizations](/azure/dev-box/how-to-configure-team-customizations). If you're new to Dev Box customizations, review that article first.
19
21
20
22
This guide covers strategies for:
21
23
@@ -33,11 +35,11 @@ Before you begin, ensure you have:
33
35
| Development environment | Dev Box with local admin permissions. Visual Studio (VS) Code with latest version. Dev Box extension installed and GitHub Copilot extension installed. |
34
36
35
37
> [!TIP]
36
-
> For comprehensive background on Dev Box customizations, see [Team Customizations documentation](/azure/dev-box/concept-what-are-team-customizations?tabs=team-customizations) and [How to write an image definition file](/azure/dev-box/how-to-write-image-definition-file).
38
+
> For comprehensive background on Dev Box customizations, see [Dev Box customizations overview](/azure/dev-box/concept-what-are-dev-box-customizations) and [Configure team customizations](/azure/dev-box/how-to-configure-team-customizations).
37
39
38
40
## Approach recommendations
39
41
40
-
When authoring Dev Box customizations, choose the approach that best fits your team's workflow and technical requirements. For background on how customizations work, see [Use Team Customizations](/azure/dev-box/quickstart-team-customizations).
42
+
When authoring Dev Box customizations, choose the approach that best fits your team's workflow and technical requirements. For background on how customizations work, see [Configure team customizations](/azure/dev-box/how-to-configure-team-customizations).
41
43
42
44
### Start with the authoring agent
43
45
@@ -183,7 +185,7 @@ parameters:
183
185
- **Document security assumptions** for future maintainers
184
186
185
187
> [!TIP]
186
-
> For comprehensive guidance on using secrets, see [Use Azure Key Vault secrets in customization files](/azure/dev-box/how-to-use-secrets-customization-files).
188
+
> For comprehensive guidance on using secrets, see [Connect to Azure resources or clone private repositories](/azure/dev-box/how-to-customizations-connect-resource-repository).
187
189
188
190
### Ensure WinGet package discovery
189
191
@@ -313,13 +315,8 @@ tasks:
313
315
314
316
## Related content
315
317
316
-
- [Create a dev box by using team customizations (prerequisite quickstart)](/azure/dev-box/quickstart-team-customizations)
0 commit comments