Most everything I have looked at has either required me to double annotate
stuff, add more data, or shows only minimal information.
If seems to me that if I use POJO java beans for all my return values, path
params, and query params and if the Resources and Beans are well javadoc'd
that there should be a tool that can auto-generate very good documentation
showing all the JSON as well as the resource paths and methods. This should
be able to just run as a maven task scraping the annotations and parsing
the beans to assemble JSON.
Does anyone know if a tool like this exists?
Thanks!