feat(templates): improve bit Boilerplate scalar integration #11582 (#11583)

Author: ysmoradi

src/Templates/Boilerplate/Bit.Boilerplate/.docs/09- Dependency Injection & Service Registration.md

@@ -97,7 +97,7 @@ Each layer adds services specific to its scope, ensuring proper service availabi
 ### Registration Flow Example (Server API):
 
 1. **`Program.cs`** calls `AddServerApiProjectServices()`
-2. **`AddServerApiProjectServices()`** internally calls helper methods like `AddIdentity()`, `AddSwaggerGen()`
+2. **`AddServerApiProjectServices()`** internally calls helper methods like `AddIdentity()`
 3. Each helper method registers related services (e.g., Identity services, JWT authentication, external auth providers)
 
 ## Service Availability Matrix

src/Templates/Boilerplate/Bit.Boilerplate/.docs/12- Blazor Modes, PreRendering & PWA.md

@@ -350,16 +350,7 @@ self.serverHandledUrls = [
     /\/odata\//,
     /\/core\//,
     /\/hangfire/,
-    /\/healthchecks-ui/,
-    /\/healthz/,
-    /\/health/,
-    /\/alive/,
-    /\/swagger/,
-    /\/signin-/,
-    /\/.well-known/,
-    /\/sitemap.xml/,
-    /\/sitemap_index.xml/,
-    /\/web-interop-app.html/
+    ...
 ];
 ```
 

src/Templates/Boilerplate/Bit.Boilerplate/src/Server/Boilerplate.Server.Api/Program.Middlewares.cs

@@ -55,8 +55,8 @@ private static void ConfigureMiddlewares(this WebApplication app)
 
         app.MapAppHealthChecks();
 
-        app.MapOpenApi();
-        app.MapScalarApiReference();
+        app.MapOpenApi().CacheOutput("AppResponseCachePolicy");
+        app.MapScalarApiReference().CacheOutput("AppResponseCachePolicy");
         app.MapGet("/", () => Results.Redirect("/scalar")).ExcludeFromDescription();
         app.MapGet("/swagger", () => Results.Redirect("/scalar")).ExcludeFromDescription();
 
@@ -70,7 +70,7 @@ private static void ConfigureMiddlewares(this WebApplication app)
         {
             RouteParameter = routeParameter,
             QueryStringParameter = queryStringParameter
-        }).WithTags("Test").CacheOutput("AppResponseCachePolicy");
+        }).WithTags("Test").CacheOutput("AppResponseCachePolicy").ExcludeFromDescription();
 
         //#if (signalR == true)
         app.MapHub<SignalR.AppHub>("/app-hub", options => options.AllowStatefulReconnects = true);

src/Templates/Boilerplate/Bit.Boilerplate/src/Server/Boilerplate.Server.Web/Program.Middlewares.cs

@@ -114,8 +114,8 @@ public static void ConfigureMiddlewares(this WebApplication app)
         app.MapAppHealthChecks();
 
         //#if (api == "Integrated")
-        app.MapOpenApi();
-        app.MapScalarApiReference();
+        app.MapOpenApi().CacheOutput("AppResponseCachePolicy");
+        app.MapScalarApiReference().CacheOutput("AppResponseCachePolicy");
         app.MapGet("/swagger", () => Results.Redirect("/scalar")).ExcludeFromDescription();
 
         app.UseHangfireDashboard(options: new()
@@ -128,7 +128,7 @@ public static void ConfigureMiddlewares(this WebApplication app)
         {
             RouteParameter = routeParameter,
             QueryStringParameter = queryStringParameter
-        }).WithTags("Test").CacheOutput("AppResponseCachePolicy");
+        }).WithTags("Test").CacheOutput("AppResponseCachePolicy").ExcludeFromDescription();
 
         //#if (signalR == true)
         if (string.IsNullOrEmpty(configuration["Azure:SignalR:ConnectionString"]) is false