From 4a8ea25e172ba81d1f29e5900452de7dc126aadb Mon Sep 17 00:00:00 2001 From: Michael Taufen Date: Tue, 17 Jul 2018 15:01:02 -0700 Subject: explicitly reserve kube- prefix for system namespaces --- contributors/devel/api-conventions.md | 7 +++++++ 1 file changed, 7 insertions(+) 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 -- cgit v1.2.3