Merge pull request #59378 from ahardin-rh/rearchitect-perfscale

OSDOCS-5749: Rearchitecture based on PerfScale content audit

Author: ahardin-rh

_topic_maps/_topic_map.yml

@@ -2598,7 +2598,17 @@ Dir: scalability_and_performance
 Distros: openshift-origin,openshift-enterprise,openshift-webscale,openshift-dpu
 Topics:
 - Name: Recommended performance and scalability practices
-  File: recommended-host-practices
+  Dir: recommended-performance-scale-practices
+  Distros: openshift-origin,openshift-enterprise
+  Topics:
+  - Name: Recommended control plane practices
+    File: recommended-control-plane-practices
+  - Name: Recommended infrastructure practices
+    File: recommended-infrastructure-practices
+  - Name: Recommended etcd practices
+    File: recommended-etcd-practices
+- Name: Planning your environment according to object maximums
+  File: planning-your-environment-according-to-object-maximums
   Distros: openshift-origin,openshift-enterprise
 - Name: Recommended host practices for IBM zSystems & IBM LinuxONE environments
   File: ibm-z-recommended-host-practices
@@ -2612,23 +2622,18 @@ Topics:
 - Name: Scheduling NUMA-aware workloads
   File: cnf-numa-aware-scheduling
   Distros: openshift-origin,openshift-enterprise
-- Name: Scaling the Cluster Monitoring Operator
-  File: scaling-cluster-monitoring-operator
+- Name: Scalability and performance optimization
+  Dir: optimization
   Distros: openshift-origin,openshift-enterprise
-- Name: Planning your environment according to object maximums
-  File: planning-your-environment-according-to-object-maximums
-  Distros: openshift-origin,openshift-enterprise
-- Name: Optimizing storage
-  File: optimizing-storage
-  Distros: openshift-origin,openshift-enterprise
-- Name: Optimizing routing
-  File: routing-optimization
-  Distros: openshift-origin,openshift-enterprise
-- Name: Optimizing networking
-  File: optimizing-networking
-  Distros: openshift-origin,openshift-enterprise
-- Name: Optimizing CPU usage
-  File: optimizing-cpu-usage
+  Topics:
+    - Name: Optimizing storage
+      File: optimizing-storage
+    - Name: Optimizing routing
+      File: routing-optimization
+    - Name: Optimizing networking
+      File: optimizing-networking
+    - Name: Optimizing CPU usage
+      File: optimizing-cpu-usage
 - Name: Managing bare metal hosts
   File: managing-bare-metal-hosts
   Distros: openshift-origin,openshift-enterprise

architecture/control-plane.adoc

@@ -56,7 +56,7 @@ include::modules/etcd-overview.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* xref:../scalability_and_performance/recommended-host-practices.adoc#recommended-etcd-practices_recommended-host-practices[Recommended etcd practices]
+* xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-etcd-practices.adoc#recommended-etcd-practices[Recommended etcd practices]
 * xref:../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backing-up-etcd[Backing up etcd]
 
 include::modules/hosted-control-planes-overview.adoc[leveloffset=+1]
@@ -72,4 +72,4 @@ include::modules/hosted-control-planes-version-support.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
 .Additional resources
-* For more information about the `HostedCluster` and `NodePool` resources, see the link:https://hypershift-docs.netlify.app/reference/api/[HyperShift API Reference].
+* For more information about the `HostedCluster` and `NodePool` resources, see the link:https://hypershift-docs.netlify.app/reference/api/[HyperShift API Reference].

getting_started/openshift-overview.adoc

@@ -102,7 +102,7 @@ be reviewed by cluster administrators and xref:../operators/admin/olm-adding-ope
 
 * **xref:../applications/pruning-objects.adoc#pruning-objects[Prune and reclaim resources]**: Reclaim space by pruning unneeded Operators, groups, deployments, builds, images, registries, and cron jobs.
 
-* **xref:../scalability_and_performance/scaling-cluster-monitoring-operator.adoc#scaling-cluster-monitoring-operator[Scale] and xref:../scalability_and_performance/using-node-tuning-operator.adoc#using-node-tuning-operator[tune] clusters**: Set cluster limits, tune nodes, scale cluster monitoring, and optimize networking, storage, and routes for your environment.
+* **xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-infrastructure-practices.adoc#scaling-cluster-monitoring-operator[Scale] and xref:../scalability_and_performance/using-node-tuning-operator.adoc#using-node-tuning-operator[tune] clusters**: Set cluster limits, tune nodes, scale cluster monitoring, and optimize networking, storage, and routes for your environment.
 
 * **xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
 

getting_started/openshift-web-console.adoc

@@ -46,7 +46,7 @@ include::modules/getting-started-web-console-examining-pod.adoc[leveloffset=+2]
 include::modules/getting-started-web-console-scaling-app.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
-* xref:../scalability_and_performance/recommended-host-practices.adoc#recommended-scale-practices_cluster-scaling[Recommended practices for scaling the cluster]
+* xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-control-plane-practices.adoc#recommended-scale-practices_cluster-scaling[Recommended practices for scaling the cluster]
 * xref:../nodes/pods/nodes-pods-autoscaling.adoc#nodes-pods-autoscaling-about_nodes-pods-autoscaling[Understanding horizontal pod autoscalers]
 * xref:../nodes/pods/nodes-pods-vertical-autoscaler.adoc#nodes-pods-vertical-autoscaler-about_nodes-pods-vertical-autoscaler[About the Vertical Pod Autoscaler Operator]
 

installing/installing_azure/installing-azure-account.adoc

@@ -23,7 +23,7 @@ include::modules/installation-azure-limits.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 include::modules/installation-azure-network-config.adoc[leveloffset=+1]
 
@@ -49,4 +49,4 @@ include::modules/installation-azure-regions.adoc[leveloffset=+1]
 * Install an {product-title} cluster on Azure. You can
 xref:../../installing/installing_azure/installing-azure-customizations.adoc#installing-azure-customizations[install a customized cluster]
 or
-xref:../../installing/installing_azure/installing-azure-default.adoc#installing-azure-default[quickly install a cluster] with default options.
+xref:../../installing/installing_azure/installing-azure-default.adoc#installing-azure-default[quickly install a cluster] with default options.

installing/installing_azure/installing-azure-user-infra.adoc

@@ -47,7 +47,7 @@ include::modules/installation-azure-limits.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage]
 
 include::modules/installation-azure-network-config.adoc[leveloffset=+2]
 

installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc

@@ -18,7 +18,7 @@ include::modules/installation-azure-limits.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+1]
 

installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc

@@ -46,7 +46,7 @@ include::modules/installation-azure-limits.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+2]
 

installing/installing_openstack/installing-openstack-installer-custom.adoc

@@ -14,7 +14,7 @@ In {product-title} version {product-version}, you can install a customized clust
 * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
 * You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
 * You verified that {product-title} {product-version} is compatible with your {rh-openstack} version by using the xref:../../architecture/architecture-installation.adoc#supported-platforms-for-openshift-clusters_architecture-installation[Supported platforms for OpenShift clusters] section. You can also compare platform support across different versions by viewing the link:https://access.redhat.com/articles/4679401[{product-title} on {rh-openstack} support matrix].
-* You have a storage service installed in {rh-openstack}, such as block storage (Cinder) or object storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* You have a storage service installed in {rh-openstack}, such as block storage (Cinder) or object storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 * You have the metadata service enabled in {rh-openstack}.
 
 include::modules/installation-osp-default-deployment.adoc[leveloffset=+1]

installing/installing_openstack/installing-openstack-installer-kuryr.adoc

@@ -17,7 +17,7 @@ In {product-title} version {product-version}, you can install a customized clust
 * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
 * You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
 * You verified that {product-title} {product-version} is compatible with your {rh-openstack} version by using the xref:../../architecture/architecture-installation.adoc#supported-platforms-for-openshift-clusters_architecture-installation[Supported platforms for OpenShift clusters] section. You can also compare platform support across different versions by viewing the link:https://access.redhat.com/articles/4679401[{product-title} on {rh-openstack} support matrix].
-* You have a storage service installed in {rh-openstack}, such as block storage (Cinder) or object storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+* You have a storage service installed in {rh-openstack}, such as block storage (Cinder) or object storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
 
 include::modules/installation-osp-about-kuryr.adoc[leveloffset=+1]
 include::modules/installation-osp-default-kuryr-deployment.adoc[leveloffset=+1]