Minor Description
Experiment with a SwaggerFeature (in rt/rs/descriptions) and SwaggerUi and see how can we get more out of this feature. It offers a primitive support right now, and apparently if we can add lots of Swagger annotations and SwaggerUI can do something with it, but I wonder if there's a better way, may be Swagger can analyze JAX-RS Application.