florianl
Align git tag with Go module version
In the past git tag versioning and Go module versioning diverged on this repository. As a result there are pitfalls to using this Go package.
-
Clarity and Consistency: Matching the Go module version with a Git tag creates a clear correspondence between the code and its version. This makes it easier for developers to understand exactly which code revision they are using.
-
Dependency Management: The go tool relies on Git tags to identify specific versions of Go modules. When the module version and Git tag are aligned, the go tool can effortlessly download and manage dependencies. This ensures everyone using your module gets the intended version.
-
Version Discovery: Proxy services like the Go proxy (https://proxy.golang.org/) use Git tags to discover new module versions. Aligning the versions allows for faster discovery and adoption of new releases by consumers of your module.
To start aligning git tags with Go module versions, the following changes are planned for May 2024::
Introduce a new major git tag
Use this new major git tag as Go module version
From this point onwards major git tags should always be aligned with Go module versions.
