summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKubernetes Prow Robot <k8s-ci-robot@users.noreply.github.com>2021-06-16 09:20:00 -0700
committerGitHub <noreply@github.com>2021-06-16 09:20:00 -0700
commit1cc043a0b883960ef1cf0374f86b100fce0e4f66 (patch)
treebe99e9771ade4fb3b924e10dbb9c93e3c6f79495
parent519dd788becda03b6fc48c84854a7b653cace79b (diff)
parent1445c6177a079493d604bce411e412cd30ee2200 (diff)
Merge pull request #5825 from dims/add-guidance-on-SHA-vs-tags-in-dependencies
Add guidance on SHA vs tags in dependencies
-rw-r--r--contributors/devel/sig-architecture/vendor.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/contributors/devel/sig-architecture/vendor.md b/contributors/devel/sig-architecture/vendor.md
index d6db675c..e48d733b 100644
--- a/contributors/devel/sig-architecture/vendor.md
+++ b/contributors/devel/sig-architecture/vendor.md
@@ -34,6 +34,16 @@ The `go.mod` file in the root of `k8s.io/kubernetes` describes dependencies usin
* `require` directives list the preferred version of dependencies (this is auto-updated by go tooling to the maximum preferred version of the module)
* `replace` directives pin to specific tags or commits
+## Dependency versions
+
+As a project we prefer that all entries in `go.mod` should be tagged in their
+respective repositories. There may be exceptions that will be up to the
+dependency approvers to approve. If there are issues with go mod tooling itself
+then there has to be an explicit comment (trailing `// comment`) with details on
+exact tag/release that this SHA corresponds to. Also please ensure tracking
+issues are open to ensure these SHA(s) are cleaned up over time and switched
+over to tags.
+
## Adding or updating a dependency
The most common things people need to do with deps are add and update them.