Skip to content

Commit 9009141

Browse files
authored
Change version from 4.1 to 4.0 and add clarifications
Updated the version number from 4.1 to 4.0 and added a note about the new features and clarifications in MicroProfile OpenAPI 4.0.
1 parent 9a2621b commit 9009141

1 file changed

Lines changed: 13 additions & 2 deletions

File tree

modules/ROOT/pages/chapter04/chapter04.adoc

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -319,9 +319,20 @@ You can use MicroProfile OpenAPI annotations to document any Jakarta RESTful Web
319319

320320
All of these annotations are defined in the `org.eclipse.microprofile.openapi.annotations` package.
321321

322-
== New features in MicroProfile OpenAPI 4.1
322+
== New features in MicroProfile OpenAPI 4.0
323323

324-
MicroProfile OpenAPI 4.1 introduces several enhancements that improve developer productivity and align with the OpenAPI v3.1 specification. These features simplify API documentation, add support for modern Java language features, and provide better schema validation capabilities.
324+
MicroProfile OpenAPI 4.0 introduces several enhancements that improve developer productivity and align with the OpenAPI v3.1 specification. These features simplify API documentation, add support for modern Java language features, and provide better schema validation capabilities.
325+
326+
[NOTE]
327+
====
328+
MicroProfile OpenAPI 4.0 was a major release that introduced OpenAPI v3.1 support, which brings many improvements to API documentation capabilities. The subsequent 4.1 release added clarifications to the specification, including:
329+
330+
* Requirement that all collection-returning methods in model interfaces must return mutable collections
331+
* Clarifications on annotation scanning behavior for Jakarta REST subresource locators
332+
* Refinements to `@Schema` and `@RequestBody` annotation semantics
333+
334+
This chapter covers features available in MicroProfile OpenAPI 4.1 and later, including the specification-level improvements that come from OpenAPI v3.1 adoption.
335+
====
325336

326337
=== OpenAPI v3.1 specification support
327338

0 commit comments

Comments
 (0)