[UX/Doc] Add disk size in resource display and a minor fix for the doc (

#1371)

Minor fix for docs and ux

docs/source/reference/faq.rst

@@ -83,6 +83,7 @@ By default, SkyPilot only supports the US regions on different clouds for conven
 
 .. code-block:: bash
 
+  mkdir -p ~/.sky/catalogs/v4
   cd ~/.sky/catalogs/v4
   # Fetch all regions for AWS
   python -m sky.clouds.service_catalog.data_fetchers.fetch_aws --all-regions

sky/resources.py

@@ -116,8 +116,12 @@ def __repr__(self) -> str:
         if self.image_id is not None:
             image_id = f', image_id={self.image_id!r}'
 
+        disk_size = ''
+        if self.disk_size != _DEFAULT_DISK_SIZE_GB:
+            disk_size = f', disk_size={self.disk_size}'
+
         return (f'{self.cloud}({self._instance_type}{use_spot}'
-                f'{accelerators}{accelerator_args}{image_id})')
+                f'{accelerators}{accelerator_args}{image_id}{disk_size})')
 
     @property
     def cloud(self):

sky/utils/cli_utils/status_utils.py

@@ -7,12 +7,30 @@
 from sky import spot
 from sky.backends import backend_utils
 from sky.utils import common_utils
-from sky.utils.cli_utils import cli_utils
 from sky.utils import log_utils
 
 _COMMAND_TRUNC_LENGTH = 25
 
 
+def _truncate_long_string(s: str, max_length: int = 35) -> str:
+    if len(s) <= max_length:
+        return s
+    splits = s.split(' ')
+    if len(splits[0]) > max_length:
+        return splits[0][:max_length] + '...'  # Use '…'?
+    # Truncate on word boundary.
+    i = 0
+    total = 0
+    for i, part in enumerate(splits):
+        total += len(part)
+        if total >= max_length:
+            break
+    prefix = ' '.join(splits[:i])
+    if len(prefix) < max_length:
+        prefix += s[len(prefix):max_length]
+    return prefix + '...'
+
+
 class StatusColumn:
     """One column of the displayed cluster table"""
 
@@ -29,7 +47,7 @@ def __init__(self,
     def calc(self, record):
         val = self.calc_func(record)
         if self.trunc_length != 0:
-            val = cli_utils.truncate_long_string(str(val), self.trunc_length)
+            val = _truncate_long_string(str(val), self.trunc_length)
         return val
 
 
@@ -160,7 +178,7 @@ def show_local_status_table(local_clusters: List[str]):
             # RESOURCES
             resources_str,
             # COMMAND
-            cli_utils.truncate_long_string(command_str, _COMMAND_TRUNC_LENGTH),
+            _truncate_long_string(command_str, _COMMAND_TRUNC_LENGTH),
         ]
         names.append(cluster_name)
         cluster_table.add_row(row)