Content
@
0 reply
0 recast
0 reaction
pugson
@pugson
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?
8 replies
0 recast
10 reactions
Matt Foyle
@mxf
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
1 reply
0 recast
0 reaction
pugson
@pugson
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.
1 reply
0 recast
0 reaction
Matt Foyle
@mxf
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.
1 reply
0 recast
0 reaction
pugson
@pugson
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
0 reply
0 recast
1 reaction
