v10.0.1

What's Changed

• Prepare for OpenAPI.NET 3.0 by @martincostello in #3647
• Fix exception sorting operation tags by @martincostello in #3652
• Improve version table by @martincostello in #3653
• Update migration guide by @martincostello in #3654

Full Changelog: v10.0.0...v10.0.1

v10.0.0

Swashbuckle.AspNetCore v10.0.0

Important

This release contains major breaking changes.

Read our v10 migration guide for further information.

With this release, Swashbuckle.AspNetCore adds support for generating OpenAPI 3.1 documents and for ASP.NET Core 10.

Swashbuckle.AspNetCore v10 depends on OpenAPI.NET v2.3 which introduces many breaking changes to the public API surface. More information can be found in their OpenAPI.NET v2 Upgrade Guide.

To reduce the number of breaking behavioural changes in Swashbuckle.AspNetCore v10, generation of OpenAPI 3.1 documents is opt-in.
To generate OpenAPI 3.1 documents, change the OpenAPI version as shown in the code snippet below:

app.UseSwagger(options =>
{
    options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
});

Tip

It is strongly recommended that you upgrade to Swashbuckle.AspNetCore v9.0.6 before upgrading to v10.

Important

Use of Swashbuckle.AspNetCore with the ASP.NET Core WithOpenApi() method is no longer supported.

What's Changed

• Update README badges by @martincostello in #3597
• Extend NuGet package validation by @martincostello in #3602
• Support .NET 10 by @martincostello in #3283

Full Changelog: v9.0.6...v10.0.0

v9.0.6

What's Changed

• Bump redoc from 2.5.0 to 2.5.1 by @dependabot in #3587
• Bump swagger-ui from 5.29.1 to 5.29.2 by @dependabot in #3595

Full Changelog: v9.0.5...v9.0.6

v9.0.5

What's Changed

• .NET 10 preparation by @martincostello in #3565
• Update NuGet packages by @martincostello in #3573
• Fix anchors by @martincostello in #3577
• Bump swagger-ui-dist from 5.27.1 to 5.29.1

Full Changelog: v9.0.4...v9.0.5

v9.0.4

What's Changed

• Fix incorrect ETag values by @martincostello in #3490
• Fix Accept-Encoding parsing by @martincostello in #3492
• Check Accept-Encoding quality by @martincostello in #3493
• Update xunit packages by @martincostello in #3500
• Add release notes configuration by @martincostello in #3502
• Simplify release workflow by @martincostello in #3503
• Bump xunit dependencies by @martincostello in #3508
• Update NuGet dependencies by @martincostello in #3513
• Remove WebHost usage from tests by @martincostello in #3517
• Fix typos by @martincostello in #3520
• Sign-off commits by @martincostello in #3526
• Add zizmor by @martincostello in #3528
• Fix permissions by @martincostello in #3529
• Bump zizmor by @martincostello in #3535
• Add default $type discriminator for [JsonPolymorphic] by @lilinus in #3496
• Update NuGet dependencies by @martincostello in #3545

New Contributors

• @lilinus made their first contribution in #3496

Full Changelog: v9.0.3...v9.0.4

v9.0.3

What's Changed

• Fix incorrect Content-Length for swagger-ui and Redoc static assets by @martincostello in #3488

Full Changelog: v9.0.2...v9.0.3

v9.0.2

What's Changed

• Generate SBOM by @martincostello in #3468
• Compress swagger-ui and Redoc files in embedded resources with GZip by @stratosblue in #3399
• Refactor GZip compression by @martincostello in #3480

New Contributors

• @stratosblue made their first contribution in #3399

Full Changelog: v9.0.1...v9.0.2

v9.0.1

What's Changed

• Fix missing Swashbuckle.AspNetCore metapackage dependencies by @martincostello in #3460

Full Changelog: v9.0.0...v9.0.1

v9.0.0

📣 This release contains the following breaking changes:

• Drops support for netstandard2.0 and thus .NET Framework - now only net8.0 and net9.0 are supported.
• Removes all public members annotated as [Obsolete] in previous releases.
• Removes the deprecated --serializeasv2 option from Swashbuckle.AspNetCore.Cli, which was superseded by --openapiversion from version 8.0.0.

What's Changed

• Add tests for [Range] and respect ParseLimitsInInvariantCulture property by @martincostello in #3448
• Fix [Range] behaviour by @martincostello in #3449
• Refactor sample websites by @martincostello in #3450
• Drop netstandard support by @martincostello in #3422

Full Changelog: v8.1.4...v9.0.0

v8.1.4

What's Changed

• Avoid ArgumentNullException being thrown generating examples by @skironDotNet in #3444

Full Changelog: v8.1.3...v8.1.4