Support $ref that splices arrays inline #5113
rkhoriander
started this conversation in
Feature Requests
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Currently,
$refonly merges content when it resolves to an object. Per the docs: "If a $ref resolves to a non-object value such as an array, Mintlify ignores any sibling keys." This makes$refunusable for splitting any array-valued key indocs.json, including redirects and pages.Our use case: we have 695 redirects that we've organized into 34 per-section files. We'd like to assemble them natively at build time rather than maintaining a custom Python script and GitHub Action. We'd also like to use
$refwithinpagesarrays to split tab navigation into per-section files.Please support
$refas an element within an array, where the referenced content is spliced inline:Where each referenced file contains an array of objects that gets merged into the parent array at that position. This would unlock split configuration for any array-valued key (redirects, navigation pages, and anything else) making
$refgenuinely useful for large documentation sites that need to manage config across multiple files.Beta Was this translation helpful? Give feedback.
All reactions