Fix API doc and tolerance field handling when gate is flipped.

Kubernetes-commit: dc1696d8074edacf3e2d3857a5767eed66526386

Author: jm-franc

autoscaling/v2/types.go

@@ -211,6 +211,10 @@ type HPAScalingRules struct {
 	// replicas (e.g. 0.01 for 1%). Must be greater than or equal to zero. If not
 	// set, the default cluster-wide tolerance is applied (by default 10%).
 	//
+	// For example, if autoscaling is configured with a memory consumption target of 100Mi,
+	// and scale-down and scale-up tolerances of 5% and 1% respectively, scaling will be
+	// triggered when the actual consumption falls below 95Mi or exceeds 101Mi.
+	//
 	// This is an alpha field and requires enabling the HPAConfigurableTolerance
 	// feature gate.
 	//