Skip to content

[A/B — do not merge] Flatten Voice & Video nav to test version-tree 500 - #455

Closed
raj-dubey1 wants to merge 1 commit into
docs/broken-version-tree-fixfrom
docs/version-tree-flatten-ab
Closed

[A/B — do not merge] Flatten Voice & Video nav to test version-tree 500#455
raj-dubey1 wants to merge 1 commit into
docs/broken-version-tree-fixfrom
docs/version-tree-flatten-ab

Conversation

@raj-dubey1

Copy link
Copy Markdown
Contributor

Purpose — A/B test only, NOT for merge

Diagnostic experiment for the desktop version-switcher "Error 500" (React insertBefore crash inside Mintlify's own bundle f486afc314643ce1.js). The crash fires when the version tree is opened on desktop (inline sidebar); mobile/tablet (drawer) is unaffected.

Hypothesis

The crash is triggered by our unsupported nesting tab → dropdowns → versions → groups. Mintlify's docs require one child-type per level, and versions-inside-dropdowns is an open, unsupported feature request (mintlify/discussions#2168). Onset ~2 days ago with no structural change on our side points to a Mintlify platform regression that stopped tolerating the nesting.

What this branch changes

Voice & Video Calling only. The SDK tab's framework dropdowns (JavaScript, React Native, iOS, Android, Flutter) — each nesting versions inside a dropdown — are converted to framework tabs carrying versions directly, i.e. Mintlify's supported "versions applied to a specific tab" pattern.

  • Before: SDK tab → dropdowns[framework] → versions[v5,v4] → groups
  • After: tabs[Calling, Platform, JavaScript, React Native, iOS, Android, Flutter, APIs, Webhooks], each framework tab → versions[v5,v4] → groups
  • No page paths changed — nav structure only.

The A/B

Chat & Messaging is intentionally left nested as the control. On the preview:

  • ✅ expected: Voice & Video pages open the version switcher without a 500
  • ❌ expected: Chat & Messaging pages still 500

If that split holds, the nesting is confirmed as the cause and we roll the tab → versions shape out site-wide.

Not verified locally

Local CLI is v4.2.234 (too old to reproduce the prod runtime). JSON is valid and broken-links is clean; the crash test can only run on this Mintlify preview.

🤖 Generated with Claude Code

Tests whether un-nesting versions from dropdowns stops the desktop
version-switcher 500 (React insertBefore crash in Mintlify's bundle).

Voice & Video Calling: the "SDK" tab's framework dropdowns (JavaScript,
React Native, iOS, Android, Flutter), which nested `versions` inside a
`dropdown` inside a `tab` (unsupported per Mintlify docs + discussion
#2168), are converted to framework tabs carrying `versions` directly —
Mintlify's supported "versions applied to a specific tab" pattern.

Chat & Messaging is intentionally left nested as the control. No page
paths changed; nav structure only. Not for merge.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant