docs: add the Beta module-cache recovery

Publish the tested non-destructive recovery for users who install the parent compiler before the nested sando runtime.

This commit is an exact sanitized export from the private development record. Material drafting and review were assisted by OpenAI Codex; Cole Speelman reviewed the change and accepts human responsibility.

Signed-off-by: Cole Speelman <crspeelman@gmail.com>
This commit is contained in:
2026-08-12 15:21:42 -04:00
parent 532724baf7
commit e3a94fd16b
3 changed files with 11 additions and 2 deletions
+9
View File
@@ -72,6 +72,15 @@ Keep that runtime-first order for Beta 1. It avoids a Go module-cache ambiguity
between the parent compiler module and its nested runtime when both use the
same prerelease version.
If the compiler was installed first and `go get` reports that the parent module
does not contain `sando`, seed the exact nested module without clearing the
global cache, then retry:
```sh
go mod download gamertan.com/sandwich-hime/sando@v1.0.0-beta.1
go get gamertan.com/sandwich-hime/sando@v1.0.0-beta.1
```
For a reproducible one-off or classroom invocation that does not depend on the
learner's `PATH`: