Description
Rewrite the Minimal Web API tutorial to:
-
Change the starting point from an empty project to the OpenAPI-enabled Web API template where most developers would start. Visual Studio now uses the ASP.NET Core Web API project type (with "Enable OpenAPI support" checked and "Use controllers" unchecked); the CLI switches from dotnet new web to dotnet new webapi.
-
Replace the old Swagger/NSwag testing approach with the built-in OpenAPI document generator (AddOpenApi() / MapOpenApi()), and uses Scalar (Scalar.AspNetCore) as the browser UI for VS Code instead of NSwag's Swagger UI. Visual Studio continues to use Endpoints Explorer + .http files.
-
Update all 8 app samples used by this tutorial for .NET 10 using the ASP.NET Core Web API (webapi for CLI) template.
After this PR is completed/merged:
Update in a new PR refer to final complete app version VS (using .http testing files) and VS Code (using Swagger UI)version on the AspNetCore.docs.samples repo which can be run in Codespaces
Page URL
https://learn.microsoft.com/en-us/aspnet/core/tutorials/min-web-api?view=aspnetcore-10.0&tabs=visual-studio
Content source URL
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/min-web-api.md
Document ID
ab408035-6313-a183-9940-32de00e0e977
Platform Id
bb56f646-dd6c-15ea-7789-1492b2e548e8
Article author
@wadepickett
Metadata
- ID: ab408035-6313-a183-9940-32de00e0e977
- PlatformId: bb56f646-dd6c-15ea-7789-1492b2e548e8
- Service: aspnet-core
- Sub-service: tutorials
Related Issues
Associated WorkItem - 593687
Description
Rewrite the Minimal Web API tutorial to:
Change the starting point from an empty project to the OpenAPI-enabled Web API template where most developers would start. Visual Studio now uses the ASP.NET Core Web API project type (with "Enable OpenAPI support" checked and "Use controllers" unchecked); the CLI switches from dotnet new web to dotnet new webapi.
Replace the old Swagger/NSwag testing approach with the built-in OpenAPI document generator (AddOpenApi() / MapOpenApi()), and uses Scalar (Scalar.AspNetCore) as the browser UI for VS Code instead of NSwag's Swagger UI. Visual Studio continues to use Endpoints Explorer + .http files.
Update all 8 app samples used by this tutorial for .NET 10 using the ASP.NET Core Web API (webapi for CLI) template.
After this PR is completed/merged:
Update in a new PR refer to final complete app version VS (using .http testing files) and VS Code (using Swagger UI)version on the AspNetCore.docs.samples repo which can be run in Codespaces
Page URL
https://learn.microsoft.com/en-us/aspnet/core/tutorials/min-web-api?view=aspnetcore-10.0&tabs=visual-studio
Content source URL
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/min-web-api.md
Document ID
ab408035-6313-a183-9940-32de00e0e977
Platform Id
bb56f646-dd6c-15ea-7789-1492b2e548e8
Article author
@wadepickett
Metadata
Related Issues
Associated WorkItem - 593687