Discuss and publish API Docs as swagger - Generate swagger from code

I would like to explore how to publish the API docs as swagger document.

The JavaDocs are nice, but I think most of us are using swagger these days. And you can actually generate swagger docs automatically published from the code based on the annotations. 

I would like to discuss and try that.