remove docusaurus machinery from main

preserving content

motivation: this clears the way to upgrade our eslint configuration to v9, which should hopefully let us update our custom rule configuration

currently, when attempting to frontport the next js website from v16 to main, we get eslint errors surrounding our custom rules. if we re-implement our custom rules according to the latest eslint configuration, it should make it easier

this change allows us to do that inter alia by removing the eslint typedoc plugin

.eslintignore

@@ -1,6 +1,5 @@
 # Copied from '.gitignore', please keep it in sync.
 /.eslintcache
-/.docusaurus
 /node_modules
 /reports
 /npmDist

.eslintrc.cjs

@@ -420,16 +420,9 @@ module.exports = {
         sourceType: 'module',
         project: ['tsconfig.json'],
       },
-      plugins: ['@typescript-eslint', 'eslint-plugin-tsdoc'],
+      plugins: ['@typescript-eslint'],
       extends: ['plugin:import/typescript'],
       rules: {
-        //////////////////////////////////////////////////////////////////////////
-        // `eslint-plugin-tsdoc` rule list based on `v0.3.x`
-        // https://github.com/microsoft/tsdoc/tree/master/eslint-plugin
-        //////////////////////////////////////////////////////////////////////////
-
-        'tsdoc/syntax': 'error',
-
         //////////////////////////////////////////////////////////////////////////
         // `@typescript-eslint/eslint-plugin` rule list based on `v8.4.x`
         //////////////////////////////////////////////////////////////////////////
@@ -750,12 +743,6 @@ module.exports = {
         'import/no-commonjs': 'off',
         'import/no-nodejs-modules': 'off',
         'import/no-extraneous-dependencies': 'off',
-        // Ignore docusarus related webpack aliases
-        'n/no-missing-import': 'off',
-        'import/no-unresolved': [
-          'error',
-          { ignore: ['^@theme', '^@docusaurus', '^@generated'] },
-        ],
       },
     },
   ],

.gitignore

@@ -8,7 +8,6 @@
 /diff-npm-package.html
 /.eslintcache
 /.cspellcache
-/.docusaurus
 /node_modules
 /reports
 /npmDist

.prettierignore

@@ -1,7 +1,6 @@
 # Copied from '.gitignore', please keep it in sync.
 /diff-npm-package.html
 /.eslintcache
-/.docusaurus
 /node_modules
 /reports
 /npmDist

package.json

@@ -45,9 +45,6 @@
     "precommit": "lint-staged",
     "check:spelling": "cspell --cache --no-progress \"**/*\"",
     "check:integrations": "mocha --full-trace resources/integration-test.ts",
-    "serve": "docusaurus serve --dir websiteDist/ --config website/docusaurus.config.cjs",
-    "start": "npm run build:website && npm run serve",
-    "build:website": "node --loader ts-node/esm resources/build-docusaurus.ts",
     "build:npm": "node --loader ts-node/esm resources/build-npm.ts",
     "build:deno": "node --loader ts-node/esm resources/build-deno.ts",
     "diff:npm": "node --loader ts-node/esm resources/diff-npm-package.ts",
@@ -56,10 +53,6 @@
     "prepare": "husky"
   },
   "devDependencies": {
-    "@docusaurus/core": "3.5.2",
-    "@docusaurus/preset-classic": "3.5.2",
-    "@mdx-js/react": "3.0.1",
-    "@svgr/webpack": "8.1.0",
     "@types/chai": "4.3.19",
     "@types/mocha": "10.0.7",
     "@types/node": "22.7.7",
@@ -69,26 +62,18 @@
     "chai": "5.1.1",
     "clsx": "2.1.1",
     "cspell": "8.14.2",
-    "docusaurus-plugin-typedoc-api": "4.4.0",
     "eslint": "8.57.0",
     "eslint-plugin-import": "2.30.0",
     "eslint-plugin-n": "17.10.2",
     "eslint-plugin-react": "7.35.2",
     "eslint-plugin-react-hooks": "4.6.2",
     "eslint-plugin-simple-import-sort": "12.1.1",
-    "eslint-plugin-tsdoc": "0.3.0",
-    "file-loader": "6.2.0",
     "husky": "^9.1.6",
     "lint-staged": "^15.2.10",
     "mocha": "10.7.3",
     "prettier": "3.3.3",
-    "prism-react-renderer": "2.4.0",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
     "ts-node": "10.9.2",
-    "typedoc": "0.26.6",
-    "typescript": "5.4.5",
-    "url-loader": "4.1.1"
+    "typescript": "5.4.5"
   },
   "publishConfig": {
     "tag": "alpha"