Merge pull request #8009 from MicrosoftDocs/users/chcomley/438924-pats-entra

[PATs/Entra] Update use-demo-generator-v2.md

Author: v-shils

docs/demo-gen/use-demo-generator-v2.md

@@ -1,39 +1,35 @@
 ---
 title: Use Azure DevOps Demo Generator
-description: Use the Azure DevOps Services Demo Generator V2 to create and populate a demo project
+description: Use the Azure DevOps Services Demo Generator V2 to create and populate a demo project.
 ms.subservice: azure-devops-new-user
 ms.author: sdanie
 ms.topic: conceptual
 monikerRange: 'azure-devops'
-ms.date: 2/28/2025    
+ms.date: 06/06/2025    
 ---
 
 # Get started creating and populating demo Azure DevOps Services projects
 
 [!INCLUDE [version-eq-azure-devops](../includes/version-eq-azure-devops.md)] 
 
-You should first have the **Azure DevOps Demo Generator** app ready by following the steps outlined in the [configure section](configure.md). This app will automate the process of creating a new Azure DevOps project within your organization that is prepopulated with content (work items, repos, etc.) required for the labs. 
+This article explains how to use the **Azure DevOps Demo Generator** application to quickly create a new Azure DevOps project prepopulated with sample content, such as work items, repositories, and other resources needed for labs and demonstrations. 
 
-When you run the application you will see the information about predefined templates, choose the template by entering the corresponding number
+## Prerequisites
 
-> [!div class="mx-imgBorder"]
-> [![Azure DevOps Demo Generator select project template](../demo-gen/media/101.png "Azure DevOps Demo Generator select project template")](../demo-gen/media/101.png#lightbox)
+Set up the Demo Generator application by following the steps in the [configure section](configure.md).
 
-#### Select the authentication method
+## Select your authentication method for Demo Generator
 
-You have 2 methods to authenticate to use the Azure DevOps Demo Generator app:
+Use one of the following methods to authenticate to the Azure DevOps Demo Generator app:
 
-1. Device Login using AD authentication
-Register Your Application in Azure AD. Check out the [Register and Application](/entra/identity-platform/quickstart-register-app?tabs=certificate%2Cexpose-a-web-api#register-an-application) documentation for more details. 
+- **Microsoft Entra:** [Register your application in Microsoft Entra](/entra/identity-platform/quickstart-register-app?tabs=certificate%2Cexpose-a-web-api#register-an-application). 
 
-   * Login with the code displayed
+   * Sign in with the displayed code.
+   * Select an organization to create a project from the list.
 
-   * After the login, organizations will be listed and select an organization to create project
+[!INCLUDE [use-microsoft-entra-reduce-pats](../includes/use-microsoft-entra-reduce-pats.md)]
 
-   > [!div class="mx-imgBorder"]
-> [![Device login using AD Auth](../demo-gen/media/102.png "Device login using AD Auth")](../demo-gen/media/102.png#lightbox)
-
-1. Sign in with a [Personal Access Token (PAT)](../organizations/accounts/use-personal-access-tokens-to-authenticate.md#creating-pats) with the following scopes:
+- **Personal Access Token (PAT):** Sign in with a [Personal Access Token (PAT)](../organizations/accounts/use-personal-access-tokens-to-authenticate.md#creating-pats) with the following scopes:
 
    | Scope                      | Description                                |
    | -------------------------- | ------------------------------------------ |
@@ -43,35 +39,37 @@ Register Your Application in Azure AD. Check out the [Register and Application](
    | vso.dashboards_manage      | Team dashboards (manage)                   |
    | vso.extension_manage       | Extensions (read and manage)               |
    | vso.profile                | User profile (read)                        |
-   | vso.project_manage         | Project and team (read, write and manage)  |
-   | vso.release_manage         | Release (read, write, execute and manage)  |
-   | vso.serviceendpoint_manage | Service Endpoints (read, query and manage) |
+   | vso.project_manage         | Project and team (read, write, and manage)  |
+   | vso.release_manage         | Release (read, write, execute, and manage)  |
+   | vso.serviceendpoint_manage | Service Endpoints (read, query, and manage) |
    | vso.test_write             | Test management (read and write)           |
    | vso.variablegroups_write   | Variable Groups (read, create)             |
    | vso.work_full              | Work items (full)                          |
 
-   Enter the organization name and the Personal Access Token (PAT). Provide the project name and press enter to create a project
-
-> [!div class="mx-imgBorder"]
-> [![Authenticating the app using Personal Access Token(PAT)](../demo-gen/media/103.png "Authenticating the app using Personal Access Token(PAT)")](../demo-gen/media/103.png#lightbox)
+   Enter the organization name and the PAT. Provide the project name and press enter to create a project
 
-#### Select your organization
-
-1. Select the organization you will use to host the project created by the Azure DevOps Demo Generator. (You may have multiple organizations of which you are a member, and which are associated with your login, so choose carefully.) Provide a name for your project (such as "MyProjectDemo" ) that you and other contributors can use to identify it as a demo project. 
+   > [!div class="mx-imgBorder"]
+   > [![Screenshot shows Authenticating the app using Personal Access Token (PAT).](../demo-gen/media/103.png "Authenticating the app using Personal Access Token (PAT)")](../demo-gen/media/103.png#lightbox)
 
-There are several templates available, including **eShopOnWeb**, which defines a team project for an .NET app that deploys to Azure App Service; **PartsUnlimited**, which defines an ASP.NET app with customized CI/CD pipelines; and **MyShuttle**, which defines a Java app and Azure App Service deployment. If you are following a lab from [Azure DevOps Labs](https://www.azuredevopslabs.com), select the **DevOps Labs** section to choose the template
+## Create your demo project
 
-> [!NOTE]
-> All  templates provide fictional Azure DevOps users and pre-populated Agile planning and tracking work items and data, along with source code in an Azure Repos Git repo, as well as access to Azure Pipelines.
+To create your demo project, do the following steps:
 
-Some templates may require additional extensions to be installed to your organization. The demo generation process checks to see if these extensions are already installed. If the extension is **not** installed, provide your consent to install extension by pressing **Y** or **Yes** to install the extension(s) to your account. When ready, press enter to **Create Project**.
+1. Select the organization where you want to host the project created by the Azure DevOps Demo Generator. If you belong to multiple organizations associated with your credentials, choose the appropriate one. 
+2. Enter a project name, such as "MyProjectDemo," that you and other contributors can easily identify as a demo project.
+3. Choose from several available templates, such as:
+   - **eShopOnWeb**: a .NET app that deploys to Azure App Service
+   - **PartsUnlimited**: an ASP.NET app with customized CI/CD pipelines
+   - **MyShuttle**: a Java app with Azure App Service deployment. 
+    If you're following a lab from [Azure DevOps Labs](https://www.azuredevopslabs.com), select the **DevOps Labs** section to choose the relevant template.
 
-> [!NOTE]
-> If you want to manually install the extensions,  click on the provided link for a specific extension, which takes you to the extension's page on Azure DevOps Marketplace. From there, you can install the extension.
+   Use templates that provide fictional Azure DevOps users, prepopulated Agile work items and data, source code in an Azure Repos Git repo, and access to Azure Pipelines.
+4. (Optional) Manually install any required extensions by selecting the provided link for each extension. This link opens the extension's page in the Azure DevOps Marketplace, where you can install it. 
+5. (Optional) Approve the installation of other required extensions when prompted. If the demo generation process detects missing extensions, consent by pressing **Y** or **Yes**, then press **Enter** to create the project.
 
-2. Your project may take a couple of minutes for the Demo Generator to provision. 
+   Your project might take a few minutes for the Demo Generator to create. 
 
-    > [!div class="mx-imgBorder"]
-    > :::image type="content" source="media/104.png" alt-text="Required extensions setup in organization" lightbox="media/104.png":::
+   > [!div class="mx-imgBorder"]
+   > :::image type="content" source="media/104.png" alt-text="Screenshot shows Required extensions setup in organization." lightbox="media/104.png":::
 
-3. You can go to your organization to confirm that the project was created once you see the Project created successfully message.
+6. Go to your organization to confirm that the project was created once the "Project created successfully" message displays.