Skip to content

docs: customer mitigation — banner + direct-link versions page while version selector is broken - #460

Open
ketanyekale wants to merge 1 commit into
mainfrom
docs/version-switcher-mitigation
Open

docs: customer mitigation — banner + direct-link versions page while version selector is broken#460
ketanyekale wants to merge 1 commit into
mainfrom
docs/version-switcher-mitigation

Conversation

@ketanyekale

Copy link
Copy Markdown
Member

Why (customer-impacting incident)

The desktop version-selector dropdown on production crashes to Mintlify's "Error 500 / Error loading page" (client-side insertBefore crash in their bundle — platform bug, reported to Mintlify; see #457 for the full investigation). Customers currently cannot switch doc versions in the UI. Every versioned page URL still serves fine — only the switcher widget is broken.

What

  1. Site-wide dismissible warning banner: "The version selector is temporarily unavailable. Open any version directly →"
  2. /versions page (hidden — not in navigation, reachable by URL): direct links to every version of all 17 versioned dropdowns (UI Kits, Chat SDKs, Calls SDKs), generated from docs.json navigation.

Verification on preview

  • Banner renders on all pages and dismisses correctly
  • /versions loads and links resolve to the right per-framework version trees

Rollback

Revert this single commit once Mintlify fixes the selector.

🤖 Generated with Claude Code

…roken

The desktop version-selector dropdown crashes with Mintlify's client-side
insertBefore error (Error 500 page) — platform bug reported to Mintlify.
Customers cannot switch versions in the UI, but every versioned page URL
serves fine.

Mitigation until Mintlify ships a fix:
- dismissible site-wide warning banner linking to /versions
- versions.mdx: direct links to every version of every UI Kit / SDK
  (hidden page, not in navigation), generated from docs.json

Revert this commit once the selector works again.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cometchat 🟢 Ready View Preview Aug 7, 2026, 9:42 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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