fix: tidy up command description

Author: CustardTart32

src/aks-preview/azext_aks_preview/_params.py

@@ -3215,6 +3215,9 @@ def load_arguments(self, _):
             action="store_true",
             help="Show only VM SKUs that support availability zones.",
         )
+        # TODO: Eventually deprecate the -all param.
+        # The List VM SKUs API already performs regional filtering so once AZ filtering is also implemented
+        # within the API, this param will no longer be required.
         c.argument(
             "show_all",
             options_list=["--all"],

src/aks-preview/azext_aks_preview/custom.py

@@ -3436,10 +3436,9 @@ def aks_get_versions(cmd, client, location):    # pylint: disable=unused-argumen
 
 
 def aks_list_vm_skus(cmd, client, location, size=None, zone=None, show_all=None):  # pylint: disable=unused-argument
-    """List VM SKUs available for AKS node pools in a given location.
+    """Lists the VM SKUs accepted by AKS when creating node pools in a specified location.
 
-    Mirrors the shape and filtering behavior of 'az vm list-skus', but queries the
-    AKS-specific endpoint so only SKUs accepted by AKS are returned.
+    AKS will perform a best effort approach to provision the requested VM SKUs, but availability is not guaranteed.
 
     :param location: Azure region to query.
     :param size: Optional partial VM size name filter (case-insensitive).