Skip to content

Upgrade Docusaurus to 3.10.2#384

Merged
tuhaihe merged 1 commit into
apache:mainfrom
tuhaihe:upgrade-docusaurus-version-3.10
Jul 17, 2026
Merged

Upgrade Docusaurus to 3.10.2#384
tuhaihe merged 1 commit into
apache:mainfrom
tuhaihe:upgrade-docusaurus-version-3.10

Conversation

@tuhaihe

@tuhaihe tuhaihe commented Jul 14, 2026

Copy link
Copy Markdown
Member

Upgrade @docusaurus/core, @docusaurus/preset-classic, @docusaurus/module-type-aliases, @docusaurus/plugin-client-redirects, @docusaurus/tsconfig, and @docusaurus/types to ^3.10.2.

Breaking changes addressed across 30 files:

  • Replace @theme/Unlisted with @theme/ContentVisibility in swizzled BlogPostPage, DocItem/Layout, and MDXPage components. ContentVisibility accepts a metadata prop and handles both unlisted and draft states.

  • Migrate imports from @docusaurus/theme-common/internal to plugin-specific client entry points (20+ swizzled components):

    • Docs hooks (useDoc, useDocsSidebar, DocProvider, etc.) now come from @docusaurus/plugin-content-docs/client.
    • Blog hooks (useBlogPost, BlogPostProvider, etc.) now come from @docusaurus/plugin-content-blog/client.
  • Update useGetNewBlogList hook: blog-archive JSON path changed from blog-archive-80c.json to p/blog-archive-f05.json [blocked]; data shape wrapped in archive key.

  • Move onBrokenMarkdownLinks to markdown.hooks per Docusaurus v4 migration path.

  • Add onUntruncatedBlogPosts: 'ignore' to suppress truncation warnings for existing blog posts.

Build verified: client and server compile successfully.

Assisted-by: Deepseek

closes: #ISSUE_Number


Change logs

Describe your change clearly, including what problem is being solved or what document is being added or updated.

Contributor's checklist

Here are some reminders before you submit your pull request:

Upgrade @docusaurus/core, @docusaurus/preset-classic,
@docusaurus/module-type-aliases, @docusaurus/plugin-client-redirects,
@docusaurus/tsconfig, and @docusaurus/types to ^3.10.2.

Breaking changes addressed across 30 files:

- Replace @theme/Unlisted with @theme/ContentVisibility in swizzled
  BlogPostPage, DocItem/Layout, and MDXPage components.
  ContentVisibility accepts a metadata prop and handles both unlisted
  and draft states.

- Migrate imports from @docusaurus/theme-common/internal to
  plugin-specific client entry points (20+ swizzled components):
  - Docs hooks (useDoc, useDocsSidebar, DocProvider, etc.) now come
    from @docusaurus/plugin-content-docs/client.
  - Blog hooks (useBlogPost, BlogPostProvider, etc.) now come from
    @docusaurus/plugin-content-blog/client.

- Update useGetNewBlogList hook: blog-archive JSON path changed from
  blog-archive-80c.json to p/blog-archive-f05.json [blocked]; data shape
  wrapped in archive key.

- Move onBrokenMarkdownLinks to markdown.hooks per Docusaurus v4
  migration path.

- Add onUntruncatedBlogPosts: 'ignore' to suppress truncation
  warnings for existing blog posts.

Build verified: client and server compile successfully.

Assisted-by: Deepseek
@tuhaihe
tuhaihe force-pushed the upgrade-docusaurus-version-3.10 branch from 739ba8d to 9f09955 Compare July 16, 2026 04:13
@tuhaihe
tuhaihe merged commit 07b8564 into apache:main Jul 17, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants