diff --git a/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_schema/script b/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_schema/script
index 3bf93ab51..94850c5c6 100644
--- a/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_schema/script
+++ b/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
diff --git a/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_target/script b/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_target/script
index 3bf93ab51..94850c5c6 100644
--- a/acceptance/bundle/unitycatalog/capture_schema_dependency/dlt_target/script
+++ b/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
diff --git a/acceptance/bundle/unitycatalog/capture_schema_dependency/volume/script b/acceptance/bundle/unitycatalog/capture_schema_dependency/volume/script
index f4997af19..6b4b30819 100644
--- a/acceptance/bundle/unitycatalog/capture_schema_dependency/volume/script
+++ b/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