Recently CXF has added native support for Swagger.
This means Syncope can generate Swagger description for its JAX-RS services and also provide an extension for interacting with it, based on Swagger UI.
WADL JavaDocProvider does not handle methods with generic first argument
Investigate if WADL JavaDocProvider can report JavaDocs of inherited methods
Enhance Swagger feature with optional dynamic basePath, tags and Javadocs handling