Skip to content

docs: align Go floor to 1.26 across shipped docs (audit Block 8)#88

Merged
jcsvwinston merged 1 commit into
mainfrom
chore/docs-go-version-floor-1.26
May 31, 2026
Merged

docs: align Go floor to 1.26 across shipped docs (audit Block 8)#88
jcsvwinston merged 1 commit into
mainfrom
chore/docs-go-version-floor-1.26

Conversation

@jcsvwinston
Copy link
Copy Markdown
Owner

Summary

Resolves the final outstanding item from audit Block 8 (docs/audits/2026-05-29-exhaustive-audit.md): README go-version cross-check.

Five forward-looking shipped docs claimed Go 1.25+ as the minimum, but go.mod has carried go 1.26.3 since the Phase 4 scaffold pin (CHANGELOG line 36, nucleus new reproducible toolchain). A Go 1.25 user could not actually build Nucleus — the docs were lying. The version statements are corrected to Go 1.26+ (matches the go 1.26.3 directive in go.mod), and the TESTING_GUIDE plugin-build example's fixture go.mod is bumped to go 1.26 for consistency.

Files changed (+7/−6)

File Change
README.md:240 Go 1.25+Go 1.26+ (matches the go 1.26.3 directive in go.mod)
docs/QUICKSTART.md:10 same
CONTRIBUTING.md:10 same
docs/reference/DEVELOPER_MANUAL.md:49 same
docs/governance/ENTERPRISE_LONG_TERM_ROADMAP.md:435 same
docs/guides/TESTING_GUIDE.md:540 fixture go.mod go 1.25go 1.26
CHANGELOG.md [Unreleased] § Documentation entry

Historical CHANGELOG entries (lines 432/535/691) describing prior versions are untouched. The website's installation.md, CLAUDE.md, examples/mvc_api/README.md, and admin/BENCHMARKS.md already stated the correct floor.

Block 8 status after this PR

Test plan

  • CI Required Gate green (docs only — no code touched).

🤖 Generated with Claude Code

README, QUICKSTART, CONTRIBUTING, the Developer Manual, and the long-term
roadmap claimed Go 1.25+ as the minimum, but go.mod has carried go 1.26.3
since the Phase 4 scaffold pin — a Go 1.25 user could not build the
framework. Correct the five forward-looking docs to "Go 1.26+ (matches the
go 1.26.3 directive in go.mod)" and bump the TESTING_GUIDE plugin-build
example's fixture go.mod from go 1.25 to go 1.26 for consistency.

The website (installation.md), CLAUDE.md, examples/mvc_api/README.md, and
admin/BENCHMARKS.md already stated the correct floor. Historical CHANGELOG
entries (lines 432/535/691) remain untouched — they correctly describe
prior versions. No code or behaviour change. CHANGELOG [Unreleased] §
Documentation entry added.

Resolves audit Block 8 — README go-version cross-check
(docs/audits/2026-05-29-exhaustive-audit.md). Block 8's other items
(FW-6 CORS, OTH-1 examples map, OTH-2 CHANGELOG date) shipped in
earlier iterations.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jcsvwinston jcsvwinston merged commit 6ce4831 into main May 31, 2026
10 checks passed
@jcsvwinston jcsvwinston deleted the chore/docs-go-version-floor-1.26 branch May 31, 2026 16:50
jcsvwinston added a commit that referenced this pull request May 31, 2026
Block 8 / Go-version doc fix (audit OTH README go-version cross-check)
merged to main as 6ce4831 (PR #88), which closes the entire 2026-05-29
exhaustive audit (Blocks 1-8 all shipped via PRs #82, #86, #88). Archive
the iteration directly to docs/iterations/2026-05-29-block8-go-version-docs.md
(CURRENT_ITERATION.md was never scoped mid-flight for this small doc fix).
Record the completion and the audit-closed milestone in the decisions log,
remove the now-done Block 8 item from the maintainer backlog, and refresh
HANDOFF.md with the remaining candidate (modules.* env-layer override).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant