Generating API Docs on the Documentation site

[deshetti]

Looks like the swaggo/swag that we are using to generate the Swagger client doesn't support OpenAPI spec. I thought that will not work with ReDoc to autogenerate the API Docs using either the swagger.json or swagger.yaml files. There is an open issue to support OpenAPI spec for over three years 🙂 swaggo/swag#386

But interestingly, I checked it on ReDocs site to see if our spec is generating the API docs and it looks fine to be from a quick glance: https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/factly/kavach/fix/space-conflicts/server/docs/swagger.json

Now what we could do is use this preset in Docusaurus to generate the API docs:
Documentation: https://redocusaurus.vercel.app/docs
Package: https://www.npmjs.com/package/docusaurus-plugin-redoc