From 90db1d489518cc6cfa7dd527095e6b7f0aa88870 Mon Sep 17 00:00:00 2001
From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com>
Date: Sat, 30 May 2026 17:55:18 +0100
Subject: [PATCH] docs: drop stale `npm install -g rescript` + `npx
 rescript-legacy -w` refs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Follows panll#65 (npm→Deno migration) and panll#66 (docs sweep).

- docs/developer-guide.md: remove global rescript install step;
  ReScript is now resolved via deno.json `npm:rescript@^12.0.0` on first
  `deno task res:build`. Reword surrounding prose to reflect this.
- docs/guides/QUICKSTART-FOR-SON.md: `npx rescript-legacy -w` →
  `deno task res:watch`.

Surfaced by panll#66 meander.
---
 docs/developer-guide.md           | 5 ++---
 docs/guides/QUICKSTART-FOR-SON.md | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/developer-guide.md b/docs/developer-guide.md
index 8b5935a4..7212f0ed 100644
--- a/docs/developer-guide.md
+++ b/docs/developer-guide.md
@@ -91,11 +91,10 @@ source $HOME/.cargo/env
 curl -fsSL https://deno.land/x/install/install.sh | sh
 export DENO_INSTALL="/home/$USER/.deno"
 export PATH="$DENO_INSTALL/bin:$PATH"
-
-# Install ReScript
-npm install -g rescript
 ```
 
+ReScript is pinned in `deno.json` (`npm:rescript@^12.0.0`) and resolved on first `deno task res:build` — no global install required.
+
 ### Clone and Build
 
 ```bash
diff --git a/docs/guides/QUICKSTART-FOR-SON.md b/docs/guides/QUICKSTART-FOR-SON.md
index 9ec30c32..50264a3f 100644
--- a/docs/guides/QUICKSTART-FOR-SON.md
+++ b/docs/guides/QUICKSTART-FOR-SON.md
@@ -16,7 +16,7 @@ On top of these, there are **overlay panels** you can open from the panel bar (v
 cd ~/Documents/hyperpolymath-repos/panll
 
 # Terminal 1: Start the ReScript compiler (watches for changes)
-npx rescript-legacy -w
+deno task res:watch
 
 # Terminal 2: Bundle the JS and serve
 just bundle && just serve:dev