Github user ivanjunckes commented on a diff in the pull request:
https://github.com/apache/tomee/pull/340#discussion_r244724535
--- Diff: examples/mp-openapi/README.adoc ---
@@ -0,0 +1,112 @@
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: unpublished
+
+# Microprofile OpenAPI
+This is an example on how to use microprofile OpenAPI in TomEE.
+
+== Run the application:
+mvn clean install tomee:run
+
+Within the application there is an endpoint that will give you weather
based on day.
+
+== Request
+....
+GET http://localhost:8080/mp-openapi/weather/status/{today}
+
+
+== Response
+....
+{today} is a sunny day.
+
+
+== OpenAPI
+
+OpenAPI is a spec for natively producing OpenAPI v3 documents from JAX-RS
applications.
+There exists an endpoint /openApi which gives the OpenAPI document based
on Accept request header.
+
+
+== Request
+....
+GET http://localhost:8080/mp-openapi/openapi
--- End diff --
It does not work without content-type as application/json so it is worth
mention it. This is a bug in openapi I think. Because it should have a default
message body reader/writer and it should be yaml. But it can be fixed later,
there is a discussion on the list about it.
---
