From bfa4357a0e5d40c45911ca1e6fab9de12736acf6 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 27 Oct 2025 18:50:07 +0000 Subject: [PATCH 01/13] Initial plan From a39aed75dffc8539ff3a51efbe7ecb025e579442 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 27 Oct 2025 18:55:58 +0000 Subject: [PATCH 02/13] Clarify Swashbuckle availability banner for .NET 9+ Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> --- aspnetcore/tutorials/getting-started-with-swashbuckle.md | 2 +- .../includes/getting-started-with-swashbuckle8.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle.md b/aspnetcore/tutorials/getting-started-with-swashbuckle.md index ab6af8cea6c8..9d32ede242fb 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle.md @@ -5,7 +5,7 @@ description: Learn how to add Swashbuckle to your ASP.NET Core web API project t ms.author: wpickett monikerRange: ">= aspnetcore-3.1 <= aspnetcore-8.0" ms.custom: mvc -ms.date: 8/27/2024 +ms.date: 10/27/2025 uid: tutorials/get-started-with-swashbuckle --- # Get started with Swashbuckle and ASP.NET Core diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 8b13ee452c1b..a80561742055 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,7 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!NOTE] -> Swashbuckle is not available in .NET 9 or later. For an alternative, see . +> 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 . There are three main components to Swashbuckle: From a9ebe8f6fb8a2c09c421c164f56e284df3bcaa2f Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 12:39:15 -0700 Subject: [PATCH 03/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index a80561742055..97586996dede 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,7 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!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 . +> Starting with .NET 9, Microsoft's official templates and documentation use the built-in [`Microsoft.AspNetCore.OpenApi`](https://www.nuget.org/packages/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 . There are three main components to Swashbuckle: From 5881830febe6ef24a5c6a48de5ad17b4aacde281 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 13:17:26 -0700 Subject: [PATCH 04/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 97586996dede..659d211f1c8f 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,7 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!NOTE] -> Starting with .NET 9, Microsoft's official templates and documentation use the built-in [`Microsoft.AspNetCore.OpenApi`](https://www.nuget.org/packages/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 . +> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, although it can be added manually to ASP.NET Core in .NET 9+ projects. For more information, see . There are three main components to Swashbuckle: From 76b91641b6ae2b8d5e33b74c24428a0604c8941e Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 13:21:14 -0700 Subject: [PATCH 05/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 659d211f1c8f..c701bf544527 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,7 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!NOTE] -> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, although it can be added manually to ASP.NET Core in .NET 9+ projects. For more information, see . +> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package that you can add manually to ASP.NET Core in .NET 9+ projects. For more information, see . There are three main components to Swashbuckle: From 0ca67c48f5ba09c249228f4e2244e20c903aad33 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 13:23:03 -0700 Subject: [PATCH 06/13] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../includes/getting-started-with-swashbuckle8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index c701bf544527..843cf0c3fd08 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,7 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!NOTE] -> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package that you can add manually to ASP.NET Core in .NET 9+ projects. For more information, see . +> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package that you can add manually to .NET 9+ ASP.NET Core projects. For more information, see . There are three main components to Swashbuckle: From ec2d9d0b6a59d34e1ad75c9082ef3227137687b1 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 17:04:14 -0700 Subject: [PATCH 07/13] Apply suggestion from @wadepickett Added 2nd link --- .../includes/getting-started-with-swashbuckle8.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 843cf0c3fd08..eb27e96c8b22 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -2,7 +2,9 @@ :::moniker range=">= aspnetcore-6.0 < aspnetcore-9.0" > [!NOTE] -> Starting with .NET 9, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package that you can add manually to .NET 9+ ASP.NET Core projects. For more information, see . +> In .NET 9 and later, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package you can add manually to ASP.NET Core projects targeting .NET 9 or later. +> • To understand the built‑in OpenAPI features, see . +> • To add and use the Swagger UI provided by the Swashbuckle.AspNetCore.SwaggerUI package for interactive exploration or local ad‑hoc testing, see . There are three main components to Swashbuckle: From 60ea8dba81f24a1d50a4009d0054849d9d1acc13 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 21:43:05 -0700 Subject: [PATCH 08/13] Clarify OpenAPI and Swashbuckle usage in .NET 9 Updated note on OpenAPI support in .NET 9 and later, clarifying the status of Swashbuckle. --- .../includes/getting-started-with-swashbuckle8.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index eb27e96c8b22..f70c2b8858d7 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -3,8 +3,9 @@ > [!NOTE] > In .NET 9 and later, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package you can add manually to ASP.NET Core projects targeting .NET 9 or later. +> > • To understand the built‑in OpenAPI features, see . -> • To add and use the Swagger UI provided by the Swashbuckle.AspNetCore.SwaggerUI package for interactive exploration or local ad‑hoc testing, see . +> • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . There are three main components to Swashbuckle: From fd3f7f1d84e6abea8cb27fd346bf7600b12da10e Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 21:45:05 -0700 Subject: [PATCH 09/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index f70c2b8858d7..bcf9ac0b3cf9 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -5,6 +5,8 @@ > In .NET 9 and later, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package you can add manually to ASP.NET Core projects targeting .NET 9 or later. > > • To understand the built‑in OpenAPI features, see . +> +>The following explanations and instructions are provided in case you want to use Swashbuckle anyway. > • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . There are three main components to Swashbuckle: From 0e8a0bfe60358898178ba68f90dfaf720dde7945 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 21:46:17 -0700 Subject: [PATCH 10/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 1 - 1 file changed, 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index bcf9ac0b3cf9..24b3484ca963 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -6,7 +6,6 @@ > > • To understand the built‑in OpenAPI features, see . > ->The following explanations and instructions are provided in case you want to use Swashbuckle anyway. > • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . There are three main components to Swashbuckle: From 50059453b56b7cb55d468da1b583a4d16366d786 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 22:27:19 -0700 Subject: [PATCH 11/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 24b3484ca963..7beb15c8764d 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -7,6 +7,8 @@ > • To understand the built‑in OpenAPI features, see . > > • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . +> +>The following explanations and instructions are provided in case you want to use Swashbuckle anyway. There are three main components to Swashbuckle: From 575e86c9145a220335a7b2f4c3ff4ec40ba67240 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 27 Oct 2025 22:27:51 -0700 Subject: [PATCH 12/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 1 - 1 file changed, 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index 7beb15c8764d..d45cb06c7c56 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -5,7 +5,6 @@ > In .NET 9 and later, ASP.NET Core includes built-in OpenAPI support. Swashbuckle is no longer included by default, but it remains available as a community package you can add manually to ASP.NET Core projects targeting .NET 9 or later. > > • To understand the built‑in OpenAPI features, see . -> > • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . > >The following explanations and instructions are provided in case you want to use Swashbuckle anyway. From 184739b2fdac601e0409e13ea17d7eda5f68babf Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Tue, 28 Oct 2025 11:37:17 -0700 Subject: [PATCH 13/13] Apply suggestion from @wadepickett --- .../includes/getting-started-with-swashbuckle8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md index d45cb06c7c56..572832c222fc 100644 --- a/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md +++ b/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md @@ -7,7 +7,7 @@ > • To understand the built‑in OpenAPI features, see . > • To add and use the Swagger UI provided by the `Swashbuckle.AspNetCore.SwaggerUI` package for interactive exploration or local ad‑hoc testing, see . > ->The following explanations and instructions are provided in case you want to use Swashbuckle anyway. +>The following instructions apply when using Swashbuckle with .NET versions earlier than 9. There are three main components to Swashbuckle: