- Developer packages a JAX-RS Application class and sets the ApplicationPath to some value (e.g., /api )
- Developer includes the Swagger fraction so that others can use the swagger.json to test / build their APIs.
- Swagger fraction needs the developer to explicitly set the "swarm.deployment.*.swagger.root" value so that the baseUrl of the swagger.json file is set properly.
It would be nice if the Swagger fraction would make its resources available by default under the JAX-RS context path.
swarm.context.path = /myapp
swarm.deployment.*.jaxrs.application-path = /api
Then, the expectation should be that the swagger.json file has the basePath set to "/myapp/api"
Developers can choose to change this value by providing it declaratively via the YML configuration file.