fix: version selector and upgrade Docusaurus to 3.9.2 #840
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
osterman
added
the
no-release
osterman
changed the title
Swizzle DocsVersionDropdownNavbarItem component to detect the version from the URL path rather than relying on activeDocContext.activeVersion, which was unreliable. Now the dropdown correctly shows "v1" when viewing v1 docs and "Latest" when viewing current docs. 🤖 Generated with Claude Code Co-Authored-By: Claude Haiku 4.5 <[email protected]>
- Upgrade Docusaurus from 3.4.0 to 3.9.2 - Update swizzled components to use new API imports from @docusaurus/plugin-content-docs/client instead of @docusaurus/theme-common/internal - Fix DocVersionBanner to show green tip for latest/current version - Fix version badge vertical alignment in breadcrumbs - Hide sponsor button on smaller screens (< 996px) - Update DocsVersionDropdownNavbarItem for new Docusaurus 3.9 API 🤖 Generated with Claude Code Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Change navbar items (Learn, Reference, Community, Support) from `to: '/path'` to `type: 'doc'` with `docId` to preserve version - Fix DocVersionBanner internal links to use versioned paths - Minor footer link trailing slash consistency 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
Add <!--truncate--> markers after the intro section in all blog posts that were missing them to eliminate Docusaurus build warnings. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
osterman
force-pushed
the
osterman/fix-version-selector
branch
from
e63e7d0 to
6bf9d92
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Changes
Version Dropdown Fix
DocsVersionDropdownNavbarItemcomponent to detect version from URL pathNavbar Version-Sticky Links
to: '/path'totype: 'doc'withdocId/v1/learn/instead of/learn/Docusaurus Upgrade (3.4.0 → 3.9.2)
@docusaurus/*packages to 3.9.2API Migration
Updated import paths in swizzled components from
@docusaurus/theme-common/internalto@docusaurus/plugin-content-docs/client:DocsVersionDropdownNavbarItem- addeduseHistorySelectorfor URL detectionDocVersionBanner-useDocsVersionhookDocVersionBadge-useDocsVersionhookDocCard-findFirstSidebarItemLink,useDocByIdhooksCategoryList-useDocsSidebar,useDocByIdhooksDocVersionBanner Fix
versionMetadata.isLastandversionMetadata.version === 'current'/v1/resources/version-identification/when on v1)UI Improvements
margin-bottom: 0.8remto version badgeTest Plan
🤖 Generated with Claude Code