Forum Discussion

luca's avatar
New Contributor
6 years ago

[newbie] how to generate static docs with maven?


I have a Java JAX-RS webservice, built with Maven.

The webservice runs in Thorntail (i.e. JBoss), if that matters.

Now, I cannot understand how to use Swagger exactly.

I already know how to annnotate classes properly.

I want to generate some HTML (not JSON or YAML!) static documentation of my webservices. Something similar to Possibly, I want to do that using Maven.

I have seen there is a third-party Maven plugin (, however I would like to avoid third-party products.

I have found two interesting plugins, but I did not understand how to use them, nor if they are available in Maven Central Repository:


So, what is the intended way to generate docs?
Thank you.