Skip to content

Commit 0944c72

Browse files
authored
[Chapter 04 - MicroProfile OpenAPI 4.1] Updating the content with the latest features from MP OpenAPI 4.1 (#63)
* Update chapter04.adoc * Refine MicroProfile OpenAPI documentation for clarity Improved clarity and readability of the MicroProfile OpenAPI section by rephrasing sentences and enhancing consistency in terminology. * Revise chapter04.adoc for clarity and corrections Updated the chapter content to improve clarity and correctness, including rephrasing sentences and fixing typographical errors. * Enhance clarity and readability of OpenAPI section Rephrase and clarify the explanation of the OpenAPI Specification and its benefits, improving readability and consistency. * Refactor OpenAPI documentation and update dependency version Reorganize content on generating OpenAPI documents and improve clarity on annotation-based generation. Update version number for microprofile-openapi-api dependency. * Update chapter04.adoc to reflect annotation scanning changes Removed the section on configuring annotation scanning and added a note about its default state. * Simplify API response annotations in chapter04.adoc Refactored API response annotations for clarity and updated a note about usage of @APIResponses with `extensions' meta data fields. * Enhance filter use cases and add tool integration details Updated practical use cases for filters with more detailed examples and added notes on tool integration. * Remove MicroProfile OpenAPI 4.1 features section Removed section on new features in MicroProfile OpenAPI 4.1 and updated related content for clarity. * 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. * Refactor ExtensionFilter to use simplified operation methods Simplified the example by using the `getExtension()` method added in 4.1, along with the preexisting `addExtension()` method, rather than handling the map of extensions directly. * Update chapter04.adoc * Improve clarity in chapter 04 documentation Refine chapter summary and core concepts for clarity and conciseness. * Update chapter04.adoc for MicroProfile OpenAPI 4.1 * Improving tutorial chapter content - Simplified Tutorial content - Removed advanced features that are rarely used. * Refactor security scheme annotation for Product API Updated the chapter to remove the unnecessary `@SecuritySchemes` wrapper annotation, as @Securityscheme is repeatable and can be used directly. The example now shows the simplified syntax. * Update chapter04.adoc Removed both the "Support for Java records" section and the corresponding bullet from the summary.
1 parent d50adc8 commit 0944c72

1 file changed

Lines changed: 576 additions & 180 deletions

File tree

0 commit comments

Comments
 (0)