Repository navigation
chore(docusaurus): upgrade Docusaurus to v3.10.1 and remove deprecated markdown link configuration warnings #532
Description
Summary
The build output currently shows:
- Docusaurus update available: 3.9.2 → 3.10.1
- Deprecated configuration warning for siteConfig.onBrokenMarkdownLinks
This results in noisy build logs and may cause issues when upgrading to Docusaurus v4.
Current Warning
Proposed Changes
Upgrade Docusaurus packages
- Update the following dependencies to the latest compatible version
- Migrate deprecated configuration
- Verify build output
Ensure:
- No deprecated configuration warnings are displayed
- Production build completes successfully
- All locales (en, zh-Hans) build successfully
- Terminal output remains clean
Acceptance Criteria
- Docusaurus upgraded from 3.9.2 to 3.10.1 (or latest stable version)
- onBrokenMarkdownLinks migrated to markdown.hooks.onBrokenMarkdownLinks
- No deprecation warnings during build
- Multi-locale build passes successfully
- CI/build pipeline remains green
No warning messages should appear in the terminal output.
Metadata
Metadata
Assignees
Labels
No labels
Activity
safiya2610 commentedon Jun 16, 2026
@yashisrani I'm taking this issue, I will make PR soon.
safiya2610 commentedon Jun 16, 2026
/assign
vanshika2720 commentedon Jun 16, 2026
@yashisrani I have raised a #533 PR for this . Please check it out
safiyanasir2610 commentedon Jun 16, 2026
@yashisrani #534 you can review my PR.
Why I changed the comment syntax:
Docusaurus v3 upgraded its engine to the stricter MDX v3 parser. The new parser treats old HTML comments () as invalid Javascript code and crashes the build, so they had to be updated to the proper MDX format ({/* */}) to keep the site running.