Merge pull request #100698 from archieag/patch-28

Update AspNet core webapp quickstart steps for ready-to-go downloaded sample

Author: Jak-MS

articles/active-directory/develop/quickstart-v2-aspnet-core-webapp.md

@@ -17,11 +17,7 @@ ms.custom: aaddev, identityplatformtop40
 ---
 
 # Quickstart: Add sign-in with Microsoft to an ASP.NET Core web app
-
-In this quickstart, you'll learn how an ASP.NET Core web app can sign in personal accounts (hotmail.com, outlook.com, others) and work and school accounts from any Azure Active Directory (Azure AD) instance.
-
-![Shows how the sample app generated by this quickstart works](media/quickstart-v2-aspnet-core-webapp/aspnetcorewebapp-intro.svg)
-
+In this quickstart, you use a code sample to learn how an ASP.NET Core web app can sign in personal accounts (hotmail.com, outlook.com, others) and work and school accounts from any Azure Active Directory (Azure AD) instance. (See [How the sample works](#how-the-sample-works) for an illustration.)
 > [!div renderon="docs"]
 > ## Register and download your quickstart app
 > You have two options to start your quickstart application:
@@ -63,22 +59,32 @@ In this quickstart, you'll learn how an ASP.NET Core web app can sign in persona
 
 #### Step 2: Download your ASP.NET Core project
 
-- [Download the Visual Studio 2019 solution](https://github.com/Azure-Samples/active-directory-aspnetcore-webapp-openidconnect-v2/archive/aspnetcore2-2.zip)
-
-#### Step 3: Configure your Visual Studio project
-
-1. Extract the zip file to a local folder within the root folder - for example, **C:\Azure-Samples**
-1. If you use Visual Studio 2019, open the solution in Visual Studio (optional).
-1. Edit the **appsettings.json** file. Find `ClientId` and update the value of `ClientId` with the **Application (client) ID** value of the application you registered. 
+> [!div renderon="docs"]
+> [Download the Visual Studio 2019 solution](https://github.com/Azure-Samples/active-directory-aspnetcore-webapp-openidconnect-v2/archive/aspnetcore2-2.zip)
 
-    ```json
-    "ClientId": "Enter_the_Application_Id_here"
-    "TenantId": "Enter_the_Tenant_Info_Here"
-    ```
+> [!div class="sxs-lookup" renderon="portal"]
+> Run the project using Visual Studio 2019.
+> [!div renderon="portal" id="autoupdate" class="nextstepaction"]
+> [Download the code sample]()
 
+> [!div class="sxs-lookup" renderon="portal"]
+> #### Step 3: Your app is configured and ready to run
+> We have configured your project with values of your app's properties and it's ready to run. 
 > [!div class="sxs-lookup" renderon="portal"]
 > > [!NOTE]
-> > This quickstart supports Enter_the_Supported_Account_Info_Here.
+> > Enter_the_Supported_Account_Info_Here
+> [!div renderon="docs"]
+> #### Step 3: Run your Visual Studio project
+> 1. Extract the zip file to a local folder within the root folder - for example, **C:\Azure-Samples**
+> 1. Open the solution in Visual Studio 
+> 1. Edit the **appsettings.json** file. Find `ClientId` and update the value of `ClientId` with the **Application (client) ID** value of the application you registered. 
+>
+>    ```json
+>    "ClientId": "Enter_the_Application_Id_here"
+>    "TenantId": "Enter_the_Tenant_Info_Here"
+>    ```
+
+
 
 > [!div renderon="docs"]
 > Where:
@@ -95,6 +101,9 @@ In this quickstart, you'll learn how an ASP.NET Core web app can sign in persona
 
 This section gives an overview of the code required to sign in users. This overview can be useful to understand how the code works, main arguments, and also if you want to add sign-in to an existing ASP.NET Core application.
 
+### How the sample works
+![Shows how the sample app generated by this quickstart works](media/quickstart-v2-aspnet-core-webapp/aspnetcorewebapp-intro.svg)
+
 ### Startup class
 
 *Microsoft.AspNetCore.Authentication* middleware uses a Startup class that is executed when the hosting process initializes:
@@ -161,4 +170,4 @@ Check out the GitHub repo for this ASP.NET Core tutorial for more information in
 Help us improve the Microsoft identity platform. Tell us what you think by completing a short two-question survey.
 
 > [!div class="nextstepaction"]
-> [Microsoft identity platform survey](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbRyKrNDMV_xBIiPGgSvnbQZdUQjFIUUFGUE1SMEVFTkdaVU5YT0EyOEtJVi4u)
+> [Microsoft identity platform survey](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbRyKrNDMV_xBIiPGgSvnbQZdUQjFIUUFGUE1SMEVFTkdaVU5YT0EyOEtJVi4u)