From 315737613785cac8e8d7034c6ce6cd52de81aeb2 Mon Sep 17 00:00:00 2001
From: nikhiljindal <nikhiljindal@google.com>
Date: Thu, 24 Nov 2016 00:35:31 -0800
Subject: [PATCH] Adding documentation for cascading deletion of federated
 resources

---
 docs/user-guide/federation/index.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/user-guide/federation/index.md b/docs/user-guide/federation/index.md
index 9a8146d904..f30a5c6c64 100644
--- a/docs/user-guide/federation/index.md
+++ b/docs/user-guide/federation/index.md
@@ -46,3 +46,26 @@ The following guides explain some of the resources in detail:
 
 [API reference docs](/federation/docs/api-reference/readme/) lists all the
 resources supported by federation apiserver.
+
+## Cascading deletion
+
+Kubernetes version 1.5 includes support for cascading deletion of federated
+resources. With cascading deletion, when you delete a resource from the
+federation control plane, the corresponding resources in all underlying clusters
+are also deleted.
+
+To enable cascading deletion, set the option
+`DeleteOptions.orphanDependents=false` when you delete a resource from the
+federation control plane.
+
+The following Federated resources are affected by cascading deletion:
+
+* Ingress
+* Namespace
+* ReplicaSet
+* Secret
+* Deployment
+* DaemonSet
+
+Note: By default, deleting a resource from federation control plane does not
+delete the corresponding resources from underlying clusters.