Using Swagger Api Spec to generate documentation

[eznix86]

Implementation example: https://motif.land/guides/openapi

{
...
api: { url: "swagger api endpont here" ,  doc: "can extend doc using mdx" }
...
}

It automatically adds API the side menu and extends the swagger doc with another mdx file.

[TranquilMarmot]

Yeah, this is what we use Mintlify for. It's very similar to docs.page but is very expensive.

[Ehesp]

I'll add this one to track. There's a big update in the works so I'll look into this once that lands.

Question: does it make sense to source the open api spec from a remote url or as a static file via github? (or both?)