address comments

acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_schema/script

@@ -1 +1,3 @@
+# We expect DLT pipelines that use a schema defined in the bundle to have the
+# schema names replaced with a reference like `${resource.schemas.abc.name}`.
 $CLI bundle validate -o json | jq .resources.pipelines | jq 'map_values(del(.deployment, .permissions))' > out.json

acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_target/script

@@ -1 +1,3 @@
+# We expect DLT pipelines that use a schema defined in the bundle to have the
+# schema names replaced with a reference like `${resource.schemas.abc.name}`.
 $CLI bundle validate -o json | jq .resources.pipelines | jq 'map_values(del(.deployment, .permissions))' > out.json

acceptance/bundle/unitycatalog/capture_schema_dependency/volume/script

@@ -1 +1,3 @@
+# We expect UC Volumes that use a schema defined in the bundle to have the
+# schema names replaced with a reference like `${resource.schemas.abc.name}`.
 $CLI bundle validate -o json | jq .resources.volumes > out.json