diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-06-01 21:08:07 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-06-01 21:08:07 +0300 |
commit | d7ed3b4766871c30f50736c1d9eedc46c4035841 (patch) | |
tree | 72d0b5652364973c9bc3df5bf710a00fa1432b09 /doc/development/go_guide | |
parent | 711f8595324430e216ba62f874e7db9fdf482f73 (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/development/go_guide')
-rw-r--r-- | doc/development/go_guide/dependencies.md | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/development/go_guide/dependencies.md b/doc/development/go_guide/dependencies.md index a65e91869e3..b85344635c6 100644 --- a/doc/development/go_guide/dependencies.md +++ b/doc/development/go_guide/dependencies.md @@ -18,10 +18,10 @@ Prior to this, Go did not have any well-defined mechanism for version management While 3rd party version management tools existed, the default Go experience had no support for versioning. -Go modules use semantic versioning. The versions of a module are defined as VCS -tags that are valid semantic versions prefixed with `v`. For example, to release -version `1.0.0` of `gitlab.com/my/project`, the developer must create the Git -tag `v1.0.0`. +Go modules use [semantic versioning](https://semver.org). The versions of a +module are defined as VCS (version control system) tags that are valid semantic +versions prefixed with `v`. For example, to release version `1.0.0` of +`gitlab.com/my/project`, the developer must create the Git tag `v1.0.0`. For major versions other than 0 and 1, the module name must be suffixed with `/vX` where X is the major version. For example, version `v2.0.0` of @@ -38,6 +38,10 @@ end with a timestamp and the first 12 characters of the commit identifier: If a VCS tag matches one of these patterns, it is ignored. +For a complete understanding of Go modules and versioning, see [this series of +blog posts](https://blog.golang.org/using-go-modules) on the official Go +website. + ## 'Module' vs 'Package' - A package is a folder containing `*.go` files. |