OpenAPI docs generation

To generate the OpenAPI docs, first install the ignite tool. We need version v0.23.0, which is outdated, but works with the current version of the codebase. Pull binaries from the releases page or install from source code following instructions.

Verify the installation by running ignite version:

% ignite version          
·
· 🛸 Ignite CLI v28.2.0 is available!
·
· To upgrade your Ignite CLI version, see the upgrade doc: https://docs.ignite.com/guide/install.html#upgrading-your-ignite-cli-installation
·
··

Ignite CLI version:     v0.23.0
....

Then, to generate the OpenAPI docs, run the following command:

ignite generate openapi

Updated docs will be available in the docs/static/openapi.yml directory.

To view the rendered OpenAPI docs, try the Swagger UI