This section details on the original issue you should resolve

<issue_title>Clarify “Swashbuckle is not available in .NET 9 or later” banner on the Swashbuckle tutorial</issue_title>
<issue_description>### 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</issue_description>

Comments on the Issue (you are @copilot in this section)

Issue Analysis: Swashbuckle Banner Clarity in .NET 9+ Documentation

Issue Summary

This is a valid issue.

Review

Published Article:
ASP.NET Core: Getting Started with Swashbuckle
Content Source:
getting-started-with-swashbuckle.md
Includes:
get-started-with-swashbuckle8.md

Current Banner Text:
Located in aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md:

> [!NOTE]
> Swashbuckle is not available in .NET 9 or later. For an alternative, see <xref:fundamentals/openapi/overview?view=aspnetcore-9.0&preserve-view=true>.

This text appears in the published article for ASP.NET 8.

Issue Description:
The issue points out that the current banner could mislead readers. The wording implies Swashbuckle cannot be used at all in .NET 9+, when the actual change is that Swashbuckle is no longer included in official templates or documentation. Swashbuckle remains available as a community package for manual addition.

Validity & Scope

• The feedback is accurate and actionable.
• The wording of the banner does not reflect the actual status of Swashbuckle in .NET 9+.
• The scope is limited to the Swashbuckle tutorial and any related documentation referencing this banner.

Required Actions

1. File(s) to Change

• aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md
• (If the banner is reused elsewhere, those instances should also be updated.)

2. Recommended Revision

Replace the banner with more precise language. For example:

> [!NOTE]
> Starting with .NET 9, Microsoft’s official templates and documentation use the built-in `Microsoft.AspNetCore.OpenApi` package for OpenAPI support. Swashbuckle is no longer included by default, but remains available as a community package and can still be added manually to .NET 9+ projects. For more information, see <xref:fundamentals/openapi/overview?view=aspnetcore-9.0&preserve-view=true>.

3. Line Numbers

• Change the first block (lines 1-3 in `getting-started-with-swashbuckle8.md...