Skip to content

Min Web API tutorial rewrite plus app samples updates v10#37294

Draft
wadepickett wants to merge 17 commits into
mainfrom
wadepickett/37018MinWebAPIupdateTry4
Draft

Min Web API tutorial rewrite plus app samples updates v10#37294
wadepickett wants to merge 17 commits into
mainfrom
wadepickett/37018MinWebAPIupdateTry4

Conversation

@wadepickett

@wadepickett wadepickett commented Jun 25, 2026

Copy link
Copy Markdown
Contributor
  1. Rewrite the Minimal Web API tutorial to:

    • Start with the template set to provide OpenAPI support. rather then an empty project
    • Use OpenAPI for the VS Code with only using the NSwag package's Swagger UI to read the OpenAPI document.
  2. Updates 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.


Internal previews

📄 File 🔗 Preview link
aspnetcore/tutorials/min-web-api.md Tutorial: Create a Minimal API with ASP.NET Core

@wadepickett wadepickett self-assigned this Jun 25, 2026

@mikekistler mikekistler left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. 👍

I left a few nit-picky comments, but one bigger concern is using NSwag. I think I'd prefer that we use either SwagggerUI from Swashbuckle or Scalar, since those are the ones we describe elsewhere in the docs.

Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
Comment thread aspnetcore/tutorials/min-web-api.md Outdated
@wadepickett

Copy link
Copy Markdown
Contributor Author

OK thanks! It was using Swagger UI, but you are right, it was coming from the Nswag package. I will change it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants