I think I basically want the interface of sphinxcontrib-openapi (render the docs by way of sphinx directive, so that you can e.g. only render some endpoints), but the visuals of something like ReDoc (pretty, column layout) without its sidebar, and neither sphinxcontrib-openapi nor sphinxcontrib-redoc are doing this.

I really don’t want to build my own OpenAPI renderer …

I think I might be building a monster that renders one OpenAPI spec file from the API definition, then uses the ReDoc CLI to split the file up into separate endpoint files, and then use something like a custom sphinx tag (… okay, currently .. raw:) to render the file.

And then a ton of custom CSS to make the ReDoc sidebar disappear and make everything else render in styles compatible with the rest of the docs.

Nothing about this is good.