Description

The ASP.NET 8 tutorial has a notice that reads:

Swashbuckle is not available in .NET 9 or later. For an alternative, see Overview of OpenAPI support in ASP.NET Core API apps.

The wording reads as if the Swashbuckle package cannot be used on .NET 9+, which is not accurate. The intent appears to be that Swashbuckle is no longer part of the official templates and isn’t covered by the .NET 9+ docs track, which now focuses on the built-in Microsoft.AspNetCore.OpenApi. This is explained on the .NET 9 OpenAPI overview, but the tutorial banner doesn’t say this and can mislead readers who land directly on the page via search.

In my opinion, the tutorial should clearly state that:

1. In .NET 9 and later, Microsoft’s official templates and docs use Microsoft.AspNetCore.OpenApi for built-in OpenAPI generation.
2. Swashbuckle remains a community package that can be added manually if desired, but it isn’t part of the default template or the .NET 9+ documentation track.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-8.0&utm_source=chatgpt.com&tabs=visual-studio

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/getting-started-with-swashbuckle.md

Document ID

59222460-a971-e76e-4fe9-23d4d7d768ee

Platform Id

9d5054bd-d17f-09a2-cecc-b246950444f8

Article author

@wadepickett

Metadata

• ID: 14fce65f-1337-58cb-2193-8d8e0e62792d
• PlatformId: 9d5054bd-d17f-09a2-cecc-b246950444f8
• Service: aspnet-core
• Sub-service: tutorials

Related Issues

Associated WorkItem - 502898