IG Group has open-sourced RESTdoclet, a maven plugin for generating web-based REST API documentation from REST Java web services implemented using the Spring REST framework.
The plugin:
The plugin:
·
supports Spring 3 REST annotations and JavaDoc
out of the box,
·
does not require any additional annotations,
·
is easily integrated with Maven continuous
build processes, with minimal configuration,
·
supports multiple streams of service
development, and
·
publicises documentation in an interactive,
Javadoc-like form, to the web, thus providing a source-code agnostic guide to
service consumers.