Forum Discussion

luca's avatar
luca
New Contributor
5 years ago

[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.