eclipse-ee4j / eclipse-ee4j/jersey
WADL generation should support producing multiple mime/types
- Dominant language
- Java
- Stars
- 730
- Forks
- 382
- PR merge metrics
- No merged PRs in 30d
Description
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
@response.representation.200.doc
@response.representation.200.example
However, the current implementation does not support the case where a resource
has more than one representation type, for example using the tage
@Produces(
{"text/xml", "application/json"}
)
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
media types
Carlos
#### Environment
Operating System: All
Platform: All
Contributor guide
Assessment
This issue has not been assessed yet.