Merge pull request #35622 from dotnet/main

Author: guardrex

aspnetcore/blazor/security/blazor-web-app-with-entra.md

@@ -43,6 +43,8 @@ The sample solution consists of the following projects:
 
 Access the sample through the latest version folder in the Blazor samples repository with the following link. The sample is in the `BlazorWebAppEntra` folder for .NET 9 or later.
 
+Start the solution from the ***`Aspire/Aspire.AppHost` project***.
+
 [View or download sample code](https://github.com/dotnet/blazor-samples) ([how to download](xref:blazor/fundamentals/index#sample-apps))
 
 ## Microsoft Entra ID app registrations

aspnetcore/blazor/security/blazor-web-app-with-oidc.md

@@ -45,6 +45,8 @@ The sample app consists of the following projects:
 
 Access the sample through the latest version folder in the Blazor samples repository with the following link. The sample is in the `BlazorWebAppOidc` folder for .NET 8 or later.
 
+Start the solution from the ***`Aspire/Aspire.AppHost` project***.
+
 [View or download sample code](https://github.com/dotnet/blazor-samples) ([how to download](xref:blazor/fundamentals/index#sample-apps))
 
 Sample solution features:

aspnetcore/blazor/security/includes/troubleshoot-server.md

@@ -103,9 +103,16 @@ A functioning app may fail immediately after upgrading either the .NET Core SDK
 > [!NOTE]
 > Use of package versions incompatible with the app's target framework isn't supported. For information on a package, use the [NuGet Gallery](https://www.nuget.org).
 
-### Run the server app
+### Start the solution from the correct project
 
-When testing and troubleshooting Blazor Web App, make sure that you're running the app from the server project.
+Blazor Web Apps:
+
+* For one of the Backend-for-Frontend (BFF) pattern samples, start the solution from the ***`Aspire/Aspire.AppHost` project***.
+* For one of the non-BFF pattern samples, start the solution from the ***server project***.
+
+Blazor Server:
+
+Start the solution from the ***server project***.
 
 ### Inspect the user
 

aspnetcore/fundamentals/servers/yarp/lets-encrypt.md

@@ -3,27 +3,33 @@ uid: fundamentals/servers/yarp/lets-encrypt
 title: YARP Lets Encrypt
 description: YARP Lets Encrypt
 author: samsp-msft
+monikerRange: '<= aspnetcore-7.0'
 ms.author: samsp
-ms.date: 2/6/2025
+ms.date: 6/13/2025
 ms.topic: article
 content_well_notification: AI-contribution
 ai-usage: ai-assisted
 ---
-
 # YARP Lets Encrypt
 
+> [!NOTE]
+> The [`LettuceEncrypt` NuGet package](https://github.com/natemcmaster/LettuceEncrypt) described in this article is archived and no longer supported, so the package isn't recommended for use.
+
 ## Introduction
-YARP can support the certificate authority [Lets Encrypt](https://letsencrypt.org/) by using the API of another ASP.NET Core project [LettuceEncrypt](https://github.com/natemcmaster/LettuceEncrypt). It allows you to set up TLS between the client and YARP with minimal configuration.
+
+YARP can support the certificate authority [Lets Encrypt](https://letsencrypt.org/) by using the API of another ASP.NET Core project, [`LettuceEncrypt`](https://github.com/natemcmaster/LettuceEncrypt). It allows you to set up TLS between the client and YARP with minimal configuration.
 
 ## Requirements
 
-Add the LettuceEncrypt package dependency:
+Add the `LettuceEncrypt` package dependency:
+
 ```csproj
 <PackageReference Include="LettuceEncrypt" Version="1.1.2" />
 ```
 
 ## Configuration
-There are required options for LettuceEncrypt that should be set, see the example of `appsettings.json`:
+
+There are required options for `LettuceEncrypt` that should be set. See the example of `appsettings.json`:
 
 ```json
 {
@@ -37,8 +43,10 @@ There are required options for LettuceEncrypt that should be set, see the exampl
   },
 
   "LettuceEncrypt": {
-    // Set this to automatically accept the terms of service of your certificate authority.
-    // If you don't set this in config, you will need to press "y" whenever the application starts
+    // Set this to automatically accept the terms of service of your certificate 
+    // authority.
+    // If you don't set this in config, you will need to press "y" whenever the 
+    // application starts
     "AcceptTermsOfService": true,
 
     // You must specify at least one domain name
@@ -56,16 +64,17 @@ There are required options for LettuceEncrypt that should be set, see the exampl
 services.AddLettuceEncrypt();
 ```
 
-For more options (i.e. saving certificates) see examples in [LettuceEncrypt doc](https://github.com/natemcmaster/LettuceEncrypt).
+For more options (for example, saving certificates) see the examples in the [`LettuceEncrypt` project README](https://github.com/natemcmaster/LettuceEncrypt).
 
 ## Kestrel Endpoints
 
-If your project is explicitly using kestrel options to configure IP addresses, ports, or HTTPS settings, you will also need to call `UseLettuceEncrypt`.
+If your project is explicitly using Kestrel options to configure IP addresses, ports, or HTTPS settings, call `UseLettuceEncrypt`:
 
 Example:
 
 ```csharp
 var builder = WebApplication.CreateBuilder(args);
+
 builder.WebHost.ConfigureKestrel(kestrel =>
 {
     kestrel.ListenAnyIP(443, portOptions =>
@@ -77,4 +86,3 @@ builder.WebHost.ConfigureKestrel(kestrel =>
     });
 });
 ```
-