ModeShape's REST Service has been primarily documented via Confluence, by statically listing the different methods and usage patterns.

We should integrate Swagger into our REST API in order to easily obtain a generic Swagger json definition file, which can the be used for several purposes like:

• auto-generating client code
• generating standard documentation templates