From 549ae4d7e94a4ca38df86d179c0300fb07465e6e Mon Sep 17 00:00:00 2001 From: zacharysarah Date: Thu, 28 May 2020 14:01:43 -0700 Subject: [PATCH] Clarify permitted content --- content/en/docs/contribute/style/content-guide.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/content/en/docs/contribute/style/content-guide.md b/content/en/docs/contribute/style/content-guide.md index bc4b5be64a..b5d8ed5d02 100644 --- a/content/en/docs/contribute/style/content-guide.md +++ b/content/en/docs/contribute/style/content-guide.md @@ -32,9 +32,14 @@ project](https://github.com/kubernetes/kubernetes). ## What's allowed -Kubernetes docs permit only some kinds of content. +Kubernetes docs allow content for third-party projects only when: + +- Content documents software in the Kubernetes project +- Content documents software that's out of project but necessary for Kubernetes to function +- Content is canonical on kubernetes.io, or links to canonical content elsewhere ### Third party content + Kubernetes documentation includes applied examples of projects in the Kubernetes project—projects that live in the [kubernetes](https://github.com/kubernetes) and [kubernetes-sigs](https://github.com/kubernetes-sigs) GitHub organizations. @@ -43,7 +48,7 @@ Links to active content in the Kubernetes project are always allowed. Kubernetes requires some third party content to function. Examples include container runtimes (containerd, CRI-O, Docker), [networking policy](/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/) (CNI plugins), [Ingress controllers](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/), and [logging](https://kubernetes.io/docs/concepts/cluster-administration/logging/). -Docs can link to third-party open source software (OSS) outside the Kubernetes project if it's necessary for Kubernetes to function. +Docs can link to third-party open source software (OSS) outside the Kubernetes project only if it's necessary for Kubernetes to function. ### Dual sourced content