We have had casual discussions about this before. It is something we’ve wanted to do, so +1 from me.
On Wed, Nov 13, 2019 at 3:45 PM Sandor Molnar <[email protected]> wrote: > Hi folks, > > recently I had some contribution that allows end-users managing service > definitions without restarting the Knox Gateway. See > https://issues.apache.org/jira/browse/KNOX-2053 and > https://issues.apache.org/jira/browse/KNOX-2056 for further details. > > I've been just about creating a new JIRA to document those new API > endpoints in Knox user guide but it has come to my mind that we can do it > much better by using Swagger. > > Given the fact, the Admin API does not consist of hundreds of existing > endpoints it should not be 'that' huge work. I personally believe the > project would gain a lot by using this very useful tool (e.g. Admin API > documentation would be generated out-of-the-box, no more documentation > JIRAs required. Moreover, the generated documentation would be in sync with > the actual implementation). > You can check this out here: https://swagger.io/tools/swagger-ui/ (there > is a live demo too; it's worth looking at). > > Any comments, ideas are welcome! > > Cheers, > Sandor >
