Merge pull request #57370 from jeana-redhat/OSDOCS-5555-move-MAPI-overview

jeana-redhat · web-flow · commit ee995ce5207d · 2023-03-29T14:43:10.000-04:00
[OSDOCS-5555]: Move MAPI overview to machine mgmt book overview
diff --git a/machine_management/creating_machinesets/creating-machineset-alibaba.adoc b/machine_management/creating_machinesets/creating-machineset-alibaba.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on Alibaba Cloud
 include::modules/machineset-yaml-alibaba.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-aws.adoc b/machine_management/creating_machinesets/creating-machineset-aws.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on AWS
 include::modules/machineset-yaml-aws.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-azure-stack-hub.adoc b/machine_management/creating_machinesets/creating-machineset-azure-stack-hub.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on Azure Stack Hub
 include::modules/machineset-yaml-azure-stack-hub.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-azure.adoc b/machine_management/creating_machinesets/creating-machineset-azure.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on Azure
 include::modules/machineset-yaml-azure.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-gcp.adoc b/machine_management/creating_machinesets/creating-machineset-gcp.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on GCP
 include::modules/machineset-yaml-gcp.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc b/machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a machine set custom resource on IBM Cloud
 include::modules/machineset-yaml-ibm-cloud.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-nutanix.adoc b/machine_management/creating_machinesets/creating-machineset-nutanix.adoc
@@ -11,9 +11,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 //[IMPORTANT] admonition for UPI
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-//Machine API overview
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 //Sample YAML for a compute machine set custom resource on Nutanix
 include::modules/machineset-yaml-nutanix.adoc[leveloffset=+1]
 
diff --git a/machine_management/creating_machinesets/creating-machineset-osp.adoc b/machine_management/creating_machinesets/creating-machineset-osp.adoc
@@ -10,8 +10,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 include::modules/machineset-yaml-osp.adoc[leveloffset=+1]
 
 include::modules/machineset-yaml-osp-sr-iov.adoc[leveloffset=+1]
diff --git a/machine_management/creating_machinesets/creating-machineset-rhv.adoc b/machine_management/creating_machinesets/creating-machineset-rhv.adoc
@@ -10,8 +10,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 include::modules/machineset-yaml-rhv.adoc[leveloffset=+1]
 
 include::modules/machineset-creating.adoc[leveloffset=+1]
diff --git a/machine_management/creating_machinesets/creating-machineset-vsphere.adoc b/machine_management/creating_machinesets/creating-machineset-vsphere.adoc
@@ -10,8 +10,6 @@ You can create a different compute machine set to serve a specific purpose in yo
 
 include::modules/machine-user-provisioned-limitations.adoc[leveloffset=+1]
 
-include::modules/machine-api-overview.adoc[leveloffset=+1]
-
 include::modules/machineset-yaml-vsphere.adoc[leveloffset=+1]
 
 include::modules/machineset-vsphere-required-permissions.adoc[leveloffset=+1]
diff --git a/machine_management/index.adoc b/machine_management/index.adoc
@@ -22,8 +22,9 @@ The Machine API Operator provisions the following resources:
 * `MachineAutoscaler`
 * `MachineHealthCheck`
 
-[discrete]
-[id="machine-mgmt-intro-managing-compute"]
+include::modules/machine-api-overview.adoc[leveloffset=+1]
+
+[id="machine-mgmt-intro-managing-compute_{context}"]
 == Managing compute machines
 
 As a cluster administrator, you can perform the following actions:
@@ -52,8 +53,7 @@ As a cluster administrator, you can perform the following actions:
 
 * Configure and deploy a xref:../machine_management/deploying-machine-health-checks.adoc#deploying-machine-health-checks[machine health check] to automatically fix damaged machines in a machine pool.
 
-[discrete]
-[id="machine-mgmt-intro-managing-control-plane"]
+[id="machine-mgmt-intro-managing-control-plane_{context}"]
 == Managing control plane machines
 
 As a cluster administrator, you can perform the following actions:
@@ -68,8 +68,7 @@ As a cluster administrator, you can perform the following actions:
 
 * Configure and deploy a xref:../machine_management/deploying-machine-health-checks.adoc#deploying-machine-health-checks[machine health check] to automatically recover unhealthy control plane machines.
 
-[discrete]
-[id="machine-mgmt-intro-autoscaling"]
+[id="machine-mgmt-intro-autoscaling_{context}"]
 == Applying autoscaling to an {product-title} cluster
 
 You can automatically scale your {product-title} cluster to ensure flexibility for changing workloads. To xref:../machine_management/applying-autoscaling.adoc#applying-autoscaling[autoscale] your cluster, you must first deploy a cluster autoscaler, and then deploy a machine autoscaler for each compute machine set.
@@ -78,13 +77,11 @@ You can automatically scale your {product-title} cluster to ensure flexibility f
 
 * The xref:../machine_management/applying-autoscaling.adoc#machine-autoscaler-about_applying-autoscaling[_machine autoscaler_] adjusts the number of machines in the compute machine sets that you deploy in your {product-title} cluster.
 
-[discrete]
-[id="machine-mgmt-intro-add-for-upi"]
+[id="machine-mgmt-intro-add-for-upi_{context}"]
 == Adding compute machines on user-provisioned infrastructure
 User-provisioned infrastructure is an environment where you can deploy infrastructure such as compute, network, and storage resources that host the {product-title}. You can xref:../machine_management//user_infra/adding-compute-user-infra-general.adoc#adding-compute-user-infra-general[add compute machines] to a cluster on user-provisioned infrastructure during or after the installation process.
 
-[discrete]
-[id="machine-mgmt-intro-add-rhel"]
+[id="machine-mgmt-intro-add-rhel_{context}"]
 == Adding RHEL compute machines to your cluster
 
 As a cluster administrator, you can perform the following actions:
diff --git a/modules/machine-api-overview.adoc b/modules/machine-api-overview.adoc
@@ -1,5 +1,6 @@
 // Module included in the following assemblies:
 //
+// * machine_management/index.adoc
 // * machine_management/creating_machinesets/creating-machineset-aws.adoc
 // * machine_management/creating_machinesets/creating-machineset-azure.adoc
 // * machine_management/creating_machinesets/creating-machineset-azure-stack-hub.adoc
@@ -27,16 +28,16 @@ Machine sets:: `MachineSet` resources are groups of compute machines. Compute ma
 +
 [WARNING]
 ====
-Control plane machines cannot be managed by compute machine sets. 
+Control plane machines cannot be managed by compute machine sets.
 
-Control plane machine sets provide management capabilities for supported control plane machines that are similar to what compute machine sets provide for compute machines. 
+Control plane machine sets provide management capabilities for supported control plane machines that are similar to what compute machine sets provide for compute machines.
 
 For more information, see “Managing control plane machines".
 ====
 
 The following custom resources add more capabilities to your cluster:
 
-Machine autoscaler:: The `MachineAutoscaler` resource automatically scales compute machines in a cloud. You can set the minimum and maximum scaling boundaries for nodes in a specified compute machine set, and the machine autoscaler maintains that range of nodes. 
+Machine autoscaler:: The `MachineAutoscaler` resource automatically scales compute machines in a cloud. You can set the minimum and maximum scaling boundaries for nodes in a specified compute machine set, and the machine autoscaler maintains that range of nodes.
 +
 The `MachineAutoscaler` object takes effect after a `ClusterAutoscaler` object exists. Both `ClusterAutoscaler` and `MachineAutoscaler` resources are made available by the `ClusterAutoscalerOperator` object.
 
diff --git a/modules/machineset-creating b/modules/machineset-creating
