Merge pull request #15779 from jszczepkowski/hpa-docs

docs/proposals/autoscaling.md

@@ -31,6 +31,14 @@ Documentation for other releases can be found at
 
 <!-- END MUNGE: UNVERSIONED_WARNING -->
 
+---
+
+# WARNING:
+
+## This document is outdated. It is superseded by [the horizontal pod autoscaler design doc](../design/horizontal-pod-autoscaler.md).
+
+---
+
 ## Abstract
 
 Auto-scaling is a data-driven feature that allows users to increase or decrease capacity as needed by controlling the

docs/user-guide/horizontal-pod-autoscaling/README.md

@@ -120,7 +120,7 @@ controlled by the php-apache replication controller you created in the first ste
 Roughly speaking, the horizontal autoscaler will increase and decrease the number of replicas
 (via the replication controller) so as to maintain an average CPU utilization across all Pods of 50%
 (since each pod requests 200 milli-cores in [rc-php-apache.yaml](rc-php-apache.yaml), this means average CPU utilization of 100 milli-cores).
-See [here](../../../docs/proposals/horizontal-pod-autoscaler.md#autoscaling-algorithm) for more details on the algorithm.
+See [here](../../../docs/design/horizontal-pod-autoscaler.md#autoscaling-algorithm) for more details on the algorithm.
 
 We will create the autoscaler by executing the following command: