[newbie] how to generate static docs with maven?
Hello,
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 https://petstore.swagger.io. Possibly, I want to do that using Maven.
I have seen there is a third-party Maven plugin (https://github.com/kongchen/swagger-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:
https://github.com/swagger-api/swagger-core/tree/master/modules/swagger-maven-plugin
https://github.com/swagger-api/swagger-codegen/tree/master/modules/swagger-codegen-maven-plugin
So, what is the intended way to generate docs?
Thank you.