Merge pull request #262695 from GitHubber17/183368-16

Freshness | Microsoft Dev Box procedures

Author: Jill Grant

articles/dev-box/how-to-manage-dev-box-projects.md

@@ -6,7 +6,7 @@ services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 04/25/2023
+ms.date: 01/08/2024
 ms.topic: how-to
 #Customer intent: As a platform engineer, I want to be able to manage dev box projects so that I can provide appropriate dev boxes to my users. -->
 ---
@@ -28,97 +28,109 @@ To learn how to add a user to the Project Admin role, refer to [Provide access t
 [!INCLUDE [permissions note](./includes/note-permission-to-create-dev-box.md)]
 
 ## Permissions
+
 To manage a dev box project, you need the following permissions:
 
-|Action|Permission required|
-|-----|-----|
-|Create or delete dev box project|Owner, Contributor, or Write permissions on the dev center in which you want to create the project. |
-|Update a dev box project|Owner, Contributor, or Write permissions on the project.|
-|Create, delete, and update dev box pools in the project|Owner, Contributor, or DevCenter Project Admin.|
-|Manage a dev box within the project|Owner, Contributor, or DevCenter Project Admin.|
-|Add a dev box user to the project|Owner permissions on the project.|
+| Action | Permission required |
+|---|---|
+| _Create or delete dev box project_ | Owner, Contributor, or Write permissions on the dev center in which you want to create the project. |
+| _Update a dev box project_ | Owner, Contributor, or Write permissions on the project. |
+| _Create, delete, and update dev box pools in the project_ | Owner, Contributor, or DevCenter Project Admin. |
+| _Manage a dev box within the project_ | Owner, Contributor, or DevCenter Project Admin. |
+| _Add a dev box user to the project_ | Owner permissions on the project. |
 
 ## Create a Microsoft Dev Box project
 
 The following steps show you how to create and configure a Microsoft Dev Box project.
 
-1. In the [Azure portal](https://portal.azure.com), in the search box, type *Projects* and then select **Projects** from the list. 
+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. On the Projects page, select **+Create**.
+1. On the **Projects** page, select **Create**.
 
-1. On the **Create a project** page, on the **Basics** tab, enter the following values:
+1. On the **Create a project** pane, on the **Basics** tab, enter the following values:
+
+   | Setting | Value |
+   |---|---|
+   | **Subscription** | Select the subscription in which you want to create the project. |
+   | **Resource group** | Select an existing resource group, or select **Create new** and then enter a name for the new resource group. |
+   | **Dev center** | Select the dev center that you want to associate with this project. All the settings at the dev center level apply to the project. |
+   | **Name** | Enter a name for the project. |
+   | **Description** | Enter a brief description of the project. |
+
+   :::image type="content" source="./media/how-to-manage-dev-box-projects/dev-box-project-create.png" alt-text="Screenshot of the Create a dev box project Basics tab." lightbox="./media/how-to-manage-dev-box-projects/dev-box-project-create.png":::
+
+1. On the **Dev box management** tab, ensure **No** is selected.
 
-   |Name|Value|
-   |----|----|
-   |**Subscription**|Select the subscription in which you want to create the project.|
-   |**Resource group**|Select an existing resource group or select **Create new**, and enter a name for the resource group.|
-   |**Dev center**|Select the dev center to which you want to associate this project. All the dev center level settings are applied to the project.|
-   |**Name**|Enter a name for your project. |
-   |**Description**|Enter a brief description of the project. |
+   You can select **Yes** to limit the number of dev boxes per developer, and specify the maximum number of dev boxes a developer can create. The default, **No**, means developers can create an unlimited number of dev boxes.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/dev-box-project-create.png" alt-text="Screenshot of the Create a dev box project basics tab.":::
+   To learn more about dev box limits, see [Tutorial: Control costs by setting dev box limits on a project](./tutorial-dev-box-limits.md).
 
-1. [Optional] On the **Tags** tab, enter a name and value pair that you want to assign.
+1. (Optional) On the **Tags** tab, enter a name/value pair that you want to assign.
 
 1. Select **Review + Create**.
 
 1. On the **Review** tab, select **Create**.
 
 1. Confirm that the project is created successfully by checking the notifications. Select **Go to resource**.
 
-1. Verify that you see the **Project** page.
+1. Verify that the project appears on the **Projects** page.
+ 
+As you create a project, you might see this informational message about catalogs: 
+
+:::image type="content" source="media/how-to-manage-dev-box-projects/project-catalog-message.png" alt-text="Screenshot of the informational message, The dev center that contains this project does not have a catalog assigned. Environments cannot be deployed in this project until a catalog containing at least one template has been assigned." lightbox="media/how-to-manage-dev-box-projects/project-catalog-message.png":::
+
+Because you're not configuring Deployment Environments, you can safely ignore this message.
 
 ## Delete a Microsoft Dev Box project
 
 You can delete a Microsoft Dev Box project when you're no longer using it. Deleting a project is permanent and can't be undone. You can't delete a project that has dev box pools associated with it.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, type *Projects* and then select **Projects** from the list.
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
-1. Open the project you want to delete.
+1. Open the dev box project that you want to delete.
 
-1. Select the dev box project you want to delete and then select **Delete**.
+1. Select **Delete**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/delete-project.png" alt-text="Screenshot of the list of existing dev box pools, with the one to be deleted selected.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-projects/delete-project.png" alt-text="Screenshot of the overview page for a dev box project and the Delete option highlighted." lightbox="./media/how-to-manage-dev-box-projects/delete-project.png":::
 
-1.  In the confirmation message, select **Confirm**.
-
-    :::image type="content" source="./media/how-to-manage-dev-box-projects/confirm-delete-project.png" alt-text="Screenshot of the Delete dev box pool confirmation message.":::
+1. In the confirmation message, select **OK**.
 
+   :::image type="content" source="./media/how-to-manage-dev-box-projects/confirm-delete-project.png" alt-text="Screenshot of the Delete dev box pool confirmation message.":::
 
 ## Provide access to a Microsoft Dev Box project
 
-Before users can create dev boxes based on the dev box pools in a project, you must provide access for them through a role assignment. The Dev Box User role enables dev box users to create, manage and delete their own dev boxes. You must have sufficient permissions to a project before you can add users to it.
+Before users can create dev boxes based on the dev box pools in a project, you must provide access for them through a role assignment. The Dev Box User role enables dev box users to create, manage, and delete their own dev boxes. You must have sufficient permissions to a project before you can add users to it.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, type *Projects* and then select **Projects** from the list.
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
-1. Select the project you want to provide your team members access to.
- 
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/projects-grid.png" alt-text="Screenshot of the list of existing projects.":::
+1. Open the dev box project that you want to provide your team members access to.
 
-1. Select **Access Control (IAM)** from the left menu.
+1. On the left menu, select **Access Control (IAM)**, and then select **Add** > **Add role assignment**.
 
-1. Select **Add** > **Add role assignment**.
+   :::image type="content" source="./media/how-to-manage-dev-box-projects/project-permissions.png" alt-text="Screenshot that shows the page for project access control." lightbox="./media/how-to-manage-dev-box-projects/project-permissions.png":::
 
 1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
 
-    | Setting | Value |
-    | --- | --- |
-    | **Role** | Select **DevCenter Dev Box User**. |
-    | **Assign access to** | Select **User, group, or service principal**. |
-    | **Members** | Select the users or groups you want to have access to the project. |
+   | Setting | Value |
+   |---|---|
+   | **Role** | Select **DevCenter Dev Box User**. |
+   | **Assign access to** | Select **User, group, or service principal**. |
+   | **Members** | Select the users or groups you want to have access to the project. |
 
-    :::image type="content" source="media/how-to-manage-dev-box-projects/add-role-assignment-user.png" alt-text="Screenshot that shows the Add role assignment pane.":::
+   :::image type="content" source="media/how-to-manage-dev-box-projects/add-role-assignment-user.png" alt-text="Screenshot that shows the Add role assignment pane." lightbox="media/how-to-manage-dev-box-projects/add-role-assignment-user.png":::
 
 The user is now able to view the project and all the pools within it. They can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
 
 To assign administrative access to a project, select the DevCenter Project Admin role. For more information on how to add a user to the Project Admin role, see [Provide access to projects for project admins](how-to-project-admin.md).
 
-## Next steps
+## Related content
 
 - [Manage dev box pools](./how-to-manage-dev-box-pools.md)
-- [2. Create a dev box definition](quickstart-configure-dev-box-service.md#create-a-dev-box-definition)
-- [Configure an Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md)
+- [Create a dev box definition](quickstart-configure-dev-box-service.md#create-a-dev-box-definition)
+- [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md)