diff --git a/docs/source/reference/yaml-spec.rst b/docs/source/reference/yaml-spec.rst
index 29c196020b6..d05344f3537 100644
--- a/docs/source/reference/yaml-spec.rst
+++ b/docs/source/reference/yaml-spec.rst
@@ -92,15 +92,12 @@ Available fields:
       # ports are already open. It will bypass the already opened ports and only open those
       # that are not. Once the cluster is terminated, SkyPilot will remove all firewall rules
       # or security groups related to that cluster.
+      # If you only have one port or range to expose, you can use the following shorthand: 
+      # `ports: 8081` or `ports: 10052-10100`
       ports:
         - 8080
         - 10022-10040
 
-      # If you only have one port or range to expose, you can use the following shorthand:
-      ports: 8081
-      # or
-      ports: 10052-10100
-
       # Additional accelerator metadata (optional); only used for TPU node
       # and TPU VM.
       # Example usage: