I like Swagger but there are several boxed solutions for this. My recommendation is to examine this from a documentation first perspective. That means the end p

I like Swagger but there are several boxed solutions for this. My recommendation is to examine this from a documentation first perspective. That means the end product displays documentation not that your developers running first time configuration have something to read.