Skip to content

feat: bump Docusaurus to 3.9.2 and improve container setup#50

Merged
lucaaamaral merged 4 commits into
magma:mainfrom
lucaaamaral:bump_docusaurus_v3.9
Feb 8, 2026
Merged

feat: bump Docusaurus to 3.9.2 and improve container setup#50
lucaaamaral merged 4 commits into
magma:mainfrom
lucaaamaral:bump_docusaurus_v3.9

Conversation

@lucaaamaral
Copy link
Copy Markdown
Collaborator

Summary

  • Upgrade all @Docusaurus packages from 3.7.0 to 3.9.2 to address deprecated transitive dependencies (rimraf@3, glob@7, inflight@1)
  • Upgrade base Node image from 22 to 24
  • Remove accidental duplicate file (quick_start_guide copy.md) in version-1.3.X that caused a conflicting doc id build failure
  • Merge COPY instructions for package.json and package-lock.json* into a single statement for Docker/Podman compatibility when the lockfile is absent
  • Increase dev service memory limit to 4g to prevent OOM kills during webpack compilation

Known issues

After upgrading to Docusaurus 3.9.2, the following deprecation warning appears and should be addressed in a follow-up:

  • siteConfig.onBrokenMarkdownLinks needs to move to siteConfig.markdown.hooks.onBrokenMarkdownLinks

There are also several broken markdown link warnings in older versioned docs (1.1.X through 1.8.0) referencing files that no longer exist.

Test plan

  • Run docker compose up dev and verify the site compiles and serves at localhost:3000
  • Verify no compilation errors (only warnings)
  • Confirm the container is not OOM-killed during compilation

Security Considerations

  • Docusaurus uses glob as npm dependency, the version upgrade also upgraded glob dependency which had known vulnerabilities.
  • Docusaurus uses inflight as npm dependency, the version upgrade also upgraded inflight dependency which had known memory leakage

The file "quick_start_guide copy.md" in version-1.3.X was an accidental
duplicate that produces a conflicting doc id with the original file.

Signed-off-by: Lucas Amaral <lucaaamaral@gmail.com>
Update all @Docusaurus packages to address deprecated transitive
dependencies (rimraf@3, glob@7, inflight@1).

Signed-off-by: Lucas Amaral <lucaaamaral@gmail.com>
Merge COPY for package.json and package-lock.json* into a single
instruction for compatibility with both Docker and Podman when the
lockfile is absent. Increase dev service memory limit to 4g to prevent
OOM kills during webpack compilation.

Signed-off-by: Lucas Amaral <lucaaamaral@gmail.com>
Signed-off-by: Lucas Amaral <lucaaamaral@gmail.com>
@lucaaamaral lucaaamaral merged commit edfd8ac into magma:main Feb 8, 2026
6 of 8 checks passed
@lucaaamaral lucaaamaral deleted the bump_docusaurus_v3.9 branch February 8, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant