Improved OpenAPI YAML Support from URL Sources

[ConallHeffernan]

It would be nice if Mintlify could better support automation for S3-hosted OpenAPI YAML specs.

Currently, Mintlify does not format detailed documentation nicely when pulling directly from a URL. Ideally, this process should be fully automated—without requiring additional scripts, manual pasting of new YAML files and creating new .mdx files.

It would be great if Mintlify could intelligently parse the tags and descriptions in the YAML file to generate a well-structured, overview-layout. This would eliminate the need to manually create .mdx files every time a new endpoint is added to our OpenAPI spec.

For reference, there's a noticeable difference between the manually created .mdx files and what Mintlify currently renders when pulling directly from a URL.

vs

I raised this in the slack community also and users are using scripts to do this, ideally the tool does this for us out of the box