"Controller-based API" tutorial expects Swagger, but swagger isn't present by default

[diiq]

Description

One of the very first steps listed in this tutorial is "The Swagger page /swagger/index.html is displayed. Select GET > Try it out > Execute."

But today, the project template uses OpenAPI and not swagger, so the provided URL is a 404, and will only show a blank window without swagger or swashbuckle being installed.

I'm sure this tutorial worked when it was written -- thanks for writing it! -- but without changes it no longer gets new users even as far as successfully demonstrating the initial template, so 90% of it goes to waste.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/tutorials/first-web-api?view=aspnetcore-9.0&tabs=visual-studio-code

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/first-web-api.md

Document ID

95f2549e-29f9-e31a-b4d0-432b971643ff

Article author

@wadepickett

Metadata

• ID: 583ae3e7-5915-f22b-e54c-6c100cf2a7da
• Service: aspnet-core
• Sub-service: tutorials

Related Issues

[wadepickett]

@diiq, you are correct, this tutorial needs an update. Thanks for pointing it out. It is now scheduled for a rewrite/recode.