A quick update on the work I've been doing around Swagger enhancements. There's still much work to do, but I wanted to provide a sneak-peek.
As previously requested, it would be nice to have more user-friendly OPTIONS pages based on Swagger UI.
Here's an example of what it looks like so far...
It's implemented as a per-media-type PojoSwap<Swagger,Div> that replaces a Swagger object with HTML5 beans when rendered as HTML.
The examples can be embedded in the Swagger JSON or annotations. They can also come from the beans themselves via a new @Example annotation that can be applied to static methods on a bean:
These examples beans are then serialized to all the supported languages and inserted into the generated Swagger.
Here's what it looks like in the light and dark themes...
There are also general improvements coming to the Swagger API itself such as better support for definitions and references, and other fixes for pain-points I'm discovering along the way.