docs: add formal definition for taints & tolerations (#830)

Azure · May 22, 2024 · f3e7289 · f3e7289
1 parent 5893c9c
commit f3e7289
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/docs/concepts/ClusterResourcePlacement/README.md b/docs/concepts/ClusterResourcePlacement/README.md
@@ -448,6 +448,10 @@ Events:
 
 ## Tolerations
 
+Tolerations are a mechanism to allow the Fleet Scheduler to schedule resources to a `MemberCluster` that has taints specified on it.
+We adopt the concept of [taints & tolerations](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/) 
+introduced in Kubernetes to the multi-cluster use case.
+
 The `ClusterResourcePlacement` CR supports the specification of list of tolerations, which are applied to the `ClusterResourcePlacement`
 object. Each Toleration object comprises the following fields:
 - `key`: The key of the toleration.

diff --git a/docs/concepts/MemberCluster/README.md b/docs/concepts/MemberCluster/README.md
@@ -50,6 +50,10 @@ namespaces on the hub cluster.
 
 ## Taints
 
+Taints are a mechanism to prevent the Fleet Scheduler from scheduling resources to a `MemberCluster`. We adopt the concept of 
+[taints and tolerations](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/) introduced in Kubernetes to 
+the multi-cluster use case.
+
 The `MemberCluster` CR supports the specification of list of taints, which are applied to the `MemberCluster`. Each Taint object comprises
 the following fields:
 - `key`: The key of the taint.