-
-
Notifications
You must be signed in to change notification settings - Fork 38
chore: update Docusaurus to v3.9.1 and adjust dependencies versions #1014
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
✅ Deploy Preview for tolgee-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
@JanCizmar I don't have access to Algolia but from now we could activate DocSearch v4 with AskAI: https://docusaurus.io/blog/releases/3.9#docsearch-v4 |
6354617
to
44893e8
Compare
@dkrizan can you confirm we use node 20 on our server? |
Docusaurus is static side generator, so there is no Node on the server. Since it's built by Netlify, it will work. |
I just wanted to ask what Node version is used during the build process on Netlify? But now I see it's the newest.
…________________________________
Od: Jan Cizmar ***@***.***>
Wysłane: środa, 1 października 2025 16:22
Do: tolgee/documentation ***@***.***>
DW: Kamil Dzieniszewski ***@***.***>; Assign ***@***.***>
Temat: Re: [tolgee/documentation] chore: update Docusaurus to v3.9.1 and adjust dependencies versions (PR #1014)
[https://avatars.githubusercontent.com/u/18496315?s=20&v=4]JanCizmar left a comment (tolgee/documentation#1014)<#1014 (comment)>
Docusaurus is static side generator, so there is no Node on the server. Since it's built by Netlify, it will work.
—
Reply to this email directly, view it on GitHub<#1014 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AA23YWG4EUTOFTWKRKYCM3T3VPPR5AVCNFSM6AAAAACHSZUMTKVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTGNJWGU4TIMBTGI>.
You are receiving this because you were assigned.Message ID: ***@***.***>
|
44893e8
to
dd9cf4d
Compare
@JanCizmar we can turn on Algolia DocSearch v4 with AskAI in future PR as it require much more work |
That means that we can merge this? |
🚀 Upgrade Docusaurus to v3.9.1
Summary
This PR upgrades the Tolgee documentation site from Docusaurus 3.8.1 to 3.9.0, bringing performance improvements, new features, and important security updates.
📋 Changes Made
Core Package Updates
@docusaurus/*
packages from^3.8.1
to^3.9.1
@docusaurus/babel
,@docusaurus/core
,@docusaurus/mdx-loader
@docusaurus/plugin-content-docs
,@docusaurus/preset-classic
@docusaurus/theme-classic
,@docusaurus/theme-common
,@docusaurus/utils
@docusaurus/eslint-plugin
,@docusaurus/module-type-aliases
, etc.Dependency Updates
@typescript-eslint/eslint-plugin
:^8.39.0
→^8.44.1
@typescript-eslint/parser
:^8.39.0
→^8.44.1
axios
:^1.8.1
→^1.12.2
posthog-js
:^1.165.0
→^1.268.5
tsx
:^4.19.3
→^4.20.6
clsx
:^1.1.1
→^2.1.1
Configuration Updates
>=18.0
to>=20.0
(required for Docusaurus 3.9)docusaurus.config.ts
to use newmarkdown.hooks.onBrokenMarkdownLinks
format instead of deprecatedonBrokenMarkdownLinks
✨ New Features Available
🔍 Algolia DocSearch v4 with AskAI
@docsearch/react
and configuringthemeConfig.algolia.askAi
🌐 Enhanced i18n Support
i18n.localeConfigs[locale].{url,baseUrl}
options for complex multi-domain deploymentsi18n.localeConfigs[locale].translate
flag📊 Mermaid ELK Layout Support
@mermaid-js/layout-elk
dependency🚀 Performance Improvements
🔧 Technical Details
Breaking Changes
onBrokenMarkdownLinks
moved tomarkdown.hooks.onBrokenMarkdownLinks
Compatibility
🧪 Testing
npm run build
completes successfully with no errorsnpm start
runs correctly on localhost:3000📚 References
🎯 Impact
Note: This upgrade maintains full backward compatibility with existing content and configurations. The site will continue to function exactly as before, with improved performance and access to new optional features.