Github user puneethps commented on a diff in the pull request:
https://github.com/apache/tomee/pull/340#discussion_r244777643
--- 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 --
I think it is working as expected now, without the Accept:application/json
header it is outputting a valid YAML. I think I should document that in the
README file.
---
