Skip to content

25.0.0.7-beta staging #4419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: staging
Choose a base branch
from
Open

25.0.0.7-beta staging #4419

wants to merge 6 commits into from

Conversation

github-actions[bot]
Copy link

[#microprofile]
== MicroProfile 7.1

MicroProfile 7.1 (`MP 7.1`) is a minor release. It has the following MicroProfile component specifications and works with Jakarta EE 10 Core Profile:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of It say MicroProfile 7.1

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@is273 wont it be repetitive to frame it 'MicroProfile 7.1 has the following MicroProfile component specifications and works with Jakarta EE 10 Core Profile:'


OpenAPI is a standardized way of documenting REST APIs in a JSON or YAML format. MicroProfile OpenAPI helps to generate and serve OpenAPI documentation for REST applications that are built by using JAX-RS or Jakarta restfulWS. This can be useful for developers to test out the API during development, or for people who uses API in production.

In this beta, the new MicroProfile OpenAPI 4.1 is introduced. To use it, first add the feature to your `server.xml`:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of it say MicroProfile OpenAPI 4.1

</featureManager>
```

Then, deploy rest application and then see `/openapi` on liberty server to view the OpenAPI documentation, or go to `/openapi/ui` for a user interface that lets to browse through it. To enhance the documentation, use link:https://download.eclipse.org/microprofile/microprofile-open-api-4.1/apidocs/[annotations] in code to add things like textual descriptions to each method. The annotations are available as a maven dependency:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of
"Then, deploy rest application and then see /openapi on liberty server to view the OpenAPI documentation, or go to /openapi/ui for a user interface that lets to browse through it."
say
"Deploy the rest application. Then see /openapi on the Liberty server to view the OpenAPI documentation, or go to /openapi/ui for a user interface to browse through the documentation."

</dependency>
```

MicroProfile OpenAPI 4.1 is a very small release, which adds:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Get rid of "very" and the comma

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.

3 participants