OpenFn / OpenFn/docs

Update docusaurus to 3.10

Open
#768 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
23
Forks
20
Avg merge
3d 1h
Merged PRs (30d)
6

Description

Docusaurus 3.10 seems to throw an error on start

[INFO] Docusaurus version: 3.10.1
Node version: v24.15.0
[1] 
[1] [ERROR] TypeError: Cannot read properties of undefined (reading 'mdxCrossCompilerCache')
[1]     at createPagesMDXLoaderRule (/home/joe/repo/openfn/docs/node_modules/@docusaurus/plugin-content-pages/lib/index.js:31:78)
[1]     at Object.pluginContentPages [as plugin] (/home/joe/repo/openfn/docs/node_modules/@docusaurus/plugin-content-pages/lib/index.js:55:38)
[1]     at initializePlugin (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/server/plugins/init.js:91:61)
[1]     at async Promise.all (index 2)
[1]     at async initPluginsConfigs (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/server/plugins/init.js:118:22)
[1]     at async initPlugins (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/server/plugins/init.js:128:39)
[1]     at async externalCommand (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/commands/external.js:17:21)
[1]     at async createCLIProgram (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/commands/cli.js:153:9)
[1]     at async runCLI (/home/joe/repo/openfn/docs/node_modules/@docusaurus/core/lib/commands/cli.js:50:21)
[1]     at async file:///home/joe/repo/openfn/docs/node_modules/@docusaurus/core/bin/docusaurus.mjs:44:3
[1] [INFO] Docusaurus version: 3.10.1
[1] Node version: v24.15.0
Job [1], 'docusaurus generate-adaptors' has ended

Don't have time to resolve it now, but I would like a solution soon

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing docusaurus generate-adaptors and follow the reported failure through @docusaurus/plugin-content-pages/lib/index.js and @docusaurus/core/lib/server/plugins/init.js. The work is done when the documentation site starts without the mdxCrossCompilerCache TypeError and the command completes successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, node.js
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.