summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authork8s-ci-robot <k8s-ci-robot@users.noreply.github.com>2018-07-18 07:28:20 -0700
committerGitHub <noreply@github.com>2018-07-18 07:28:20 -0700
commit8f278c6652c80752c4db59c864a9f2cb871feb1b (patch)
tree09bd0b9b230c770f3137655d7098d5299a516ea0
parente19a5abbf349a5638828fa37659e04bab7e07498 (diff)
parent4a8ea25e172ba81d1f29e5900452de7dc126aadb (diff)
Merge pull request #2379 from mtaufen/kube-namespace-prefix
explicitly reserve kube- prefix for system namespaces
-rw-r--r--contributors/devel/api-conventions.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/contributors/devel/api-conventions.md b/contributors/devel/api-conventions.md
index 0371f802..ad9b2c5a 100644
--- a/contributors/devel/api-conventions.md
+++ b/contributors/devel/api-conventions.md
@@ -1152,6 +1152,13 @@ be ambiguous and they are not specified by the value or value type.
* The name of a field expressing a boolean property called 'fooable' should be
called `Fooable`, not `IsFooable`.
+### Namespace Names
+* The name of a namespace must be a
+[DNS_LABEL](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/identifiers.md).
+* The `kube-` prefix is reserved for Kubernetes system namespaces, e.g. `kube-system` and `kube-public`.
+* See
+[the namespace docs](https://kubernetes.io/docs/user-guide/namespaces/) for more information.
+
## Label, selector, and annotation conventions
Labels are the domain of users. They are intended to facilitate organization and