ci(docs): Upgrade Docusaurus to 3.10.0, pin webpack dep and track docs/yarn.lock for deterministic CI runs (#2817)

* Upgrade docusaurus to `v3.10.0`.

* Pin webpack's version down for docusaurus to avoid unprecedented packing behaviors.

* Add/track `yarn.lock` for docs.

* Make sure required nested apps' lock files aren't ignored.

Author: awahab07

.gitignore

@@ -30,5 +30,8 @@ playground/playground.tsx
 .buildkite/buildkite.d.ts
 .buildkite/artifacts/
 
-# keep only top-level lock file
+# keep only top-level lock file unless a workspace manages its own install
 **/*/yarn.lock
+!.buildkite/yarn.lock
+!docs/yarn.lock
+!e2e/yarn.lock

docs/docusaurus.config.ts

@@ -32,7 +32,11 @@ const config: Config = {
   projectName: 'docusaurus', // Usually your repo name.
 
   onBrokenLinks: 'warn',
-  onBrokenMarkdownLinks: 'warn',
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you

docs/package.json

@@ -16,8 +16,8 @@
     "typecheck": "tsc -p ./tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.2.1",
-    "@docusaurus/preset-classic": "^3.2.1",
+    "@docusaurus/core": "^3.10.0",
+    "@docusaurus/preset-classic": "^3.10.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "docusaurus-lunr-search": "^3.3.2",
@@ -29,11 +29,14 @@
     "sass": "^1.69.5"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.2.1",
-    "@docusaurus/tsconfig": "^3.2.1",
-    "@docusaurus/types": "^3.2.1",
+    "@docusaurus/module-type-aliases": "^3.10.0",
+    "@docusaurus/tsconfig": "^3.10.0",
+    "@docusaurus/types": "^3.10.0",
     "typescript": "~5.5.3"
   },
+  "resolutions": {
+    "webpack": "5.105.1"
+  },
   "browserslist": {
     "production": [
       ">0.5%",