Bug 1748433, added docs for increasing kubelet qps

modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc

@@ -61,6 +61,28 @@ spec:
     maxPods: 500
 ----
 +
+The rate at which the kubelet talks to the API server depends on queries per
+second (QPS) and burst values. The default values, `5` for `kubeAPIQPS` and `10`
+for `kubeAPIBurst`, are good enough if there are limited pods running on each
+node. Updating the kubelet QPS and burst rates is recommended if there are
+enough CPU and memory resources on the node:
++
+[source,yaml]
+----
+apiVersion: machineconfiguration.openshift.io/v1
+kind: KubeletConfig
+metadata:
+  name: set-max-pods
+spec:
+  machineConfigPoolSelector:
+    matchLabels:
+      custom-kubelet: large-pods
+  kubeletConfig:
+    maxPods: <pod_count>
+    kubeAPIBurst: <burst_rate>
+    kubeAPIQPS: <QPS>
+----
++
 .. Run:
 +
 ----

scalability_and_performance/recommended-host-practices.adoc

@@ -9,10 +9,10 @@ This topic provides recommended host practices for {product-title}.
 
 include::modules/recommended-node-host-practices.adoc[leveloffset=+1]
 
-include::modules/master-node-sizing.adoc[leveloffset=+1]
-
 include::modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc[leveloffset=+1]
 
+include::modules/master-node-sizing.adoc[leveloffset=+1]
+
 include::modules/recommended-etcd-practices.adoc[leveloffset=+1]
 
 == Additional resources