There are a lot of how-tos on how to use OpenAPI to document the REST APIs of a Quarkus microservice. However, none of them show you how to document the schema of your API response.

In this blog post I’ll show you two ways to add schema documentation to your OpenAPI spec.