In Apache CXF, one can generate a Wadl for any registered resource by appending ?_wadl to the resource url. This Wadl provides an excellent source of real-time REST API documentation, but the output format is not reader-friendly.
I extended the default CXF WadlGenerator to support text/html mediaType using .
Here is the code for HTMLWadlGenerator, which can be registered as a jaxrs:provider with the jaxrs:server. To see the output, append ?_wadl&_type=text/html to the resource url.
This would give a nice looking HTML page of REST API documentation for the registered resources.