diff options
| author | Michael Taufen <mtaufen@google.com> | 2018-07-17 15:01:02 -0700 |
|---|---|---|
| committer | Michael Taufen <mtaufen@google.com> | 2018-07-18 07:12:32 -0700 |
| commit | 4a8ea25e172ba81d1f29e5900452de7dc126aadb (patch) | |
| tree | f52250581d2858b45fc01f715360b84a2cb0df00 | |
| parent | 6e31a546a50f6f57f3e9e1422ade0599f5e3e77d (diff) | |
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 |