Merged main into live

Author: mijacobs

docs/ide/customizing-the-start-page-for-visual-studio.md

@@ -1,7 +1,7 @@
 ---
 title: Change the startup experience
 description: Customize your startup experience so Visual Studio opens with the tools that are most useful to you, such as opening the most recently opened solution. 
-ms.date: 06/05/2023
+ms.date: 10/25/2024
 ms.topic: conceptual
 f1_keywords:
 - vs.ToolsOptionsPages.Startup
@@ -34,8 +34,11 @@ You can customize the startup experience for Visual Studio in several different
 
 1. On the menu bar, select **Tools** > **Options**.
 
-2. Expand **Environment**, and then select **General**.
+1. Expand **Environment**, and then select **General**.
+
+1. In the **On startup, open** list, select what you want to happen after Visual Studio launches. You can choose from **Start window** (where you can open a new or existing project), **Most recent solution**, or **Empty environment**.
+
+   :::image type="content" source="media/vs-2022/environment-startup-experience.png" alt-text="Screenshot of the options to customize the startup experience in Visual Studio.":::
 
-3. In the **On startup, open** list, select what you want to happen after Visual Studio launches. You can choose from **Start window** (where you can open a new or existing project), **Most recent solution**, or **Empty environment**.
 
 ::: moniker-end

docs/ide/how-to-add-app-config-file.md

@@ -1,7 +1,7 @@
 ---
 title: Add an app.config file to a project
 description: Learn how to add an app.config file to a C# project so you can customize how the common language runtime locates and loads assembly files.
-ms.date: 03/29/2024
+ms.date: 10/25/2024
 ms.topic: how-to
 dev_langs:
 - CSharp
@@ -26,13 +26,17 @@ To add an application configuration file to a C# project:
 
      The **Add New Item** dialog box appears.
 
-1. Expand **Installed** > **Visual C# Items**.
+1. Expand **Installed** > **C# Items**.
 
 1. In the middle pane, select the **Application Configuration File** template.
 
+     :::image type="content" source="media/vs-2022/application-configuration-file.png" alt-text="Screenshot of the Application Configuration File item in the Add New Item dialog.":::
+
 1. Select the **Add** button.
 
      A file named *App.config* is added to your project.
+    
+     :::image type="content" source="media/vs-2022/app-config-file-csharp-project.png" alt-text="Screenshot of the App dot config file added to your project.":::
 
 For more information about application configuration files or about assemblies in .NET, see [How the runtime locates assemblies (.NET Framework)](/dotnet/framework/deployment/how-the-runtime-locates-assemblies) and [Assemblies in .NET](/dotnet/standard/assembly/).
 

docs/ide/how-to-set-multiple-startup-projects.md

@@ -1,7 +1,7 @@
 ---
 title: 'Set multiple startup projects'
-description: Discover the Visual Studio process that allows you to specify how more than one project is run when you start the debugger.
-ms.date: 11/01/2023
+description: Discover the Visual Studio process that allows you to specify how more than one project is run when you start the debugger, and create launch profiles you can share with others.
+ms.date: 10/21/2024
 ms.topic: how-to
 helpviewer_keywords:
 - startup projects, setting multiple startup projects
@@ -28,6 +28,78 @@ Some project templates include multiple projects that are already configured to
 
 4. Choose the **Multiple Startup Projects** option and set the appropriate actions.
 
+## Multi-project launch profiles
+
+You can set up and save profiles for launching specific projects within a multi-project solution in predefined states for debugging. This simplifies the process of working with complex solutions, improves debugging efficiency, and enables easy sharing of configurations among team members.
+
+### Enable multi-project launch profile
+
+Multi-project launch profiles are available in Visual Studio 2022 17.11 and later. To enable or disable the **Multi-project Launch Profiles** feature, go to **Tools > Options > Preview Features** and toggle the checkbox for **Enable Multi Launch Profiles**.
+
+:::image type="content" source="media/launch-multiple-projects/tools-options-enable-multi-project-launch.png" alt-text="Screenshot showing the option to enable Multi-project Launch Profiles in the Tools Options dialog." border="true":::
+
+### Create a multi-project launch profile
+
+1. Open your Visual Studio solution that contains multiple projects.
+1. In Solution Explorer, right-click on your solution, and select **Configure Startup Projects...**.
+
+   You can also press **Ctrl**+**Q** (Quick Launch) and search for "Configure startup projects" in Feature Search.
+
+   :::image type="content" source="media/launch-multiple-projects/quick-launch-configure-startup-projects.png" alt-text="Screenshot showing searching for configure startup projects in Feature Search." border="true" :::
+
+   The **Solution Property Pages** dialog appears.
+
+1. In the Solution Property Pages, click on the **Common Properties** tab, and select **Configure Startup Projects**.
+1. In the **Configure Startup Projects** section, choose the **Multiple startup projects** radio button.
+
+     :::image type="content" source="media/launch-multiple-projects/solution-property-pages.jpg" alt-text="Screenshot showing the Multiple startup projects radio button." border="true" lightbox="media/launch-multiple-projects/solution-property-pages.jpg":::
+
+   Below the radio button, you'll see a list of all the projects in your solution, and whether they are set to be launched or not when you press **F5**, and whether each project is started under the debugger or without debugging.
+
+   You can use the up and down arrows to control the order in which projects will be launched.
+
+1. Set the action for each project to either **Start**, **Start without debugging**, or **None**, and select a debug target depending on your requirements.
+
+   ![Screenshot showing the options for starting a project.](media/launch-multiple-projects/launch-profiles-start-options.png)
+
+1. Enable the **Share Profile** checkbox if you want to share the profile with other Visual Studio users by checking it into the configuration file in the Source Control repo.
+   Launch profiles are saved to a JSON file with the extension `.slnLaunch` in the same directory as the solution. The **Share Profile** checkbox determines whether the profile is saved to a user-specific file (unchecked) or to a file intended for source control tracking, such as in Git (checked).
+
+   :::image type="content" source="media/launch-multiple-projects/share-profile.png" alt-text="Screenshot that shows the Share Profile checkbox on the Solution Property pages dialog." border="true":::
+
+   Here's an example of the profile in the `.slnLaunch` file:
+
+   ```json
+   [
+      {
+         "Name": "Feature Profile",
+         "Projects": [
+            {
+            "Path": "src\\OrchardCore.Cms.Web\\OrchardCore.Cms.Web.csproj",
+            "Action": "Start"
+            },
+            {
+            "Path": "src\\OrchardCore\\OrchardCore.DisplayManagement\\OrchardCore.DisplayManagement.csproj",
+            "Action": "Start"
+            },
+            {
+            "Path": "src\\OrchardCore\\OrchardCore.Data\\OrchardCore.Data.csproj",
+            "Action": "StartWithoutDebugging"
+            },
+            {
+            "Path": "src\\OrchardCore\\OrchardCore.ContentManagement.Display\\OrchardCore.ContentManagement.Display.csproj",
+            "Action": "Start"
+            }
+         ]
+      }
+   ]
+   ```
+
+1. Once you've configured the startup action for each project, click the **OK** or **Apply** button to save the profile.
+   The created launch profile appears in the toolbar dropdown list, allowing you to select the profile you want to debug.
+
+   :::image type="content" source="media/launch-multiple-projects/profile-in-toolbar.png" alt-text="Screenshot showing launch profile in toolbar.":::
+
 ## With Docker Compose
 
 When you're using Docker Compose to launch containerized projects on a local machine, you use a different method (launch profiles) to start multiple projects.