Updating to Docusaurus v3 (#4078)

docs/docs/deploy/credentials/athena.md

@@ -29,7 +29,7 @@ If you do not have the AWS CLI installed and authenticated, follow these steps:
 
 3. If your organization does not have SSO configured:
 
-    a. Follow the steps described under [How to create an AWS service account using the AWS Management Console](#how-to-create-an-aws-service-account-using-the-aws-management-console), which you will find below on this page.
+    a. Follow the steps described in [How to create an AWS service account using the AWS Management Console](./s3.md#how-to-create-an-aws-service-account-using-the-aws-management-console).
 
     b. Run the following command and provide the access key, access secret, and default region when prompted (you can leave the "Default output format" blank):
     ```

docs/docs/reference/project-files/themes.md

@@ -17,7 +17,7 @@ _**`colors`**_ - used to override the dashboard colors.
   - _**`secondary`**_ - overrides the secondary color in the dashboard. Applies to the loading spinner only as of now. Can have any hex (without the # character), [named colors](https://www.w3.org/TR/css-color-4/#named-colors) or hsl() formats.
 
 ## Example
-You can copy this directly into your <theme_name>.yaml file:
+You can copy this directly into your \<theme_name>.yaml file:
 ```yaml
 kind: theme
 colors:

docs/docusaurus.config.js

@@ -2,8 +2,9 @@
 // Note: type annotations allow type checking and IDEs autocompletion
 
 /* eslint @typescript-eslint/no-var-requires: "off" */
-const lightCodeTheme = require("prism-react-renderer/themes/github");
-const darkCodeTheme = require("prism-react-renderer/themes/dracula");
+const {themes} = require('prism-react-renderer');
+const lightCodeTheme = themes.github;
+const darkCodeTheme = themes.dracula;
 
 const def = require("redocusaurus");
 def;
@@ -155,6 +156,7 @@ const config = {
       prism: {
         theme: lightCodeTheme,
         darkTheme: darkCodeTheme,
+        additionalLanguages: ['bash', 'diff', 'json'],
       },
     }),
 

docs/package.json

@@ -8,21 +8,26 @@
     "docusaurus": "docusaurus "
   },
   "devDependencies": {
-    "@docusaurus/core": "2.4.3",
-    "@docusaurus/module-type-aliases": "2.4.3",
-    "@docusaurus/plugin-client-redirects": "2.4.3",
-    "@docusaurus/preset-classic": "2.4.3",
-    "@docusaurus/theme-mermaid": "2.4.3",
-    "@mdx-js/react": "^1.6.22",
-    "@tsconfig/docusaurus": "^1.0.5",
+    "@docusaurus/core": "3.1.1",
+    "@docusaurus/module-type-aliases": "3.1.1",
+    "@docusaurus/plugin-client-redirects": "3.1.1",
+    "@docusaurus/preset-classic": "3.1.1",
+    "@docusaurus/theme-mermaid": "3.1.1",
+    "@docusaurus/theme-common": "3.1.1",
+    "@mdx-js/react": "^3.0.0",
+    "@docusaurus/tsconfig": "3.1.1",
+    "@types/react": "^18.2.29",
     "clsx": "^1.1.1",
     "docusaurus-gtm-plugin": "^0.0.2",
-    "prism-react-renderer": "^1.3.3",
-    "react": "^17.0.2",
-    "react-dom": "^17.0.2",
-    "redocusaurus": "^1.1.2",
+    "prism-react-renderer": "^2.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "redocusaurus": "^2.0.0",
     "tailwindcss": "^3.0.23",
-    "typescript": "^4.6.4"
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=18.0"
   },
   "browserslist": {
     "production": [

docs/tsconfig.json

@@ -1,6 +1,6 @@
 {
   // This file is not used in compilation. It is here just for a nice editor experience.
-  "extends": "@tsconfig/docusaurus/tsconfig.json",
+  "extends": "@docusaurus/tsconfig",
   "compilerOptions": {
     "baseUrl": "."
   }