OCPBUGS#33714: Create different versions of hosted clusters in the same control plane

Author: xenolinux

modules/hosted-control-planes-version-support.adoc

@@ -10,11 +10,14 @@
 
 With each major, minor, or patch version release of {product-title}, two components of hosted control planes are released:
 
-* HyperShift Operator
-* Command-line interface (CLI)
+* The HyperShift Operator
+* The `hcp` command-line interface (CLI)
 
-The HyperShift Operator manages the lifecycle of hosted clusters that are represented by `HostedCluster` API resources. The HyperShift Operator is released with each {product-title} release. After the HyperShift Operator is installed, it creates a config map called `supported-versions` in the HyperShift namespace, as shown in the following example. The config map describes the HostedCluster versions that can be deployed.
+The HyperShift Operator manages the lifecycle of hosted clusters that are represented by the `HostedCluster` API resources. The HyperShift Operator is released with each {product-title} release. The HyperShift Operator creates the `supported-versions` config map in the `hypershift` namespace. The config map contains the supported hosted cluster versions.
 
+You can create different versions of hosted clusters in the same control plane.
+
+.Example `supported-versions` config map object
 [source,yaml]
 ----
     apiVersion: v1
@@ -28,11 +31,8 @@ The HyperShift Operator manages the lifecycle of hosted clusters that are repres
       namespace: hypershift
 ----
 
-The CLI is a helper utility for development purposes. The CLI is released as part of any HyperShift Operator release. No compatibility policies are guaranteed.
+The `hcp` CLI is a getting started tool to create hosted clusters.
 
-The API, `hypershift.openshift.io`, provides a way to create and manage lightweight, flexible, heterogeneous {product-title} clusters at scale. The API exposes two user-facing resources: `HostedCluster` and `NodePool`. A `HostedCluster` resource encapsulates the control plane and common data plane configuration. When you create a `HostedCluster` resource, you have a fully functional control plane with no attached nodes. A `NodePool` resource is a scalable set of worker nodes that is attached to a `HostedCluster` resource.
+You can use the `hypershift.openshift.io` API resources, such as, `HostedCluster` and `NodePool`, to create and manage {product-title} clusters at scale. A `HostedCluster` resource contains the control plane and common data plane configuration. When you create a `HostedCluster` resource, you have a fully functional control plane with no attached nodes. A `NodePool` resource is a scalable set of worker nodes that is attached to a `HostedCluster` resource.
 
 The API version policy generally aligns with the policy for link:https://kubernetes.io/docs/reference/using-api/#api-versioning[Kubernetes API versioning].
-
-
-