[website] _content/doc/go1.26: add note for lower go mod init go directive version

3 views
Skip to first unread message

Michael Matloob (Gerrit)

unread,
Dec 20, 2025, 11:04:23 AM (yesterday) Dec 20
to goph...@pubsubhelper.golang.org, Dmitri Shuralyov, Go LUCI, golang-co...@googlegroups.com
Attention needed from Dmitri Shuralyov

New activity on the change

Open in Gerrit

Related details

Attention is currently required from:
  • Dmitri Shuralyov
Submit Requirements:
  • requirement is not satisfiedCode-Review
  • requirement satisfiedNo-Unresolved-Comments
  • requirement is not satisfiedReview-Enforcement
  • requirement is not satisfiedTryBots-Pass
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: comment
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: I4518c037238cd6316320e78381da76016a6a6964
Gerrit-Change-Number: 731720
Gerrit-PatchSet: 2
Gerrit-Owner: Michael Matloob <mat...@golang.org>
Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
Gerrit-Reviewer: Michael Matloob <mat...@golang.org>
Gerrit-Attention: Dmitri Shuralyov <dmit...@golang.org>
Gerrit-Comment-Date: Sat, 20 Dec 2025 16:04:19 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: No
unsatisfied_requirement
satisfied_requirement
open
diffy

Dmitri Shuralyov (Gerrit)

unread,
Dec 20, 2025, 12:30:48 PM (yesterday) Dec 20
to Michael Matloob, goph...@pubsubhelper.golang.org, Dmitri Shuralyov, Go LUCI, golang-co...@googlegroups.com
Attention needed from Michael Matloob

Dmitri Shuralyov voted and added 6 comments

Votes added by Dmitri Shuralyov

Code-Review+2

6 comments

Patchset-level comments
File-level comment, Patchset 2 (Latest):
Dmitri Shuralyov . resolved

Thanks. I left optional suggestions, but feel free to leave out any that don't work out well.

File _content/doc/go1.26.md
Line 53, Patchset 2 (Latest):`go mod init` now sets a lower `go` version in new `go.mod files`. `go mod init`
Dmitri Shuralyov . unresolved

Slighly misplaced \`? Probably should go be "`go.mod` files".

Line 53, Patchset 2 (Latest):`go mod init` now sets a lower `go` version in new `go.mod files`. `go mod init`
Dmitri Shuralyov . unresolved

(nit) Maybe s/sets/defaults to/ here, if that helps put slightly more emphasis on the fact that this is only the default initial value, and so whenever the default value isn't a good fit, users can set it to fit their needs.

Line 55, Patchset 2 (Latest):specifying the Go version `go 1.N-1.0`. Pre-release versions of `1.N` will
Dmitri Shuralyov . unresolved

Would it be more readable written as `go 1.(N-1).0`? Without brackets, it might be misread as a range between 1.N and 1.0.

Up to you, since adding brackets may have reduce readability in some other way. If you do change it here, also change it on the next line with N-2.

Line 57, Patchset 2 (Latest):release candidates will create `go.mod` files with `go 1.24.0` and releases
Dmitri Shuralyov . unresolved

Maybe expand to: ", Go 1.26.0 and its minors releases will ..."

Line 59, Patchset 2 (Latest):the creation of modules that are compatible with currently supported versions of Go.
Dmitri Shuralyov . unresolved

What do you think of adding a sentence after this as a remindinder of how it's easy to do `go mod init example.com && go get g...@1.26rc1` if there's ever a need to set the version explicitly? Something like:

For additional control over the `go` version in new modules, `go mod init` can be followed up with [`go get go@version`](https://go.dev/doc/toolchain#get).

Open in Gerrit

Related details

Attention is currently required from:
  • Michael Matloob
Submit Requirements:
  • requirement satisfiedCode-Review
  • requirement is not satisfiedNo-Unresolved-Comments
  • requirement is not satisfiedReview-Enforcement
  • requirement satisfiedTryBots-Pass
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: comment
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: I4518c037238cd6316320e78381da76016a6a6964
Gerrit-Change-Number: 731720
Gerrit-PatchSet: 2
Gerrit-Owner: Michael Matloob <mat...@golang.org>
Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
Gerrit-Reviewer: Michael Matloob <mat...@golang.org>
Gerrit-Attention: Michael Matloob <mat...@golang.org>
Gerrit-Comment-Date: Sat, 20 Dec 2025 17:30:44 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: Yes
satisfied_requirement
unsatisfied_requirement
open
diffy

Dmitri Shuralyov (Gerrit)

unread,
Dec 20, 2025, 12:34:00 PM (yesterday) Dec 20
to Michael Matloob, goph...@pubsubhelper.golang.org, Dmitri Shuralyov, Go LUCI, golang-co...@googlegroups.com
Attention needed from Michael Matloob

Dmitri Shuralyov voted Code-Review+1

Code-Review+1
Open in Gerrit

Related details

Attention is currently required from:
  • Michael Matloob
Submit Requirements:
  • requirement satisfiedCode-Review
  • requirement is not satisfiedNo-Unresolved-Comments
  • requirement is not satisfiedReview-Enforcement
  • requirement satisfiedTryBots-Pass
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: comment
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: I4518c037238cd6316320e78381da76016a6a6964
Gerrit-Change-Number: 731720
Gerrit-PatchSet: 2
Gerrit-Owner: Michael Matloob <mat...@golang.org>
Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
Gerrit-Reviewer: Michael Matloob <mat...@golang.org>
Gerrit-Attention: Michael Matloob <mat...@golang.org>
Gerrit-Comment-Date: Sat, 20 Dec 2025 17:33:57 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
satisfied_requirement
unsatisfied_requirement
open
diffy
Reply all
Reply to author
Forward
0 new messages