RESTdoc

RESTdoc is a tool for creating documentation of REST services. It doesn't use any self-defined tags in comments or own annotations. Instead, it relies on normal, existing Javadoc comments. This way, there is no additional work for a developer when programming.

Using RESTdoc is quite easy. Internally, RESTdoc uses a meta model and offers report classes that transforms existing code into this model. From this, you can either process the model or use one of the printer classes to output it to a certain format, for example an HTML documentation. You can also use the Maven report mojo to generate the documentation with every Maven build.