From ba1d98eb00af28c135250092f2f311c737fdfcfb Mon Sep 17 00:00:00 2001 From: snomiao Date: Mon, 9 Mar 2026 13:23:06 +0000 Subject: [PATCH] docs: link TROUBLESHOOTING.md from CONTRIBUTING.md Cross-reference the troubleshooting guide from the development setup section so contributors discover it naturally. --- CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a284cfe311..9a08b1348f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -87,6 +87,10 @@ navigate to `http://:5173` (e.g. `http://192.168.2.20:5173` here), to > ⚠️ IMPORTANT: > The dev server will NOT load JavaScript extensions from custom nodes. Only core extensions (built into the frontend) will be loaded. This is because the shim system that allows custom node JavaScript to import frontend modules only works in production builds. Python custom nodes still function normally. See [Extension Development Guide](docs/extensions/development.md) for details and workarounds. And See [Extension Overview](docs/extensions/README.md) for extensions overview. +## Troubleshooting + +If you run into issues during development (e.g. `pnpm dev` hanging, TypeScript errors after pulling, lock file conflicts), see [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for common fixes. + ## Development Workflow ### Architecture Decision Records