diff options
| author | k8s-ci-robot <k8s-ci-robot@users.noreply.github.com> | 2018-07-18 07:28:20 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-07-18 07:28:20 -0700 |
| commit | 8f278c6652c80752c4db59c864a9f2cb871feb1b (patch) | |
| tree | 09bd0b9b230c770f3137655d7098d5299a516ea0 | |
| parent | e19a5abbf349a5638828fa37659e04bab7e07498 (diff) | |
| parent | 4a8ea25e172ba81d1f29e5900452de7dc126aadb (diff) | |
Merge pull request #2379 from mtaufen/kube-namespace-prefix
explicitly reserve kube- prefix for system namespaces
| -rw-r--r-- | contributors/devel/api-conventions.md | 7 |
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 |
