[repo] Bump to Docusaurus 3.8

Author: andrewnicols

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,10 @@ const config = {
     tagline: 'Nurturing Moodle Developers',
     future: {
         experimental_faster: true,
+        v4: {
+            removeLegacyPostBuildHeadAttribute: true,
+            useCssCascadeLayers: true,
+        },
     },
 
     // url: 'https://develop.moodle.org',
@@ -139,6 +146,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",