Add comment

Author: kanterov

experimental/python/databricks/bundles/build.py

@@ -528,6 +528,13 @@ def _relativize_location(location: Location) -> Location:
 
 
 def _relativize_path(path: str) -> str:
+    """
+    Attempt to relativize an absolute path to the current working directory.
+
+    If the path is not absolute or cannot be relativized, return it as is.
+    Used to relativize paths in locations to show shorter paths in diagnostics.
+    """
+
     if not os.path.isabs(path):
         return path