Base path for documentation files

[ramnes]

Hey there,

Currently, Mintlify automatically generates URLs based on the file structure in the repository. If documentation files are separated from other files (e.g. config, assets, scripts, README, tooling, etc.) in a docs/ directory, the deployed site will have URLs like docs.example.com/docs/... if it has to be served from a subdomain.

I would suggest adding a docsDir option to docs.json, that would default to /but could be set to docs/. In that case, for a foo/bar.mdx file, Mintlify would then read it from docs/foo/bar.mdx and serve it at /foo/bar (stripping the docs prefix).

Does that make sense?

FWIW, MkDocs has docs_dir and VitePress has srcDir.