feat(jans-auth-server): automate swagger and doc generation

[yuriyz]

Description

We need automate swagger and doc generation. Question what is the easiest way to do it?

Primary goal is to automate it for jans-config-api since beans are changing often there. jans-auth-server API is more conservative.

springfox is nice tool to automatically generate swagger and documentation. Problem is that we don't use spring. What alternatives can we use with Weld ? R&D is needed.

[yuriyz]

Actually it seems we already have ticket for jans-config-api here. Thus targeting by this ticket jans-auth-server.

[ossdhaval]

Hi @yuriyz, can you please confirm if this is still a need?

[yuriyz]

AS swagger is based on spec and it not changed frequently. And config-api is automated. We can close it. Lets re-open when needed.