We are currently generating documentation for our REST resources using this procedure. The problem is that our resources only accept and produce JSON, whereas the examples that are inserted in the documentation by Jersey's Javadoc doclet are all in XML.
It should be possible to use JSON in the examples instead of XML.
Fix involves creating a new doclet based on com.sun.jersey.wadl.resourcedoc.ResourceDoclet from jersey-contrib. Since it's a new class, to be used during other components's build, the impact on products using previous versions of the library is none.
See rev:62664, rev:62724, rev:62725.