chore: align tutorial with the v1.0.0 release

This commit is contained in:
2026-09-09 10:10:40 -04:00
parent bc9d0a7865
commit c578342637
6 changed files with 31 additions and 29 deletions
+15 -14
View File
@@ -25,28 +25,29 @@ The starter demonstrates the boundary plainly:
time through `Server-Timing`.
- Production imports the Apache-2.0 `sando` runtime, not the compiler.
## Walk the path with RC.1
## Walk the path with v1.0.0
Install Go 1.25 or newer, then resolve the tiny runtime before installing the
immutable classroom compiler:
matching immutable compiler:
```sh
git clone https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial.git
cd sandwich-hime-tutorial
GOWORK=off go mod download gamertan.com/sandwich-hime/sando@v1.0.0-rc.1
go install gamertan.com/sandwich-hime/cmd/himesan@v1.0.0-rc.1
GOWORK=off go mod download gamertan.com/sandwich-hime/sando@v1.0.0
go install gamertan.com/sandwich-hime/cmd/himesan@v1.0.0
./scripts/verify.sh
GOWORK=off go run ./cmd/site
```
On Windows PowerShell, use the native verifier:
For a Windows portability check, use the PowerShell verifier. Windows is not a
maintained v1 target:
```powershell
git clone https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial.git
Set-Location sandwich-hime-tutorial
$env:GOWORK = "off"
go mod download gamertan.com/sandwich-hime/sando@v1.0.0-rc.1
go install gamertan.com/sandwich-hime/cmd/himesan@v1.0.0-rc.1
go mod download gamertan.com/sandwich-hime/sando@v1.0.0
go install gamertan.com/sandwich-hime/cmd/himesan@v1.0.0
.\scripts\verify.ps1
go run ./cmd/site
```
@@ -56,23 +57,23 @@ Make sure Go's install directory—normally `$(go env GOPATH)/bin`—is on
verifier. The starter deliberately runs with `GOWORK=off`: it proves the
application resolves the published Apache-2.0 runtime rather than a neighboring
development checkout. The verification scripts require compiler
`v1.0.0-rc.1` and runtime `v1.0.0-rc.1` exactly.
`v1.0.0` and runtime `v1.0.0` exactly.
If an earlier compiler-first attempt reports that the parent module does not
contain `gamertan.com/sandwich-hime/sando`, repair only that module selection:
```sh
GOWORK=off go mod download gamertan.com/sandwich-hime/sando@v1.0.0-rc.1
GOWORK=off go get gamertan.com/sandwich-hime/sando@v1.0.0-rc.1
GOWORK=off go mod download gamertan.com/sandwich-hime/sando@v1.0.0
GOWORK=off go get gamertan.com/sandwich-hime/sando@v1.0.0
```
Then run the verifier again. You do not need to clear your whole Go module
cache.
RC.1 freezes the intended v1 compiler/runtime contract while public dogfooding
and release-blocking corrections continue. Linux/amd64 and Apple Silicon
macOS/arm64 are maintained native targets. Useful compatibility reports remain
welcome on canonical Gitea.
The final v1 compiler/runtime pair follows the project's v1 compatibility
contract. Canonical Gitea tags and release announcements establish version
availability. Linux/amd64 and Apple Silicon macOS/arm64 are maintained native
targets. Useful compatibility reports remain welcome on canonical Gitea.
Open [http://127.0.0.1:8080/?name=Hime-san](http://127.0.0.1:8080/?name=Hime-san),
refresh it, and watch the request number and UTC time change. Then try: