Skip to content

chore: prepare Core.OpenApi 2.2.0 and Swashbuckle 1.2.1 - #17

Merged
FEDERIN merged 3 commits into
mainfrom
chore/prepare-core-2.2.0-swashbuckle-1.2.1
Nov 17, 2026
Merged

FEDERIN merged 3 commits into
mainfrom
chore/prepare-core-2.2.0-swashbuckle-1.2.1

Conversation

@FEDERIN

@FEDERIN FEDERIN commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

📋 Description

Prepares the next releases of both packages:

  • CoreSystem.OpenApi 2.2.0 (BREAKING): default problem schemas change to CoreProblemDetails and CoreValidationProblemDetails. Adds ValidationSchemaId, and ProblemSchemaIds includes CoreProblemDetails by default. Release notes explain how to restore ProblemDetails and ValidationProblemDetails.
  • CoreSystem.OpenApi.Swashbuckle 1.2.1: wildcard listen addresses (+, *, 0.0.0.0, [::]) are no longer added as Local servers in Development.
  • Fixes a stray statement in OpenApiRegistration.cs that broke the build.
  • Restores the ProducesOk / ProducesCreated / ProducesNoContent row in the Swashbuckle README and documents ProducesConflictProblemAttribute in the Core README.
  • Includes the docs restructure (docs/OpenApi → docs/Swashbuckle, docs/Attributes.md) and mkdocs.yml that were already staged.

Publish order: Core 2.2.0 first, then update the central pin in Directory.Packages.props from 2.1.0 to 2.2.0 and regenerate lock files, then Swashbuckle 1.2.1. Swashbuckle 1.2.1 currently builds against CoreSystem.OpenApi 2.1.0 because 2.2.0 is not yet on nuget.org.

🎯 Type of Change

  • Bug fix
  • Feature
  • Breaking change
  • Docs
  • Tests added/updated

✨ What's New

  • Core.OpenApi 2.2.0 problem schema defaults (breaking, documented)
  • Swashbuckle 1.2.1 wildcard server filter
  • Docs restructure and README corrections

✅ Checklist

  • dotnet build CoreSystem.OpenApi.slnx -c Release succeeds
  • Tests added/updated (dotnet test): 168 passed, 0 failed
  • Package README.md and docs/ updated if public surface changed
  • packages.lock.json regenerated if dependencies changed (no dependency change in this PR; the central pin stays at 2.1.0 until Core 2.2.0 is published)
  • No breaking changes, or breaking changes documented

📚 References

  • Release notes: src/Core.OpenApi/Core.OpenApi.csproj, src/Core.OpenApi.Swashbuckle/Core.OpenApi.Swashbuckle.csproj

Core.OpenApi 2.2.0 (BREAKING): default problem schemas change to
CoreProblemDetails and CoreValidationProblemDetails. Adds ValidationSchemaId
and includes CoreProblemDetails in ProblemSchemaIds by default. Release notes
describe how to restore the previous names.

Swashbuckle 1.2.1: wildcard listen addresses (+, *, 0.0.0.0, [::]) are no
longer registered as Local servers in Development. Depends on
CoreSystem.OpenApi 2.1.0 until 2.2.0 is on nuget.org.

Also corrects a stray statement in OpenApiRegistration.cs that broke the build,
restores the ProducesOk/ProducesCreated/ProducesNoContent row in the
Swashbuckle README, and documents ProducesConflictProblemAttribute in the
Core README.
ValidationSchemaId now follows SchemaId unless set explicitly. While SchemaId
keeps its default, the 400 response still uses CoreValidationProblemDetails.
The patcher resolves the 400 schema from ValidationSchemaId when a definition
does not declare its own.

Core.OpenApi.Swashbuckle references the Core project when
UseLocalProjectReferences is true, so local builds see the new property.
CI still resolves CoreSystem.OpenApi from nuget until 2.2.0 is published.
coverlet 10.1.0 -> 10.1.1, xunit.v3 4.0.2 -> 4.0.3, Microsoft.AspNetCore.TestHost
and Mvc.Testing for net10.0 10.0.13 -> 10.0.15. Lock files regenerated with
the default package-based restore (no project references).
@FEDERIN
FEDERIN merged commit f8df1b4 into main Nov 17, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant