tree 0de594a225903566fcb525a395e05ed24ab84d79
parent e9020e8d94e59d2d22f82453c64f7abeeb450799
author Dmitri Shuralyov <dmitshur@golang.org> 1587563778 -0400
committer Dmitri Shuralyov <dmitshur@golang.org> 1587669780 +0000

internal/history: rename Version to GoVer

Make it more clear that this type represents a Go-specific version,
rather than a version that follows the Semantic Versioning 2.0.0
specification. The type already has Go-specific methods, for example
IsMajor reports true for "1.14" and IsMinor reports true for "1.14.1".
This is consistent with the terminology used by Go releases, but
very surprising if considered from the perspective of semver.

Document some differences of the Go-specific version convention
compared to semver, and describe the X, Y, Z fields in more detail.

This change makes it viable to add a String method to GoVer type
documented to print a Go-specific version string, which will be
useful in more places in CL 229483.

For golang/go#32450.

Change-Id: If7482fdb4a739ff5b89b7133402d94412057f590
Reviewed-on: https://go-review.googlesource.com/c/website/+/229481
Reviewed-by: Carlos Amedee <carlos@golang.org>