jaxrs-analyzer
jaxrs-analyzer copied to clipboard
param annotation text is not present in asciidoc
The descriptive text for parameters is present in the swagger output, so it is harvested, but it is not in the asciidoc file. I'd figure that would be very relevant information to include in documentation.
Hey tbee, can you tell me if you manage to get swagger annotations (or javadocs) working on 0.15?
Hm, I just let it generate the default stuff; I wanted the asciidoc generated PDF and noticed the missing param text. So I have not tried any additional swagger annotations.
The JAX-RS Analyzer doesn't support Swagger annotations.
Yes, maybe the JavaDoc information is not yet in all Backends. If you would like to, I'd highly appreciate contributions and PRs :-)
I understand, I have the same sentiment when people ask me to make changes to JFXtras. But it is much harder for them to work them into the code than it is for me. (And it is for you here ;-) ) But maybe I'll find time somewhere between that and I the talk I'm prepping for JavaOne.
I think you are hijacking my issue here and should start a new ones with the requests and suggestions.
I just updated the JavaDoc support. Now it should be easier to enhance the gathered information.
Leaving this issues open for now...
Yes, @jmanteigueiro please open new issues and refrain from hijacking :-)