Update Docusaurus to version 3.9.2 (#126)

* Update Docusaurus to version 3.9.2
* Update OpenAPI docs plugin to version 4.5.1
* Change Node.js version in docs

Author: denniskuijs

.github/workflows/ci_cd.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
-          node-version: '18'
+          node-version: '20'
           cache: 'yarn'
           cache-dependency-path: yarn.lock
 

docs/developer-guide/preparing-the-environment.md

@@ -34,7 +34,7 @@ For development you need the following in addition to the runtime tooling:
 
 * Java 21 JDK ([OpenJDK](https://openjdk.java.net/), [Oracle Java SE JDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html))
 * [Git](https://git-scm.com/downloads)
-* [NodeJS](https://nodejs.org/en/download/current/) (>=18.12.0, on macOS you can use [Homebrew](https://brew.sh/) and `brew install node@18`)
+* [NodeJS](https://nodejs.org/en/download/current/) (>=20.0, on macOS you can use [Homebrew](https://brew.sh/) and `brew install node@20`)
 * [yarn](https://yarnpkg.com/getting-started/install) `corepack enable; yarn init -2` (>=3.2.0)
 
 Ensure the following commands execute successfully:

docs/quick-start.md

@@ -31,7 +31,7 @@ certificate, see [here](https://www.technipages.com/google-chrome-bypass-your-co
 Username: admin
 Password: secret
 
-### Changing host and/or port
+### Changing host
 The URL you use to access the system is important, the default is configured as `https://localhost` if you are using a VM then you will need to set the `OR_HOSTNAME` environment variable, so if for example you will be accessing using `https://192.168.1.1` then use the following startup command:
 
 BASH: 

package.json

@@ -19,24 +19,24 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.7.0",
-    "@docusaurus/preset-classic": "^3.7.0",
-    "@docusaurus/theme-mermaid": "3.7.0",
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/preset-classic": "^3.9.2",
+    "@docusaurus/theme-mermaid": "3.9.2",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
-    "docusaurus-plugin-openapi-docs": "4.3.6",
-    "docusaurus-theme-openapi-docs": "4.3.6",
+    "docusaurus-plugin-openapi-docs": "4.5.1",
+    "docusaurus-theme-openapi-docs": "4.5.1",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.7.0",
-    "@docusaurus/plugin-content-docs": "^3.7.0",
-    "@docusaurus/theme-common": "^3.7.0",
-    "@docusaurus/tsconfig": "^3.7.0",
-    "@docusaurus/types": "^3.7.0",
-    "@types/react": "^18",
+    "@docusaurus/module-type-aliases": "^3.9.2",
+    "@docusaurus/plugin-content-docs": "^3.9.2",
+    "@docusaurus/theme-common": "^3.9.2",
+    "@docusaurus/tsconfig": "^3.9.2",
+    "@docusaurus/types": "^3.9.2",
+    "@types/react": "^19",
     "typescript": "~5.6.2"
   },
   "browserslist": {
@@ -52,7 +52,7 @@
     ]
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "packageManager": "yarn@4.4.1"
 }

versioned_docs/version-1.2.0/rest-api/clear-events.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";

versioned_docs/version-1.2.0/rest-api/create-alarm.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";

versioned_docs/version-1.2.0/rest-api/create-asset-ruleset.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";

versioned_docs/version-1.2.0/rest-api/create-asset.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";

versioned_docs/version-1.2.0/rest-api/create-dashboard.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";

versioned_docs/version-1.2.0/rest-api/create-global-ruleset.api.mdx

@@ -17,7 +17,7 @@ import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
 import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
 import MimeTabs from "@theme/MimeTabs";
 import ParamsItem from "@theme/ParamsItem";
-import ResponseSamples from "@theme/ResponseSamples";
+import ResponseSamples from "@theme/CodeSamples";
 import SchemaItem from "@theme/SchemaItem";
 import SchemaTabs from "@theme/SchemaTabs";
 import Heading from "@theme/Heading";