Merge pull request #263084 from GitHubber17/183368-23

Freshness | Microsoft Dev Box procedure

Author: v-regandowner

articles/dev-box/tutorial-dev-box-limits.md

@@ -1,11 +1,11 @@
 ---
-title: "Tutorial: Limit the number of dev boxes in a project to help control costs" #Required; page title displayed in search results. "Tutorial: \<verb\> * \<noun\>". Include the brand.
-description: Each dev box incurs compute and storage costs. This tutorial shows you how to set a limit on the number of dev boxes developers can create in a project.  #Required; article description that is displayed in search results. Include the word "tutorial".
-author: RoseHJM #Required; your GitHub user alias, with correct capitalization.
-ms.author: rosemalcolm #Required; microsoft alias of author; optional team alias.
-ms.service: dev-box #Required; service per approved list. service slug assigned to your service by ACOM.
-ms.topic: tutorial #Required; leave this attribute/value as-is.
-ms.date: 06/30/2023 #Required; mm/dd/yyyy format.
+title: "Tutorial: Limit the number of dev boxes in a project to help control costs"
+description: Each dev box incurs compute and storage costs. This tutorial shows you how to set a limit on the number of dev boxes developers can create in a project.
+author: RoseHJM
+ms.author: rosemalcolm
+ms.service: dev-box
+ms.topic: tutorial
+ms.date: 01/11/2024
 
 #CustomerIntent: As a project admin, I want to set a limit on the number of dev boxes a dev box user can create as part of my cost management strategy.
 ---
@@ -14,60 +14,68 @@ ms.date: 06/30/2023 #Required; mm/dd/yyyy format.
 
 You can set a limit on the number of dev boxes each developer can create within a project. You can use this functionality to help manage costs, use resources effectively, or prevent dev box creation for a given project. 
 
-In the developer portal, you see the number of dev boxes that you've created in a project, and the total number of dev boxes you can create in the project. If you've used all your available dev boxes in a project, you can't create a new dev box.
+In the developer portal, a Dev Box User can see their existing dev boxes and their total number of allocations for each project. When they reach their allocation limit for a project, they can't create a new dev box for that project.
 
 In this tutorial, you learn how to:
 
 > [!div class="checklist"]
 > * Set a dev box limit for your project by using the Azure portal
-> * View dev box Limits in the developer portal
+> * View dev box limits in the developer portal
  
 ## Prerequisites
 
 - A Dev Box project in your subscription 
-- Project Admin permission to that project
+- Project Admin role permissions to that project
 
 ## Set a dev box limit for your project
 
-The dev box limit is the number of dev boxes each developer can create in a project. For example, if you set the limit to 3, each developer in your team can create 3 dev boxes.
+The dev box limit is the number of dev boxes each developer can create in a project. For example, if you set the limit to 3, each developer in your team can create three dev boxes.
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
-1. In the search box, enter *projects*. In the list of results, select **Projects**. 
+
+1. In the search box, enter **projects**. In the list of results, select **Projects**. 
+
 1. Select the project that you want to set a limit for. 
+
 1. On the left menu, select **Limits**.
-1. On the **Limits** page, for **Enable dev box limit**, select **Yes**.
+
+1. On the **Limits** page, toggle the **Enable dev box limit** setting to **Yes**.
 
-   :::image type="content" source="media/tutorial-dev-box-limits/enable-dev-box-limits.png" alt-text="Screenshot showing the dev box limits options for a project, with Yes highlighted."::: 
+   :::image type="content" source="media/tutorial-dev-box-limits/enable-dev-box-limits.png" alt-text="Screenshot showing the dev box limits options for a project, with Yes highlighted." lightbox="media/tutorial-dev-box-limits/enable-dev-box-limits.png"::: 
 
 1. In **Dev boxes per developer**, enter a dev box limit and then select **Apply**. 
 
-   :::image type="content" source="media/tutorial-dev-box-limits/dev-box-limit-number.png" alt-text="Screenshot showing dev box limits for a project enabled, with dev boxes per developer highlighted.":::
+   :::image type="content" source="media/tutorial-dev-box-limits/dev-box-limit-number.png" alt-text="Screenshot showing dev box limits for a project enabled, with dev boxes per developer highlighted." lightbox="media/tutorial-dev-box-limits/dev-box-limit-number.png":::
 
->[!TIP]
-> To prevent developers creating more dev boxes in a project, set the dev box limit to 0. This won’t delete existing dev boxes, but it will prevent further creation of dev boxes in the project. 
+> [!TIP]
+> To prevent developers creating more dev boxes in a project, set the dev box limit to 0. This action doesn't delete existing dev boxes, but it prevents creation of new dev boxes in the project. 
 
 ## View dev box limits in the developer portal
-In the developer portal, select a project to see the number of dev boxes you have already created and the total number of dev boxes you can create in that project. 
 
-:::image type="content" source="media/tutorial-dev-box-limits/dev-boxes-used.png" alt-text="Screenshot showing the developer portal add new dev box pane with a project selected, the number of dev boxes used and the total number of dev boxes.":::
+In the developer portal, select a project to see the number of existing dev boxes and the total number of dev boxes you can create in that project. 
+
+:::image type="content" source="media/tutorial-dev-box-limits/dev-boxes-used.png" alt-text="Screenshot showing the developer portal Add new dev box pane with a project selected, the number of dev boxes used, and the total number of dev boxes." lightbox="media/tutorial-dev-box-limits/dev-boxes-used.png" :::
 
-If you’ve used all your available dev boxes in a project, you see an error message and you can't create a new dev box:
+If all of your available dev boxes in a project are in use, you see an error message and you can't create a new dev box:
 
-*Your project administrator has set a limit of 3 dev boxes per user in Contoso-software-dev. Please delete a dev box in this project, or contact your administrator to increase your limit.* 
+*Your project administrator has set a limit of \<number> dev boxes per user in \<project name>. Please delete a dev box in this project, or contact your administrator to increase your limit.* 
 
-:::image type="content" source="media/tutorial-dev-box-limits/dev-box-limit-exceeded.png" alt-text="Screenshot showing the developer portal add new dev box pane with a project selected, and an error message.":::
+:::image type="content" source="media/tutorial-dev-box-limits/dev-box-limit-exceeded.png" alt-text="Screenshot showing the developer portal Add new dev box pane with a project selected, and an error message." lightbox="media/tutorial-dev-box-limits/dev-box-limit-exceeded.png":::
 
 ## Clean up resources
 
 If you're not going to continue to use dev box limits, remove the limit with the following steps:
 
-1. In the search box, enter *projects*. In the list of results, select **Projects**. 
-1. Select the project that you want to set a limit for. 
+1. In the search box, enter **projects**. In the list of results, select **Projects**. 
+
+1. Select the project associated with the limit that you want to remove. 
+
 1. On the left menu, select **Limits**.
-1. On the **Limits** page, for **Enable dev box limit**, select **No**.
+
+1. On the **Limits** page, change the **Enable dev box limit** setting to **No**.
 
 ## Next steps
 
-- [Use the CLI to configure dev box limits](/cli/azure/devcenter/admin/project)
+- [Use the Azure CLI to configure dev box limits](/cli/azure/devcenter/admin/project)
 - [Manage a dev box project](how-to-manage-dev-box-projects.md)
 - [Microsoft Dev Box pricing](https://azure.microsoft.com/pricing/details/dev-box/)