Puh, I just wrote a bunch of text that describes what I implemented related to wadl for jersey, so I just drop a line here. The generated WADL is really cool as it contains javadoc comments from resource classes, and even might include example xml snipplets - for some users of REST APIs xml is easier to read than xsd 8-)
The documentation is not yet complete but covers most of the features:
- The general description what’s provided and done
- What the user has to do to get cool WADL
- Which javadoc tags are supported and provided
There’s still documentation missing that shows how to use the maven-wadl-plugin to generate the WADL without a running jersey app. Also some documentation should be written that describes, how the user can define and process his own javadoc tags and turn them to WADL.
Still s.th. to write, but the biggest part should be done - puh :-)