The current ant/maven tasks to generate wadl can be enhanced by means of
extended tags on the java docs.
For example to document the response for a particular resource of a given
media-type you can add the tags
However, the current implementation does not support the case where a resource
has more than one representation type, for example using the tage
In this case the documentation task will pick only one of them for the WADL file
Ideally you should be able to create javadoc tags that are specific to different