OSDOCS-17043_1:CQA update

Author: brendan-daly-red-hat

modules/machineset-aws-existing-placement-group.adoc

@@ -49,21 +49,24 @@ spec:
     spec:
       providerSpec:
         value:
-          instanceType: <supported_instance_type> # <1>
-          networkInterfaceType: EFA # <2>
+          instanceType: <supported_instance_type>
+          networkInterfaceType: EFA
           placement:
-            availabilityZone: <zone> # <3>
-            region: <region> # <4>
-          placementGroupName: <placement_group> # <5>
-          placementGroupPartition: <placement_group_partition_number> # <6>
+            availabilityZone: <zone>
+            region: <region>
+          placementGroupName: <placement_group>
+          placementGroupPartition: <placement_group_partition_number>
 # ...
 ----
-<1> Specify an instance type that link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types[supports EFAs].
-<2> Specify the `EFA` network interface type.
-<3> Specify the zone, for example, `us-east-1a`.
-<4> Specify the region, for example, `us-east-1`.
-<5> Specify the name of the existing AWS placement group to deploy machines in.
-<6> Optional: Specify the partition number of the existing AWS placement group to deploy machines in. 
+where:
+--
+`spec.providerSpec.value.instanceType`:: Specifies an instance type that link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types[supports EFAs].
+`spec.providerSpec.value.networkInterfaceType`:: Specifies the `EFA` network interface type.
+`spec.providerSpec.value.placement.availabilityZone`:: Specifies the zone, for example, `us-east-1a`.
+`spec.providerSpec.value.placement.region`:: Specifies the region, for example, `us-east-1`.
+`spec.providerSpec.value.placement.placementGroupName`:: Specifies the name of the existing AWS placement group to deploy machines in.
+`spec.providerSpec.value.placement.placementGroupPartition`:: Specifies the partition number of the existing AWS placement group to deploy machines in.
+--
 
 .Verification
 

modules/machineset-capacity-reservation.adoc

@@ -26,23 +26,23 @@ ifdef::azure[on-demand Capacity Reservation with Capacity Reservation groups on
 ifdef::aws[Capacity Reservations on {aws-full} clusters, including On-Demand Capacity Reservations and Capacity Blocks for ML.]
 
 You can configure a machine set to deploy machines on any available resources that match the parameters of a capacity request that you define.
-These parameters specify the 
+These parameters specify the
 ifdef::azure[VM size,]
 ifdef::aws[instance type,]
 region, and number of instances that you want to reserve.
-If your 
+If your
 ifdef::azure[{azure-short} subscription quota]
 ifdef::aws[Capacity Reservation]
 can accommodate the capacity request, the deployment succeeds.
 
-For more information, including limitations and suggested use cases for this 
+For more information, including limitations and suggested use cases for this
 ifdef::azure[{azure-short} offering, see link:https://learn.microsoft.com/en-us/azure/virtual-machines/capacity-reservation-overview[On-demand Capacity Reservation] in the {azure-full} documentation.]
 ifdef::aws[{aws-short} offering, see link:https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/capacity-reservation-overview.html[On-Demand Capacity Reservations and Capacity Blocks for ML] in the {aws-short} documentation.]
 
 ifdef::azure[]
 [NOTE]
 ====
-You cannot change an existing Capacity Reservation configuration for a machine set. 
+You cannot change an existing Capacity Reservation configuration for a machine set.
 To use a different Capacity Reservation group, you must replace the machine set and the machines that the previous machine set deployed.
 ====
 endif::azure[]
@@ -86,11 +86,11 @@ tag::compute[]
       providerSpec:
         value:
 ifdef::azure[]
-          capacityReservationGroupID: <capacity_reservation_group> # <1>
+          capacityReservationGroupID: <capacity_reservation_group>
 endif::azure[]
 ifdef::aws[]
-          capacityReservationId: <capacity_reservation> # <1>
-          marketType: <market_type> # <2>
+          capacityReservationId: <capacity_reservation>
+          marketType: <market_type>
 endif::aws[]
 end::compute[]
 tag::controlplane[]
@@ -99,21 +99,22 @@ tag::controlplane[]
         providerSpec:
           value:
 ifdef::azure[]
-            capacityReservationGroupID: <capacity_reservation_group> # <1>
+            capacityReservationGroupID: <capacity_reservation_group>
 endif::azure[]
 ifdef::aws[]
-            capacityReservationId: <capacity_reservation> # <1>
-            marketType: <market_type> # <2>
+            capacityReservationId: <capacity_reservation>
+            marketType: <market_type>
 endif::aws[]
 end::controlplane[]
 # ...
 ----
-<1> Specify the ID of the 
+where:
+`spec.providerSpec.value.capacityReservationGroupID`:: Specifies the ID of the
 ifdef::azure[Capacity Reservation group]
 ifdef::aws[Capacity Block for ML or On-Demand Capacity Reservation]
 that you want the machine set to deploy machines on.
 ifdef::aws[]
-<2> Specify the market type to use.
+`spec.providerSpec.value.marketType`:: Specifies the market type to use.
 The following values are valid:
 `CapacityBlock`:: Use this market type with Capacity Blocks for ML.
 `OnDemand`:: Use this market type with On-Demand Capacity Reservations.
@@ -146,7 +147,7 @@ tag::compute[]
 where `<machine_set_name>` is the name of the compute machine set.
 end::compute[]
 +
-In the output, verify that the characteristics of the listed machines match the parameters of your 
+In the output, verify that the characteristics of the listed machines match the parameters of your
 ifdef::azure[Capacity Reservation.]
 ifdef::aws[Capacity Reservation.]