Nested pages (pages nested under pages)

[RiskeyL]

Current Limitation

Mintlify currently only supports nesting pages under group names (non-page entries), which creates architectural constraints when building intuitive documentation hierarchies.

Problem Description

Scenario: When documenting a concept with sub-concepts (e.g., a feature with variants), the ideal structure would be:

📄 A (main page about concept A)
├── 📄 A1 (sub-page about variant A1)
└── 📄 A2 (sub-page about variant A2)

Current Workaround: We must create a group structure like:

📁 A (group name, not a page)
├── 📄 A (overview page - confusing naming)
├── 📄 A1 (sub-page)
└── 📄 A2 (sub-page)

Issues with Current Approach

• Hierarchy confusion: A1 and A2 appear as siblings to A instead of children.
• Navigation UX: Users expect to click the group name "A" to learn about A, then explore sub-topics.
• Content organization: Forces artificial separation between overview and sub-topics.

Proposed Solution

Allow pages to have child pages directly.

Expected Benefits

• More intuitive information architecture
• Better user navigation experience
• Cleaner, more logical documentation structure
• Reduced cognitive load for both authors and readers