Swap Swagger UI to more professional Scalar UI docs

[Copilot]

📋 Description

Replaces Swagger UI with Scalar for professional API documentation in Chapter 1. Scalar provides a modern API reference UI with interactive testing capabilities, multi-language code snippets, and full OpenAPI 3.1 support.

Changes

• Added Scalar.AspNetCore (v2.12.17)
• Removed Swashbuckle.AspNetCore (redundant with native OpenAPI)
• Updated Program.cs:

  builder.Services.AddOpenApi();
  // ...
  app.MapOpenApi();
  app.MapScalarApiReference("/docs/{documentName}");

• Updated root redirect: /swagger → /docs/v1
• Updated launchSettings.json to open Scalar docs (/docs/v1) on app start
• Fixed IDE0370 build errors: removed unnecessary null-forgiving operators in architecture and integration tests

📦 PR Includes

• Feature added 🆕
• Bug fix 🐛
• Code refactor 🔄
• Documentation update 📚
• Tests added/updated 🧪
• Other: (describe)

🚫 PR Does Not Include

• Breaking changes ❌
• Major architectural changes 🏗️
• Unrelated features/tasks 🚫

💡 Additional Notes

API documentation now available at /docs/v1 in development mode. Uses native Microsoft.AspNetCore.OpenApi for spec generation. The app will automatically open the Scalar documentation when launched.

Build fixes included: removed unnecessary null-forgiving operators (!) from test files to resolve IDE0370 analyzer errors.

Original prompt

Create app.UseSwaggerUI();
https://scalar.com/products/api-references/integrations/aspnetcore/integration

integrate chapter 1 with scalar. Ensure that in documetation it is updaed and we are using open API. If you can add to description screnshot after and before

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[kamilbaczek]

@copilot use /docs

[kamilbaczek]

@copilot remover screens from repo and .adoc file mention before after. Instead of saying we are leveraging swagger. Describe shortly in docs that we are using professional API documentation thanks to scalar and this to lib list which is also in .adc

[kamilbaczek]

@copilot change mr tilte to Swap Swagger UI to more professional Scalar UI docs

[kamilbaczek]

@copilot change base path to documentation /docs/v1 instead /scalar/v1

[Copilot]

@copilot remover screens from repo and .adoc file mention before after. Instead of saying we are leveraging swagger. Describe shortly in docs that we are using professional API documentation thanks to...

Done in 9b82665. Removed screenshots from repo and simplified the API Documentation section to briefly describe Scalar as professional API documentation with interactive testing and OpenAPI 3.1 support.

@copilot change mr tilte to Swap Swagger UI to more professional Scalar UI docs

I cannot change the PR title directly. Please update it to: "Swap Swagger UI to more professional Scalar UI docs"

[Copilot]

@copilot change base path to documentation /docs/v1 instead /scalar/v1

Done in 240b052. Changed the base path from /scalar/v1 to /docs/v1 in Program.cs, the redirect extension, and README.adoc.

[kamilbaczek]

@copilot ==== API Documentation

For professional API documentation, we use https://scalar.com[Scalar] - a modern API reference UI that provides interactive testing capabilities, multi-language code snippets, and full OpenAPI 3.1 support. The documentation is available at /docs/v1 in development mode.

remove

[Copilot]

@copilot ==== API Documentation

For professional API documentation, we use https://scalar.com[Scalar] - a modern API reference UI that provides interactive testing capabilities, multi-language code...

Done in e272b44. Removed the API Documentation section from README.adoc.

[kamilbaczek]

@copilot adjust lunch settings to app start with scalar

[Copilot]

@copilot adjust lunch settings to app start with scalar

Done in 25376b0. Updated launchSettings.json to change launchUrl from swagger to docs/v1 in all profiles (http, https, and IIS Express). The app will now open the Scalar documentation on start.

[kamilbaczek]

final effect

[kamilbaczek]

@copilot fix
architecture/Src/Fitnet.AppHost/bin/Debug/net10.0/EvolutionaryArchitecture.Fitnet.AppHost.dll
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/BussinessRulesArchitectureTests.cs(21,46): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/ContractsArchitectureTests.cs(27,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/ReportsArchitectureTests.cs(27,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/PassesArchitectureTests.cs(28,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/PassesArchitectureTests.cs(53,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/OffersArchitectureTests.cs(28,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Fitnet.UnitTests -> /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.UnitTests/bin/Debug/net10.0/EvolutionaryArchitecture.Fitnet.UnitTests.dll
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Common/Events/EventBus/InMemory/InMemoryEventBusTests.cs(22,23): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Fitnet.IntegrationTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Common/Events/EventBus/InMemory/InMemoryEventBusTests.cs(30,27): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Fitnet.IntegrationTests.csproj]

Build FAILED.

Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/BussinessRulesArchitectureTests.cs(21,46): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/ContractsArchitectureTests.cs(27,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/ReportsArchitectureTests.cs(27,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/PassesArchitectureTests.cs(28,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/PassesArchitectureTests.cs(53,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/OffersArchitectureTests.cs(28,37): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.ArchitectureTests/Fitnet.ArchitectureTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Common/Events/EventBus/InMemory/InMemoryEventBusTests.cs(22,23): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Fitnet.IntegrationTests.csproj]
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Common/Events/EventBus/InMemory/InMemoryEventBusTests.cs(30,27): error IDE0370: Suppression is unnecessary (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/style-rules/ide0370) [/home/runner/work/evolutionary-architecture-by-example/evolutionary-architecture-by-example/Chapter-1-initial-architecture/Src/Fitnet.IntegrationTests/Fitnet.IntegrationTests.csproj]

[Copilot]

@copilot fix
architecture/Src/Fitnet.AppHost/bin/Debug/net10.0/EvolutionaryArchitecture.Fitnet.AppHost.dll
Error: /home/runner/work/evolutionary-architecture-by-example/evolutionary-...

Fixed in fa4eab9. Removed unnecessary null-forgiving operators (!) from 6 files:

• BussinessRulesArchitectureTests.cs
• ContractsArchitectureTests.cs
• ReportsArchitectureTests.cs
• PassesArchitectureTests.cs
• OffersArchitectureTests.cs
• InMemoryEventBusTests.cs

Build now succeeds with 0 errors.