Frontend

i am about to embark on the journey of writing my own OpenAPI Spec → MDX generator for custom documentation. anyone done this before? any helpful links?

ensdata.net ✦ pugson.net/rfe ✦ metadata.vision ✦ 𝙿𝚁𝙴𝚅: @rainbow

FWIW We use Mintlify which is MDX based in general, but for the API ref we just plug in the files after a mini transformation and it does the rest: https://docs.dynamic.xyz/api-reference/overview

Regular human, Developer Experience at dynamic.xyz

i know i’ve seen your docs 😏 

tried mintlify but there are so many issues with their parser, they keep breaking the docs every single week with some new change, can’t get through to support, no way to make custom react components to inject into MDX. 

their marketing is way better than the actual product.

ah that hurts, sorry for that, definitely not completely stable but still a fan. Feel you on this one too "no way to make custom react components to inject into MDX." - for the quickstart we generate embeds via react and inject as iframes but it's very isolated. Almost went with https://markdoc.dev/ initially.

i’m in the process of building a mintlify dx where the OpenAPI spec is parsed into a full layout like theirs but on top of next.js where you have full control over everything else