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

1 participant