I was working with @alford recently and discovered this OpenAPI “starter” repo from a company called Redocly. I modified it to run in a container so that you don’t have to install Node and all the dependencies. It may help you develop your OpenAPI spec files.
Another thing we discovered in the process is that GitLab already includes a nice OpenAPI spec rendering by default. If you visit openapi/openapi.yaml · 0.2.0 · NSF MUSES / openapi-starter · GitLab for example, you will see a rough draft of the bulk viscosity module API with an equation of state input.