I'm using microprofile-openapi (knowing it is experimental). It mostly works like a charm for me. However, I just noticed a bug.
Having a model class annotated with @Schema on class and field level (other fields omitted for simplicity).
This results in the following OpenAPI documentation:
Adding @Schema(hidden=true) to the field yields this:
I suppose the latter is expected to really just hide the schema definition of the id field but not the field itself. But using @JsonIgnore to say, this field is not used anywhere in the JSON representation should also hide the field from the OpenAPI documentation.