Further updates for Nahian

Author: aireilly

modules/ztp-enabling-workload-partitioning-sno.adoc

@@ -8,13 +8,18 @@
 
 Workload partitioning configures {product-title} services, cluster management workloads, and infrastructure pods to run on a reserved number of host CPUs.
 
-To configure workload partitioning with GitOps ZTP, you specify cluster management CPU resources using the `cpuset` field of the `SiteConfig` CR and the `reserved` field of the group `PolicyGenTemplate` CR.
+To configure workload partitioning with GitOps ZTP, you specify cluster management CPU resources with the `cpuset` field of the `SiteConfig` custom resource (CR) and the `reserved` field of the group `PolicyGenTemplate` CR.
 The GitOps ZTP pipeline uses these values to populate the required fields in the workload partitioning `MachineConfig` CR (`cpuset`) and the `PerformanceProfile` CR (`reserved`) that configure the {sno} cluster.
 
+[NOTE]
+====
+For maximum performance, ensure that the `reserved` and `isolated` CPU sets do not share CPU cores across NUMA zones.
+====
+
 * The workload partitioning `MachineConfig` CR pins the {product-title} infrastructure pods to a defined `cpuset` configuration.
 * The `PerformanceProfile` CR pins the systemd services to the reserved CPUs.
 
 [IMPORTANT]
 ====
-The value for the `reserved` field specified in the `PerformanceProfile` custom resource (CR) must match the `cpuset` field in the workload partitioning `MachineConfig` CR.
+The value for the `reserved` field specified in the `PerformanceProfile` CR must match the `cpuset` field in the workload partitioning `MachineConfig` CR.
 ====

snippets/ztp-performance-profile.adoc

@@ -31,9 +31,9 @@ spec:
 <2> Configures UEFI secure boot for the cluster host.
 <3> Set the isolated CPUs. Ensure all of the Hyper-Threading pairs match.
 +
-[NOTE]
+[IMPORTANT]
 ====
-The reserved and isolated CPU pools must not overlap and together must span all available cores.
+The reserved and isolated CPU pools must not overlap and together must span all available cores. CPU cores that are not accounted for cause an undefined behaviour in the system.
 ====
 <4> Set the reserved CPUs. When workload partitioning is enabled, system processes, kernel threads, and system container threads are restricted to these CPUs. All CPUs that are not isolated should be reserved.
 <5> Set the number of huge pages.