Merge pull request #1365 from andrewnicols/docusaurus3.8

[repo] Bump to Docusaurus 3.8

Author: andrewnicols

.github/workflows/fetch-obsolete-pages.yml

@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version-file: '.nvmrc'
           cache: yarn
 
       - name: Install dependencies

.github/workflows/lint-pr.yml

@@ -21,7 +21,8 @@ jobs:
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
-          node-version: "18"
+          node-version-file: '.nvmrc'
+          cache: yarn
 
       - name: Install dependencies
         run: yarn install --immutable

.github/workflows/markdown-lint.yml

@@ -13,7 +13,8 @@ jobs:
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
-          node-version: "18"
+          node-version-file: '.nvmrc'
+          cache: yarn
 
       - name: Install dependencies
         run: yarn install --immutable

.github/workflows/test-deploy.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version-file: '.nvmrc'
           cache: yarn
 
       - name: Install dependencies

.github/workflows/update-moodle-metadata.yml

@@ -26,7 +26,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version-file: '.nvmrc'
           cache: yarn
 
       - name: Install dependencies

.github/workflows/update-wikimedia.yml

@@ -22,7 +22,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version-file: '.nvmrc'
           cache: yarn
 
       - name: Install dependencies

docs/apis/core/reportbuilder/index.md

@@ -606,7 +606,7 @@ This would cause the report to return results for users with the first name of _
 
 The stress test uses helper methods which:
 
-- Add and remove every colum individually from a report and ensures that is still returns data without error, it also tests the column can be sorted if that has been enabled.
+- Add and remove every column individually from a report and ensures that is still returns data without error, it also tests the column can be sorted if that has been enabled.
 - Individually aggregates a report on each column
 - Individually applies each filter
 

docusaurus.config.js

@@ -43,7 +43,10 @@ const remarkPlugins = [
     UnversionedDocsLinksRemark,
 ];
 
+// See https://docs.netlify.com/configure-builds/environment-variables/
 const isDeployPreview = !!process.env.NETLIFY && process.env.CONTEXT === 'deploy-preview';
+const isNetlifyProductionDeployment = process.env.NETLIFY && process.env.CONTEXT === 'production';
+const isProductionDeployment = isNetlifyProductionDeployment;
 
 const getBaseUrl = () => {
     if (typeof process.env.BASEURL !== 'undefined') {
@@ -60,6 +63,7 @@ const config = {
     tagline: 'Nurturing Moodle Developers',
     future: {
         experimental_faster: true,
+        v4: true,
     },
 
     // url: 'https://develop.moodle.org',
@@ -139,6 +143,19 @@ const config = {
     }),
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     plugins: [
+        function disableExpensiveBundlerOptimizationPlugin() {
+            // As documented in https://github.com/facebook/docusaurus/discussions/11199.
+            return {
+                name: 'disable-expensive-bundler-optimizations',
+                configureWebpack(_config, isServer) {
+                    return {
+                        optimization: {
+                            concatenateModules: isProductionDeployment ? !isServer : false,
+                        },
+                    };
+                },
+            };
+        },
         [
             '@docusaurus/plugin-content-docs',
             {

package.json

@@ -32,11 +32,11 @@
     "spell": "cspell '*.md' '*.mdx' '**/*.md' '**/*.mdx' 'docs/*.md' 'docs/*.mdx' 'docs/**/*.md' 'docs/**/*.mdx' 'general/*.md' 'general/*.mdx' 'general/**/*.md' 'general/**/*.mdx'"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.7.0",
-    "@docusaurus/faster": "^3.7.0",
-    "@docusaurus/plugin-pwa": "^3.7.0",
-    "@docusaurus/preset-classic": "^3.7.0",
-    "@docusaurus/theme-mermaid": "^3.7.0",
+    "@docusaurus/core": "^3.8.0",
+    "@docusaurus/faster": "^3.8.0",
+    "@docusaurus/plugin-pwa": "^3.8.0",
+    "@docusaurus/preset-classic": "^3.8.0",
+    "@docusaurus/theme-mermaid": "^3.8.0",
     "@emotion/react": "^11.10.5",
     "@emotion/styled": "^11.10.5",
     "@mdx-js/react": "^3.0.0",

src/components/HomepageFeatures/styles.module.css

@@ -16,10 +16,7 @@
 
 .feature-link {
   position: absolute;
-  top: 0;
-  right: 0;
-  bottom: 0;
-  left: 0;
+  inset: 0;
   z-index: 1;
   content: "";
 }
@@ -31,7 +28,7 @@
 }
 
 .card {
-  flex: 0 0 30%;
+  flex: 0 0 var(--ifm-col-width);
   padding: 1rem;
   max-width: none;
 }