OCPBUGS-35712:planning tips

Author: brendan-daly-red-hat

architecture/architecture-installation.adoc

@@ -12,6 +12,13 @@ include::modules/supported-platforms-for-openshift-clusters.adoc[leveloffset=+2]
 
 include::modules/installation-process.adoc[leveloffset=+2]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-etcd-practices.adoc#recommended-etcd-practices[Recommended etcd practices]
+
+* xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-control-plane-practices.adoc#master-node-sizing_recommended-control-plane-practices[Control plane node sizing]
+
 [discrete]
 === Installation scope
 

installing/overview/index.adoc

@@ -15,6 +15,10 @@ include::modules/installation-process.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
+* xref:../../scalability_and_performance/recommended-performance-scale-practices/recommended-etcd-practices.adoc#recommended-etcd-practices[Recommended etcd practices]
+
+* xref:../../scalability_and_performance/recommended-performance-scale-practices/recommended-control-plane-practices.adoc#master-node-sizing_recommended-control-plane-practices[Control plane node sizing]
+
 * link:https://access.redhat.com/labs/ocpnc/[Red Hat OpenShift Network Calculator]
 
 include::modules/ipi-verifying-nodes-after-installation.adoc[leveloffset=+2]

modules/installation-process.adoc

@@ -100,6 +100,11 @@ ifdef::openshift-origin[]
 image::150_OpenShift_VMware_on_AWS_1021_installer_FCOS.png[Creating bootstrap, control plane, and compute machines]
 endif::openshift-origin[]
 
+[IMPORTANT]
+====
+While planning to deploy your cluster, ensure that you are familiar with the recommended practices for performance and scalability, particularly the requirements for input/output (I/O) latency for etcd storage and the requirements for the recommended control plane node sizing. For more information, see “Recommended etcd practices” and “Control plane node sizing”.
+====
+
 After the cluster machines initialize, the bootstrap machine is destroyed. All clusters use the bootstrap process to initialize the cluster, but if you provision the infrastructure for your cluster, you must complete many of the steps manually.
 
 [IMPORTANT]