Updates per additional review

Author: Vernholio

openapi.yaml

@@ -3862,13 +3862,13 @@ paths:
                 type:
                   type: string
                   description: |
-                    Request re-sizing of your cluster to a higher plan by specifying a larger Linode Type.
+                    Request re-sizing of your cluster to a Linode Type with more disk space. For example, you could request a Linode Type that uses a higher plan.
 
-                    * Needs to be a higher plan than your current Linode Type.
+                    * Needs to be a Linode Type with more disk space than your current Linode.
 
                     * Resizing to a larger Linode Type can accrue additional cost. Review the `price` output in the [Types List](/docs/api/linode-types/#types-list) operation for more information.
 
-                    * You can't update the `allow-list` and set a new `type` in the same request.
+                    * You can't update the `allow_list` and set a new `type` in the same request.
 
                     * Any active updates to your cluster need to complete before you can request a resize. The reverse is also true: An active resizing needs to complete before you can perform any other update.
                   example: g6-standard-1
@@ -3893,7 +3893,7 @@ paths:
                     "192.0.1.0/24"
                   ],
                   "type": "g6-standard-1",
-                  "updates" = {
+                  "updates": {
                     "frequency": "monthly",
                     "duration": 3,
                     "hour_of_day": 12,
@@ -4661,13 +4661,13 @@ paths:
                 type:
                   type: string
                   description: |
-                    Request re-sizing of your cluster to a higher plan by specifying a larger Linode Type.
+                    Request re-sizing of your cluster to a Linode Type with more disk space. For example, you could request a Linode Type that uses a higher plan.
 
-                    * Needs to be a higher plan than your current Linode Type.
+                    * Needs to be a Linode Type with more disk space than your current Linode.
 
                     * Resizing to a larger Linode Type can accrue additional cost. Review the `price` output in the [Types List](/docs/api/linode-types/#types-list) operation for more information.
 
-                    * You can't update the `allow-list` and set a new `type` in the same request.
+                    * You can't update the `allow_list` and set a new `type` in the same request.
 
                     * Any active updates to your cluster need to complete before you can request a resize. The reverse is also true: An active resizing needs to complete before you can perform any other update.
                   example: g6-standard-1
@@ -4692,7 +4692,7 @@ paths:
                     "192.0.1.0/24"
                   ],
                   "type": "g6-standard-1",
-                  "updates" = {
+                  "updates": {
                     "frequency": "monthly",
                     "duration": 3,
                     "hour_of_day": 12,