Merge pull request #10447 from MicrosoftDocs/main638647238567332570sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

bridge/articles/bridge-to-kubernetes-vs-code.md

@@ -201,8 +201,6 @@ Learn more about Bridge to Kubernetes at [How Bridge to Kubernetes works][btk-ho
 
 If you need to debug multiple services at the same time in parallel, see [Debug multiple services at the same time](parallel-services.md).
 
-Information about the currently supported features and a future roadmap for Bridge to Kubernetes may be found at [Bridge to Kubernetes roadmap](https://github.com/microsoft/mindaro/projects/1).
-
 [azure-kubernetes-service]: /azure/aks/kubernetes-walkthrough
 [azds-cli]: /azure/dev-spaces/how-to/install-dev-spaces#install-the-client-side-tools
 [azds-tmp-dir]: /azure/dev-spaces/troubleshooting#before-you-begin

bridge/articles/bridge-to-kubernetes-vs.md

@@ -186,8 +186,6 @@ If you cloned that repo locally, you can delete it manually.
 
 Learn more about Bridge to Kubernetes at [How Bridge to Kubernetes works](overview-bridge-to-kubernetes.md).
 
-For information about supported features and a roadmap for Bridge to Kubernetes, see [Bridge to Kubernetes roadmap](https://github.com/microsoft/mindaro/projects/1).
-
 To learn how to connect your development computer to a cluster by using Visual Studio Code, check out this article:
 > [!div class="nextstepaction"]
 > [Use Bridge to Kubernetes (VS Code)](bridge-to-kubernetes-vs-code.md)

docs/get-started/csharp/media/vs-2022/aspnet-core-enable-container-window.png

@@ -6,11 +6,11 @@ ms.author: meghaanand
 manager: mijacobs
 ms.subservice: general-ide
 ms.topic: tutorial
-ms.date: 11/17/2023
-
+ms.date: 10/17/2024
 dev_langs:
   - CSharp
 ms.devlang: csharp
+#customer intent: As a developer, I want to create a ASP.NET Core web application with C# in Visual Studio.
 ---
 # Tutorial: Get started with C# and ASP.NET Core in Visual Studio
 
@@ -28,11 +28,10 @@ This tutorial shows you how to:
 
 ## Prerequisites
 
-You need Visual Studio to complete this tutorial. Visit the [Visual Studio downloads page](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-tutorial-create-csharp-aspnetcore-web-app-page-cta) for a free version.
-
-- For more information about upgrading to the latest Visual Studio release, see [Visual Studio updates](../../install/update-visual-studio.md).
+To complete this tutorial, you need:
 
-- To customize your Visual Studio experience, see [personalize the Visual Studio IDE and Editor](../../ide/personalizing-the-visual-studio-ide.md).
+- Visual Studio installed. Visit the [Visual Studio downloads page](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-tutorial-create-csharp-aspnetcore-web-app-page-cta) for a free version. For more information about upgrading to the latest Visual Studio release, see [Visual Studio updates](../../install/update-visual-studio.md).
+- The **ASP.NET and web development** workload installed. To verify or install this workload in Visual Studio, select **Tools** > **Get Tools and Features**. For more information, see [Change workloads or individual components](../../install/modify-visual-studio.md#change-workloads-or-individual-components).
 
 ## Create a project
 
@@ -50,21 +49,6 @@ First, you create an ASP.NET Core project. The project type comes with all the t
 
    :::image type="content" source="./media/vs-2019/csharp-create-new-project-aspnet-core.png" alt-text="Screenshot that shows the ASP.NET Core Web App project template highlighted in the New Project dialog box in Visual Studio." lightbox="./media/vs-2019/csharp-create-new-project-aspnet-core.png":::
 
-   > [!NOTE]
-   > If you don't see the **ASP.NET Core Web App** template, you can install it from the **Create a new project** window.
-   > 
-   > In the **Not finding what you're looking for?** message at the bottom of the list of templates, select the **Install more tools and features** link.
-   >
-   > ![Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.](../../get-started/media/vs-2019/not-finding-what-looking-for.png)
-   >
-   > In the Visual Studio Installer, select **ASP.NET and web development**.
-   >
-   > ![Screenshot shows the dot NET Core cross-platform development workload in the Visual Studio Installer.](../../get-started/media/aspnet-core-web-dev-workload.png)
-   >
-   > Select **Modify** in the Visual Studio Installer. You might be prompted to save your work. Select **Continue** to install the workload.
-   >
-   > Return to step 2 in this "[Create a project](#create-a-project)" procedure.
-
 1. In the **Configure your new project** window, enter **MyCoreApp** in the **Project name** field. Then, select **Next**.
 
    :::image type="content" source="./media/vs-2019/csharp-name-your-aspnet-app.png" alt-text="Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field." lightbox="./media/vs-2019/csharp-name-your-aspnet-app.png":::
@@ -94,43 +78,28 @@ Visual Studio opens your new project.
 
    :::image type="content" source="media/vs-2022/start-window-create-new-project.png" border="false" alt-text="Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.":::
 
-1. In the **Create a new project** window, select **C#** from the Language list. Next, select **Windows** from the platform list, and **Web** from the project types list.
+1. In the **Create a new project** window, select **C#** from the Language list. Next, select **Windows** from the **All platforms** list, and **Web** from the **All project types** list.
 
-   After you apply the language, platform, and project type filters, select the **ASP.NET Core Web App** template, and then select **Next**.
+   After you apply the language, platform, and project type filters, select the **ASP.NET Core Web App (Razor Pages)** template, and then select **Next**.
 
    :::image type="content" source="media/vs-2022/csharp-create-new-project-aspnet-core.png" border="false" alt-text="Screenshot that shows the ASP.NET Core Web App project template selected and highlighted on the Create a new project page." lightbox="media/vs-2022/csharp-create-new-project-aspnet-core.png":::
 
-   > [!NOTE]
-   > If you don't see the **ASP.NET Core Web App** template, you can install it from the **Create a new project** window.
-   > 
-   > In the **Not finding what you're looking for?** message at the bottom of the list of templates, select the **Install more tools and features** link.
-   >
-   > :::image type="content" source="media/vs-2022/not-finding-what-looking-for.png" alt-text="Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.":::
-   >
-   > In the Visual Studio Installer, select the **ASP.NET and web development** workload.
-   >
-   > :::image type="content" source="media/vs-2022/aspnet-core-web-dev-workload.png" alt-text="Screenshot shows the ASP.NET and web development workload in the Visual Studio Installer.":::
-   >
-   > Select **Modify** in the Visual Studio Installer. You might be prompted to save your work. Select **Continue** to install the workload.
-   > 
-   > Return to step 2 in this "[Create a project](#create-a-project)" procedure.
-
 1. In the **Configure your new project** window, enter **MyCoreApp** in the **Project name** field. Then, select **Next**.
 
    :::image type="content" source="media/vs-2022/csharp-name-your-aspnet-app.png" border="false" alt-text="Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field." lightbox="media/vs-2022/csharp-name-your-aspnet-app.png":::
 
 1. In the **Additional information** window, verify that **.NET 8.0** appears in the **Target Framework** field.
 
-   From this window, you can enable Docker support and add authentication support. The drop-down menu for **Authentication Type** has the following four options:
+   From this window, you can enable container support and add authentication support. The drop-down menu for **Authentication Type** has the following four options:
 
    - **None**: No authentication.
    - **Individual accounts**: These authentications are stored in a local or Azure-based database.
    - **Microsoft identity platform**: This option uses Microsoft Entra ID or Microsoft 365 for authentication.
    - **Windows**: Suitable for intranet applications.
 
-   Leave the **Enable Docker** box unchecked, and select **None** for Authentication Type.
+   Leave the **Enable container support** box unchecked, and select **None** for Authentication Type.
 
-   :::image type="content" source="media/vs-2022/aspnet-core-additional-information.png" border="false" alt-text="Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET 8.0." lightbox="media/vs-2022/aspnet-core-additional-information.png":::
+   :::image type="content" source="media/vs-2022/aspnet-core-enable-container-window.png" border="false" alt-text="Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET 8.0." lightbox="media/vs-2022/aspnet-core-additional-information.png":::
 
 1. Select **Create**.
 
@@ -309,14 +278,13 @@ This solution follows the **Razor Page** design pattern. It's different than the
 
 ## Run, debug, and make changes
 
-1. In the toolbar, select the **IIS Express** button to build and run the app in debug mode. Alternatively, press **F5**, or go to **Debug** > **Start Debugging** from the menu bar.
+1. In the toolbar, select the **https** button to build and run the app in debug mode. Alternatively, press **F5**, or go to **Debug** > **Start Debugging** from the menu bar.
 
-   :::image type="content" source="media/vs-2022/csharp-aspnet-razor-iis-express.png" alt-text="Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.":::
+   :::image type="content" source="media/vs-2022/aspnet-core-https-build-run.png" alt-text="Screenshot shows the https button highlighted in the toolbar in Visual Studio.":::
 
    > [!NOTE]
-   > If you get an error message that says **Unable to connect to web server 'IIS Express'**, close Visual Studio and then relaunch the program as an administrator. You can do this task by right-clicking the Visual Studio icon from the Start Menu, and then selecting the **Run as administrator** option from the context menu.
-   >
-   > You might also get a message that asks if you want to accept an IIS SSL Express certificate. To view the code in a web browser, select **Yes**, and then select **Yes** if you receive a follow-up security warning message.
+   > You might also get a message that asks if you want to accept an ASP.NET Core SSL certificate. To view the code in a web browser, select **Yes**, and then select **Yes** if you receive a follow-up security warning message.
+   > Learn more about [enforcing SSL in ASP.NET Core](/aspnet/core/security/enforcing-ssl).
 
 1. Visual Studio launches a browser window. You should then see **Home** and **Privacy** pages in the menu bar.
 
@@ -347,7 +315,7 @@ This solution follows the **Razor Page** design pattern. It's different than the
    - The first argument for the method specifies how the date should be displayed. This example uses the format specifier (`d`) which indicates the short date format.
    - The second argument is the [CultureInfo](/dotnet/api/system.globalization.cultureinfo) object that specifies the culture or region for the date. The second argument determines, among other things, the language of any words in the date, and the type of separators used.
 
-   Change the body of the `OnGet()` method to the following code:
+   Change the body of the `OnGet()` method in **Privacy.cshtml.cs** to the following code:
 
    ```csharp
    public void OnGet()
@@ -391,9 +359,9 @@ This solution follows the **Razor Page** design pattern. It's different than the
 
    :::image type="content" source="media/vs-2022/csharp-aspnet-index-cshtml-page-hello-world.png" alt-text="Screenshot shows the Index.cshtml file in the Visual Studio Code editor with the 'Welcome' text changed to 'Hello World!'.":::
 
-1. Select **IIS Express** or press **Ctrl**+**F5** to run the app and open it in a web browser.
+1. Select **https** or press **Ctrl**+**F5** to run the app and open it in a web browser.
 
-   :::image type="content" source="media/vs-2022/csharp-aspnet-generic-iis-button.png" alt-text="Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.":::
+   :::image type="content" source="media/vs-2022/csharp-aspnet-core-https-button.png" alt-text="Screenshot shows the https button highlighted in the toolbar for Visual Studio.":::
 
 1. In the web browser, you see your new changes on the **Home** page.
 
@@ -415,6 +383,7 @@ Or, learn how to containerize your web app with Docker:
 > [!div class="nextstepaction"]
 > [Container Tools in Visual Studio](../../containers/overview.md)
 
-## See also
+## Related links
 
-[Publish your web app to Azure App Service by using Visual Studio](../../deployment/quickstart-deploy-aspnet-web-app.md)
+- [Publish your web app to Azure App Service by using Visual Studio](../../deployment/quickstart-deploy-aspnet-web-app.md)
+- [Personalize the Visual Studio IDE and Editor](../../ide/personalizing-the-visual-studio-ide.md)

docs/get-started/csharp/media/vs-2022/aspnet-core-https-build-run.png

@@ -58,14 +58,32 @@ devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig Pr
 
 - If you get an error message that says **Invalid project configuration**, make sure that you've specified a solution platform or project platform (for example, `Debug|Win32`).
 
-## Example
+## Examples
 
 The following command builds the project `CSharpWinApp`, using the `Debug` project build configuration within `MySolution`.
 
 ```shell
 devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug
 ```
 
+And to clean up all the build files:
+
+```shell
+devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean
+```
+
+## Build a setup project
+
+To build an installer (`.msi` file), you need a [setup project](../../deployment/installer-projects-net-core.md), which has a `.vdproj` project file, but to build it you first need to apply a workaround that sets a particular registry key. From the Visual Studio Developer command prompt, run the executable *DisableOutOfProcBuild.exe* from the folder *Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild*. Without this workaround, you may get the error: `ERROR: An error occurred while validating.  HRESULT = '8000000A'`. The command affects the current user, so for build agent scenarios, be sure to run it from the same account that runs the build. For more information, see the *README.txt* file in the same folder.
+
+Also, in Visual Studio, you can create a new [configuration](../../ide/understanding-build-configurations.md), say `Setup`, based on the `Release` configuration, and select the setup project as a project to build. By default, setup projects aren't included in the default configurations, `Debug` and `Release`. With the `Setup` configuration defined, the following commands build a project `WindowsFormsApp1` and its associated setup project to generate the `.msi` file:
+
+```shell
+devenv WindowsFormsApp1.sln /build Setup
+```
+
+If the solution was already built with the **Release** configuration, this command just builds the setup project.
+
 ## See also
 
 - [Build and clean projects and solutions](../../ide/building-and-cleaning-projects-and-solutions-in-visual-studio.md)

docs/get-started/csharp/media/vs-2022/aspnet-core-run-iis-express.png

@@ -29,7 +29,7 @@ Not only can you add both [GitHub and GitHub Enterprise accounts to your keychai
 
 :::image type="content" source="media/vs-2022/git-source-control-create-repository.png" alt-text="Screenshot of the Create a Git Repository dialog box in Visual Studio." lightbox="media/vs-2022/git-source-control-create-repository.png":::
 
-If you want to use git commands at the command line, you should also install [Git for Windows](https://book.git-scm.com/download/win) (not a Microsoft product).
+If you want to use git commands at the command line, you should also install [Git for Windows](https://git-scm.com/downloads/win) (not a Microsoft product).
 
 ## View files in Solution Explorer