top | item 43997272

(no title)

hahnbee | 9 months ago

Love it - I'm one of the cofounders of Mintlify and I love the thoughtfulness and intentionality you put here. We've found the navigation and hierarchy to mean a lot.

I also love your future docs roadmap - it aligns with our roadmap and some things are already there! - API keys are locally cached across the API reference. Let me know if there are more fields you think would be convenient to cache and we can investigate. - Whichever programming language you choose for a code block should also sync across pages. - We also launched AI translations so you can support docs in any language! - We also have AI Chat and are planning on devoting more resources to it so that it's best in class.

discuss

order

cbrinicombe|9 months ago

Great to hear! Lots more we want to add for sure. One thing that would be nice is a way to directly embed code snippets referenced in my OpenAPI spec into the content of a particular page. I know you have <RequestExample /> and <ResponseExample /> but you have to write the code snippet every time for those (unless you use a custom snippet, but I can see that being cumbersome at scale). Plus these are positioned outside of the main page content. Feels like if I've given mint my openapi spec, with code snippets already in there, then in the same way mint can generate an api playground, surely it could generate code snippets as well. This would be nice as the snippets I have defined in my api spec use our official sdks, so are more relevant than those mint generates itself.