docs: add bin-linking workaround to migration guide

npm skips bin-linking for workspace packages during install, so the
openedx CLI from frontend-base isn't available in node_modules/.bin.
Document the workaround.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: arbrandes

docs/how_tos/migrate-frontend-app.md

@@ -1036,7 +1036,7 @@ Then add the following scripts to ``package.json``:
 ```json
 "build:packages": "make build-packages",
 "clean:packages": "make clean-packages",
-"dev:site": "npm run dev",
+"dev:site": "make dev-site",
 "dev:packages": "make dev-packages",
 "watch:build": "nodemon --exec 'npm run build'",
 ```
@@ -1054,21 +1054,29 @@ TURBO = TURBO_TELEMETRY_DISABLED=1 turbo --dangerously-disable-package-manager-c
 turbo.json: turbo.site.json
 	cp $< $@
 
+# NPM doesn't bin-link workspace packages during install, so it must be done manually.
+bin-link:
+	[ -f packages/frontend-base/package.json ] && npm rebuild --ignore-scripts @openedx/frontend-base || true
+
 build-packages: turbo.json
 	$(TURBO) run build; rm -f turbo.json
+	$(MAKE) bin-link
 
 clean-packages: turbo.json
 	$(TURBO) run clean; rm -f turbo.json
 
-dev-packages: turbo.json
+dev-packages: build-packages turbo.json
 	$(TURBO) run watch:build dev:site; rm -f turbo.json
+
+dev-site: bin-link
+	npm run dev
 ```
 
 - ``watch:build`` uses ``nodemon`` to watch for source changes (as configured in ``nodemon.json``) and re-runs ``npm run build`` on each change.  Turbo runs this in each workspace package that defines it.
-- ``build:packages`` builds all workspace packages in dependency order (e.g., ``frontend-base`` before the app).
+- ``build:packages`` builds all workspace packages in dependency order (e.g., ``frontend-base`` before the app), then runs ``make bin-link`` to create missing bin links.  This is necessary because npm skips bin-linking for workspace packages during install, so without this step the ``openedx`` CLI won't be available in ``node_modules/.bin``.
 - ``clean:packages`` runs the ``clean`` script in each workspace package.
-- ``dev:site`` is an alias for ``npm run dev`` that turbo uses as a root-only task (``//#dev:site``).
-- ``dev:packages`` builds dependencies, then concurrently watches workspace packages for changes and starts the dev server.
+- ``dev:site`` is an alias for ``npm run dev`` that also bin-links the frontend-base bin files; turbo uses it as a root-only task (``//#dev:site``).
+- ``dev:packages`` depends on ``build-packages`` so the CLI is available before starting the watch, then concurrently watches workspace packages for changes and starts the dev server.
 
 The Makefile targets copy ``turbo.site.json`` to ``turbo.json`` before invoking turbo, then remove the copy afterward.  This ensures turbo finds its expected config when running standalone, without leaving a ``turbo.json`` that would conflict in a workspace context.  The ``--dangerously-disable-package-manager-check`` flag and ``TURBO_TELEMETRY_DISABLED=1`` are also set here, keeping turbo invocation details in one place.