From 4ec35f5ca6b8deb388f660da86bc0cb62fa82bff Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Thu, 5 Nov 2026 13:39:31 +0000 Subject: [PATCH] Clarify local Go toolchain selection --- docs/development.md | 8 ++++++++ docs/roadmap/implementation.md | 5 +++++ 2 files changed, 13 insertions(+) diff --git a/docs/development.md b/docs/development.md index 4b0e30e..36b19cd 100644 --- a/docs/development.md +++ b/docs/development.md @@ -58,6 +58,14 @@ exist. ## Maintainer Validation +Use the newest Go installation already available locally for ordinary +development checks. Put its `bin` directory first on `PATH` and set +`GOTOOLCHAIN=local` to keep that toolchain selected. For repository-isolated +checks, set `GOWORK=off`; consumers may use their own workspaces. The selected +validation patch does not by itself change the module's consumer minimum. See +the [release toolchain policy](policy/release.md#consumer-minimum-and-release-toolchain) +and [release procedure](release.md#prepare-the-candidate) for release selection. + For ordinary work, select validation proportionate to the change. Do not repeat successful checks for unchanged content merely to create a commit. During development, run relevant Go tests and vet, format changed Go files, and execute diff --git a/docs/roadmap/implementation.md b/docs/roadmap/implementation.md index ae1e580..7fb90dd 100644 --- a/docs/roadmap/implementation.md +++ b/docs/roadmap/implementation.md @@ -67,6 +67,11 @@ authorize pushing, tagging, publishing, or selecting a release version. No new installation, vulnerability gate, consumer advisory, or dependency update is needed for the assessed environment. +Completion: selected the locally available Go 1.27.3 toolchain (`go version +go1.27.3 linux/amd64`) with `GOTOOLCHAIN=local` and `GOWORK=off` for isolated +validation. The module minimum remains Go 1.27.0; contributor guidance now +describes local toolchain selection. + ## Stage 2: Remove Convenience Source Conversion **Catalog:** 3, 5. **Files:** `profiles.go`, `backends.go`, `provider_values.go`,