Skip to content

Commit 47e9692

Browse files
author
RoseHJM
committed
Added Preview includes
1 parent 50700a2 commit 47e9692

8 files changed

+27
-6
lines changed

articles/dev-box/concept-what-are-team-customizations.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ ms.date: 10/2/2024
1414
Getting developers started on a new project or team can be complex and time-consuming. Microsoft Dev Box Team Customizations enables you to streamline developer environment setup. With Team Customizations, you can configure ready-to-code workstations with necessary applications, tools, repositories, code libraries, packages, and build scripts.
1515
Team Customizations allows you to define a shared Dev Box configuration for each of your development teams without having to invest in setting up an imaging solution like Packer or Azure virtual machine (VM) Image Templates. It provides a lightweight alternative that allows central platform engineering teams to delegate Dev Box configuration management to the teams that use them. Team Customizations also offers an in-built way of optimizing your team's Dev Box customizations by flattening them into a custom image using the same customization file, without the need to manage added infrastructure or maintain image templates.
1616

17+
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
18+
1719
## How does Dev Box Team Customizations work?
1820
When you configure Dev Box Team Customizations for your organization, careful planning and informed decision-making are essential. The following diagram provides an overview of the process and highlights key decision points.
1921

@@ -65,7 +67,7 @@ Individual developers can attach a yaml-based customization file when creating t
6567
- Specifies OS, compute, storage
6668

6769
## Related content
68-
- Quickstart
69-
- Write a customization file
70-
- Configure customization imaging
71-
- Configure customization tasks
70+
- [Quickstart: Create Dev Box Team Customizations](quickstart-team-customizations.md)
71+
- [Write a Team Customization file for Dev Box](how-to-write-customization-file.md)
72+
- [Configure imaging for Dev Box Team Customizations](how-to-configure-customization-imaging.md)
73+
- [Configure customization tasks](how-to-create-customization-tasks-catalog.md)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Process overview:
2222
1. Test the dev box to verify that the customizations are applied.
2323
1. Build a reusable image.
2424

25+
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
26+
2527
## Prerequisites
2628
To complete the steps in this article, you need:
2729
- A dev center with an existing dev box definition and network connection. If you don't have a dev center, follow the steps in [Quickstart: Configure Microsoft Dev Box](quickstart-configure-dev-box-service.md) to create them.

articles/dev-box/how-to-create-tasks-catalog.md renamed to articles/dev-box/how-to-create-customization-tasks-catalog.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ ms.date: 10/26/2024
1414

1515
Creating tasks for Dev Box Team Customizations allows you to define specific actions for your dev boxes, ensuring a consistent and efficient development environment. Creating new tasks in a catalog allows you to create customizations 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.
1616

17+
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
18+
1719
## Prerequisites
1820
To complete the steps in this article, you must have:
1921
* A dev center configured with a dev box project.

articles/dev-box/how-to-write-customization-file.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@ ms.date: 10/26/2024
1313
# Write a Team Customization file for Dev Box
1414
In this article, you learn how to create and test a customization file for your dev box using Visual Studio Code and Dev Home. This article helps you define new tasks in your customization file, apply them to your dev boxes, and test these customizations directly in Visual Studio Code. Ensure that a catalog with tasks is attached to the dev center before you begin.
1515

16+
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
17+
1618
## Prerequisites
1719

1820
To complete the steps in this article, you must:
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
author: RoseHJM
3+
ms.author: rosemalcolm
4+
ms.date: 10/26/2024
5+
ms.topic: include
6+
ms.service: dev-box
7+
---
8+
9+
> [!IMPORTANT]
10+
> Dev Box Team Customizations are currently in PREVIEW.
11+
> For more information about the preview status, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). The document defines legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

articles/dev-box/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ landingContent:
9494
- text: Configure imaging for Customizations
9595
url: how-to-configure-customization-imaging.md
9696
- text: Create customization tasks
97-
url: how-to-create-tasks-catalog.md
97+
url: how-to-create-customization-tasks-catalog.md
9898
- text: Configure Azure Compute Gallery
9999
url: how-to-configure-azure-compute-gallery.md
100100
- text: Provision a custom image by using Azure VM Image Builder

articles/dev-box/quickstart-team-customizations.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ ms.date: 10/26/2024
1414
# Quickstart: Create Dev Box Team Customizations
1515

1616
In this quickstart, you create a dev box from a team customizations file. Team customizations allow you to create a customized dev box for your development team, providing a tailored environment for your projects.
17+
18+
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
1719

1820
## Prerequisites
1921

articles/dev-box/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ items:
7878
- name: Configure imaging for Customizations
7979
href: how-to-configure-customization-imaging.md
8080
- name: Create customization tasks
81-
href: how-to-create-tasks-catalog.md
81+
href: how-to-create-customization-tasks-catalog.md
8282
- name: Create & connect to dev boxes
8383
items:
8484
- name: Manage a dev box through developer portal

0 commit comments

Comments
 (0)