chore(main): release 3.10.0

[release-please-token-provider]

🤖 I have created a release beepboop

3.10.0 (2026-08-07)

Features

• adds deserialization of the example extension (e5a1080)
• do not ignore multiple types when serializing to 3.0 (#2960) (ebaf27a)
• serialize license identifier as extension for earlier versions (d090989)
• serialize license identifier as extension for earlier versions (60971ba)

Bug Fixes

• better nullability round-tripping (655c2c8)
• deserialize metadata url from extension in earlier version (9387b01)
• marks deprecated properties from the specification as obsolete (787b045)
• marks deprecated properties from the specification as obsolete (953c22a)
• schema: serialize compatibility examples from examples list (5d8ec3a)
• serialize examples as extension in v2/v3 (ff1dbc9)
• serialize examples as extension in v2/v3 (edf3c67)

---

This PR was generated with Release Please. See documentation.

[github-code-quality]

Code Coverage Overview

Languages: C#

C# / code-coverage/dotnet

The overall coverage in commit f1c2b68 in the release-please--bran... branch remains at 89%, unchanged from commit ebaf27a in the main branch.

---

_{Updated August 07, 2026 17:06 UTC}

[Copilot]

Pull request overview

Note

Copilot could not run the full agentic suite for this review because it was automatically requested on a bot-authored pull request. Request a review from Copilot under Reviewers to retry with the full agentic suite. Improved support for bot-authored pull requests is coming soon.

Bumps the library/package version to 3.10.0 and records the 3.10.0 release notes for release-please.

Changes:

• Update package version from 3.9.0 to 3.10.0.
• Add 3.10.0 section to the changelog with features and bug fixes.
• Update release-please manifest to 3.10.0.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
Directory.Build.props	Updates the package version property to 3.10.0.
CHANGELOG.md	Adds release notes for 3.10.0.
.release-please-manifest.json	Updates release-please tracked version to 3.10.0.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (2)

CHANGELOG.md:21

• The 3.10.0 changelog entry contains duplicate bullets (same description appears multiple times with different commit links). This can confuse readers and makes release notes harder to scan. Consider deduplicating by keeping a single bullet per change and either (a) linking to the PR, or (b) listing multiple commit SHAs in one bullet if needed.

* adds deserialization of the example extension ([e5a1080](https://github.com/microsoft/OpenAPI.NET/commit/e5a108004a6c4637d4dd7dc27a417a2d3e29d70b))
* serialize license identifier as extension for earlier versions ([d090989](https://github.com/microsoft/OpenAPI.NET/commit/d0909890d3706152e3ea221660d80ddc69fb8ce5))
* serialize license identifier as extension for earlier versions ([60971ba](https://github.com/microsoft/OpenAPI.NET/commit/60971ba87ced4162e471ebfc1b878776d09cc62f))
### Bug Fixes
* better nullability round-tripping ([655c2c8](https://github.com/microsoft/OpenAPI.NET/commit/655c2c843732faba3687f8fd64568ba509b0065a))
* deserialize metadata url from extension in earlier version ([9387b01](https://github.com/microsoft/OpenAPI.NET/commit/9387b01188c4d2297eaaaa08f06c41c83179f688))
* marks deprecated properties from the specification as obsolete ([787b045](https://github.com/microsoft/OpenAPI.NET/commit/787b045faa15f23528be70c9a6fde2d45ec3bd90))
* marks deprecated properties from the specification as obsolete ([953c22a](https://github.com/microsoft/OpenAPI.NET/commit/953c22aa3b0fba6fecc0e3df21186fb368632ba3))
* **schema:** serialize compatibility examples from examples list ([5d8ec3a](https://github.com/microsoft/OpenAPI.NET/commit/5d8ec3a32d49059b68d00cf2ee267a6537c1a678))
* serialize examples as extension in v2/v3 ([ff1dbc9](https://github.com/microsoft/OpenAPI.NET/commit/ff1dbc98dbfc6d7cfb87153c2b61ec3351157f72))
* serialize examples as extension in v2/v3 ([edf3c67](https://github.com/microsoft/OpenAPI.NET/commit/edf3c6789aafcc6156e193ee6f3bc23d886e8052))

CHANGELOG.md:3

• The repository URL casing here (github.com/microsoft/...) differs from other places in the repo (e.g., github.com/Microsoft/...). GitHub treats this as equivalent, but keeping casing consistent across files improves readability and reduces needless diffs.

## [3.10.0](https://github.com/microsoft/OpenAPI.NET/compare/v3.9.0...v3.10.0) (2026-08-03)

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (2)

CHANGELOG.md:10

• The 3.10.0 changelog section contains multiple duplicate entries (same description appears twice with different commits). This makes release notes harder to read and can confuse consumers. Please deduplicate these bullets (ideally keep a single bullet per change and link to one representative PR/commit), or consolidate the duplicates by rewording to clearly distinguish the underlying changes if they are actually different.

* adds deserialization of the example extension ([e5a1080](https://github.com/microsoft/OpenAPI.NET/commit/e5a108004a6c4637d4dd7dc27a417a2d3e29d70b))
* serialize license identifier as extension for earlier versions ([d090989](https://github.com/microsoft/OpenAPI.NET/commit/d0909890d3706152e3ea221660d80ddc69fb8ce5))
* serialize license identifier as extension for earlier versions ([60971ba](https://github.com/microsoft/OpenAPI.NET/commit/60971ba87ced4162e471ebfc1b878776d09cc62f))

CHANGELOG.md:21

• The 3.10.0 changelog section contains multiple duplicate entries (same description appears twice with different commits). This makes release notes harder to read and can confuse consumers. Please deduplicate these bullets (ideally keep a single bullet per change and link to one representative PR/commit), or consolidate the duplicates by rewording to clearly distinguish the underlying changes if they are actually different.

* marks deprecated properties from the specification as obsolete ([787b045](https://github.com/microsoft/OpenAPI.NET/commit/787b045faa15f23528be70c9a6fde2d45ec3bd90))
* marks deprecated properties from the specification as obsolete ([953c22a](https://github.com/microsoft/OpenAPI.NET/commit/953c22aa3b0fba6fecc0e3df21186fb368632ba3))
* **schema:** serialize compatibility examples from examples list ([5d8ec3a](https://github.com/microsoft/OpenAPI.NET/commit/5d8ec3a32d49059b68d00cf2ee267a6537c1a678))
* serialize examples as extension in v2/v3 ([ff1dbc9](https://github.com/microsoft/OpenAPI.NET/commit/ff1dbc98dbfc6d7cfb87153c2b61ec3351157f72))
* serialize examples as extension in v2/v3 ([edf3c67](https://github.com/microsoft/OpenAPI.NET/commit/edf3c6789aafcc6156e193ee6f3bc23d886e8052))

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud