add upgrade cluster command to ROSA docs

Author: mletalie

modules/rosa-upgrade-cluster-cli.adoc

@@ -4,9 +4,9 @@
 // * rosa_cli/rosa-manage-objects-cli.adoc
 :_mod-docs-content-type: REFERENCE
 [id="rosa-upgrading-cluster_{context}"]
-= Upgrade and delete upgrade for clusters
+= Upgrade and delete upgrade for objects
 
-This section describes the `upgrade` command usage for clusters.
+This section describes the `upgrade` command usage for objects.
 
 [id="rosa-upgrade-cluster_{context}"]
 == upgrade cluster
@@ -39,9 +39,17 @@ $ rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]
 |--schedule-time
 |The next time the upgrade will run on the specified date. Format: `HH:mm`
 
-|--node-drain-grace-period
+|--node-drain-grace-period ^[1]^
 |Sets a grace period (string) for how long the pod disruption budget-protected workloads are respected during upgrades. After this grace period, any workloads protected by pod disruption budgets that have not been successfully drained from a node will be forcibly evicted. Default: `1 hour`
+
+|--control-plane ^[2]^
+|Upgrades the cluster's hosted control plane.
 |===
+[.small]
+--
+1. Classic clusters only
+2. {hcp-title} clusters only
+--
 
 .Optional arguments inherited from parent commands
 [cols="30,70"]
@@ -68,7 +76,7 @@ $ rosa upgrade cluster --cluster=mycluster --version 4.5.20
 ----
 
 [id="rosa-delete-upgrade-cluster_{context}"]
-== delete upgrade
+== delete cluster upgrade
 
 Cancel a scheduled cluster upgrade.
 
@@ -101,3 +109,92 @@ $ rosa delete upgrade --cluster=<cluster_name> | <cluster_id>
 |--yes
 |Automatically answers `yes` to confirm the operation.
 |===
+
+[id="rosa-upgrade-machinepool_{context}"]
+== upgrade machinepool
+
+Upgrades a specific machine pool configured on a cluster.
+
+[NOTE]
+====
+The `upgrade` command for machinepools applies to {hcp-title} clusters only.
+====
+
+.Syntax
+[source,terminal]
+----
+$ rosa upgrade machinepool --cluster=<cluster_name> <machinepool_name>
+----
+
+.Arguments
+[cols="30,70"]
+|===
+|Option |Definition
+
+|--cluster
+|Required: The name or ID (string) of the cluster.
+|===
+
+.Optional arguments inherited from parent commands
+[cols="30,70"]
+|===
+|Option |Definition
+
+|--help
+|Shows help for this command.
+
+|--debug
+|Enables debug mode.
+
+|--profile
+|Specifies an AWS profile (string) from your credentials file.
+|===
+
+.Example
+Upgrade a machine pool on a cluster named `mycluster`.
+[source,terminal]
+----
+$ rosa upgrade machinepool --cluster=mycluster
+----
+
+[id="rosa-delete-upgrade-machinepool_{context}"]
+== delete machinepool upgrade
+
+Cancel a scheduled machinepool upgrade.
+
+.Syntax
+[source,terminal]
+----
+$ rosa delete upgrade --cluster=<cluster_name> <machinepool_name>
+----
+
+.Arguments
+[cols="30,70"]
+|===
+|Option |Definition
+
+|--cluster
+|Required: The name or ID (string) of the cluster.
+|===
+
+.Optional arguments inherited from parent commands
+[cols="30,70"]
+|===
+|Option |Definition
+
+|--help
+|Shows help for this command.
+
+|--debug
+|Enables debug mode.
+
+|--profile
+|Specifies an AWS profile (string) from your credentials file.
+|===
+
+// .Example
+// Delete  a machine pool named `mymachinepool` on a cluster named `mycluster`.
+// [source,terminal]
+// ----
+// $ rosa upgrade machinepool --cluster=mycluster --machinepool=mymachinepool
+// ----