Update to Docusaurus 3.1 (built-in broken anchor detection) (#346)

Author: mellson

docusaurus.config.js

@@ -12,6 +12,7 @@ const config = {
   url: 'https://stately.ai',
   baseUrl: '/',
   baseUrlIssueBanner: false,
+  onBrokenAnchors: 'warn',
   onBrokenLinks: 'warn',
   onBrokenMarkdownLinks: 'warn',
   favicon: 'icon.svg',

package.json

@@ -3,37 +3,17 @@
   "version": "0.1.0",
   "repository": "https://github.com/statelyai/docs",
   "scripts": {
-    "docusaurus": "docusaurus",
-    "remark:once": "yarn remark --quiet --frail docs/**/* versioned_docs/**/*",
-    "remark:watch": "yarn remark --quiet --frail --watch docs/**/* versioned_docs/**/*",
     "dev": "docusaurus start",
-    "start": "concurrently \"yarn remark:watch\" \"yarn typecheck:watch\" \"docusaurus start\"",
-    "check-links": "yarn remark:once && yarn typecheck",
     "build": "docusaurus build",
-    "swizzle": "docusaurus swizzle",
-    "deploy": "docusaurus deploy",
     "clear": "docusaurus clear",
     "serve": "docusaurus serve",
-    "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids",
-    "typecheck": "tsc",
     "format": "prettier --write '**/*.{js,jsx,ts,tsx,md,mdx,json}'"
   },
-  "remarkConfig": {
-    "plugins": [
-      [
-        "remark-validate-links",
-        {
-          "repository": false
-        }
-      ]
-    ]
-  },
   "dependencies": {
-    "@docusaurus/core": "^3.0.1",
-    "@docusaurus/plugin-client-redirects": "^3.0.1",
-    "@docusaurus/preset-classic": "^3.0.1",
-    "@docusaurus/remark-plugin-npm2yarn": "^3.0.1",
+    "@docusaurus/core": "^3.1.0",
+    "@docusaurus/plugin-client-redirects": "^3.1.0",
+    "@docusaurus/preset-classic": "^3.1.0",
+    "@docusaurus/remark-plugin-npm2yarn": "^3.1.0",
     "@headlessui/react": "^1.7.17",
     "@mdx-js/react": "^3.0.0",
     "@microsoft/api-extractor": "^7.38.3",
@@ -56,15 +36,13 @@
     "xstate": "^4.38.3"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.0.1",
-    "@docusaurus/tsconfig": "^3.0.1",
-    "@docusaurus/types": "^3.0.1",
+    "@docusaurus/module-type-aliases": "^3.1.0",
+    "@docusaurus/tsconfig": "^3.1.0",
+    "@docusaurus/types": "^3.1.0",
     "@fec/remark-a11y-emoji": "^4.0.2",
     "concurrently": "^8.2.2",
     "docusaurus-plugin-typedoc-api": "^4.0.1",
     "dotenv": "^16.3.1",
-    "remark-cli": "^12.0.0",
-    "remark-validate-links": "^13.0.0",
     "typescript": "^5.3.2"
   },
   "browserslist": {