Conform basePath to Swagger Spec

- basePath should be a full URL to the API endpoint and not be concatenated to API Operation paths.
- explicit documentation for how annotations build swagger