Skip to content

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

Merged
dcharles525 merged 2 commits into
mainfrom
chore/EPINIO-717_bump_docusaurus_version
Aug 26, 2026
Merged

chore(deps): upgrade Docusaurus from 2.0.1 to 3.10.2#494
dcharles525 merged 2 commits into
mainfrom
chore/EPINIO-717_bump_docusaurus_version

Conversation

@Hannahbird

Copy link
Copy Markdown
Contributor

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 0ce9181
🔍 Latest deploy log https://app.netlify.com/projects/epinio-docs-staging/deploys/6a8f5aee24367f000831c63f
😎 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

@dcharles525 dcharles525 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@dcharles525
dcharles525 merged commit 225ccfb into main Aug 26, 2026
4 checks passed
@dcharles525
dcharles525 deleted the chore/EPINIO-717_bump_docusaurus_version branch August 26, 2026 21:37
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