Document owner ref restrictions explicitly

kubernetes · Feb 7, 2019 · 351922b · 351922b
1 parent 47686e9
commit 351922b
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/content/en/docs/concepts/workloads/controllers/garbage-collection.md b/content/en/docs/concepts/workloads/controllers/garbage-collection.md
@@ -60,6 +60,13 @@ metadata:
   ...
 ```
 
+{{< note >}}
+Cross-namespace owner references is disallowed by design. This means:
+ * Namespace-scoped dependents can only have namespace-scoped owners in the same
+   namespace, or cluster-scoped owners.
+ * Cluster-scoped dependents can only have cluster-scoped owners.
+{{< /note >}}
+
 ## Controlling how the garbage collector deletes dependents
 
 When you delete an object, you can specify whether the object's dependents are