Document owner ref restrictions explicitly (kubernetes#12543)

krmayankk · Mar 11, 2019 · 314d63f · 314d63f
1 parent f9f63bb
commit 314d63f
Showing 1 changed file with 8 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,14 @@ metadata:
   ...
 ```
 
+{{< note >}}
+Cross-namespace owner references is disallowed by design. This means: 
+1) Namespace-scoped dependents can only specify owners in the same namespace,
+and owners that are cluster-scoped.
+2) Cluster-scoped dependents can only specify cluster-scoped owners, but not
+namespace-scoped owners.
+{{< /note >}}
+
 ## Controlling how the garbage collector deletes dependents
 
 When you delete an object, you can specify whether the object's dependents are