Skip to content

chore(deps): upgrade Docusaurus from 2.0.1 to 3.10.2 - #494

Open
Hannahbird wants to merge 1 commit into
mainfrom
chore/EPINIO-717_bump_docusaurus_version
Open

chore(deps): upgrade Docusaurus from 2.0.1 to 3.10.2#494
Hannahbird wants to merge 1 commit into
mainfrom
chore/EPINIO-717_bump_docusaurus_version

Conversation

@Hannahbird

Copy link
Copy Markdown

The docs site was two major versions behind, carrying deprecated APIs and unpatched security advisories. Bump @docusaurus/core and preset-classic to 3.10.2 along with required peers (React 17→18, @mdx-js/react 1→3, prism-react-renderer 1→2).

Set markdown.format: 'detect' so the ~1,750 existing .md files keep parsing as plain CommonMark rather than risking MDX v3 breakage, limiting migration risk to the ~24 .mdx files. Move onBrokenMarkdownLinks under the new markdown.hooks config and update the prism-react-renderer theme import for its v2 API.

Verified with a full production build and a served smoke test across root, versioned, next, blog, and .mdx routes.

The docs site was two major versions behind, carrying deprecated APIs
and unpatched security advisories. Bump @docusaurus/core and
preset-classic to 3.10.2 along with required peers (React 17→18,
@mdx-js/react 1→3, prism-react-renderer 1→2).

Set markdown.format: 'detect' so the ~1,750 existing .md files keep
parsing as plain CommonMark rather than risking MDX v3 breakage,
limiting migration risk to the ~24 .mdx files. Move
onBrokenMarkdownLinks under the new markdown.hooks config and update
the prism-react-renderer theme import for its v2 API.

Verified with a full production build and a served smoke test across
root, versioned, next, blog, and .mdx routes.
@netlify

netlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploy Preview for epinio-docs-staging ready!

Name Link
🔨 Latest commit 571a6eb
🔍 Latest deploy log https://app.netlify.com/projects/epinio-docs-staging/deploys/6a74f033f72220c70bb2e79a
😎 Deploy Preview https://deploy-preview-494--epinio-docs-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Hannahbird
Hannahbird requested a review from dcharles525 August 6, 2026 19:38
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.

1 participant