Apply Julia's review suggestions for DABs naming conventions

lennartkats-db · lennartkats-db · commit ec4498ec1950 · 2026-03-31T18:04:16.000+02:00
Use "bundle definition" in YAML comments and "Declarative Automation Bundles example" in README descriptions per Julia's PR #148 review. Co-authored-by: Isaac
diff --git a/contrib/data_engineering/databricks.yml b/contrib/data_engineering/databricks.yml
@@ -1,4 +1,4 @@
-# This is a Declarative Automation Bundle definition for data_engineering.
+# This is a bundle definition for data_engineering.
 # See https://docs.databricks.com/dev-tools/bundles/index.html for documentation.
 bundle:
   name: data_engineering
diff --git a/contrib/job_with_ai_parse_document/README.md b/contrib/job_with_ai_parse_document/README.md
@@ -1,6 +1,6 @@
 # AI Document Processing Job with Structured Streaming
 
-A Declarative Automation Bundle demonstrating **incremental document processing** using `ai_parse_document`, `ai_query`, and Databricks Jobs with Structured Streaming.
+This Declarative Automation Bundles example demonstrates incremental document processing using `ai_parse_document`, `ai_query`, and Databricks Jobs with Structured Streaming.
 
 ## Overview
 
diff --git a/contrib/job_with_ai_parse_document/databricks.yml b/contrib/job_with_ai_parse_document/databricks.yml
@@ -1,4 +1,4 @@
-# This is a Declarative Automation Bundle definition for ai_parse_document_workflow.
+# This is a bundle definition for ai_parse_document_workflow.
 # See https://docs.databricks.com/dev-tools/bundles/index.html for documentation.
 bundle:
   name: ai_parse_document_workflow
diff --git a/knowledge_base/app_with_database/README.md b/knowledge_base/app_with_database/README.md
@@ -1,7 +1,7 @@
 # Databricks app with OLTP database
 
 This example demonstrates how to define a Databricks app backed by 
-an OLTP Postgres   in a Declarative Automation Bundle.
+an OLTP Postgres in a bundle.
 
 It includes and deploys an example application that uses Python and Dash and a database instance.
 When application is started it provisions its own schema and demonstration data in the OLTP database.
diff --git a/knowledge_base/app_with_database/databricks.yml b/knowledge_base/app_with_database/databricks.yml
@@ -1,4 +1,4 @@
-# This is a Declarative Automation Bundle definition for app_with_database.
+# This is a bundle definition for app_with_database.
 bundle:
   name: app_with_database_example
 
diff --git a/knowledge_base/dashboard_nyc_taxi/README.md b/knowledge_base/dashboard_nyc_taxi/README.md
@@ -1,6 +1,6 @@
 # Dashboard for NYC Taxi Trip Analysis
 
-This example shows how to define a Declarative Automation Bundle with an AI/BI dashboard and a job that captures a snapshot of the dashboard and emails it to a subscriber.
+This Declarative Automation Bundles example shows how to define an AI/BI dashboard and a job that captures a snapshot of the dashboard and emails it to a subscriber.
 
 It deploys the sample __NYC Taxi Trip Analysis__ dashboard to a Databricks workspace and configures a daily schedule to run the dashboard and send the snapshot in email to a specified email address.
 
diff --git a/knowledge_base/database_with_catalog/README.md b/knowledge_base/database_with_catalog/README.md
@@ -1,6 +1,6 @@
 # OLTP database instance with a catalog
 
-This example demonstrates how to define an OLTP database instance and a database catalog in a Declarative Automation Bundle.
+This Declarative Automation Bundles example demonstrates how to define an OLTP database instance and a database catalog.
 
 It includes and deploys an example database instance and a catalog. When data changes in the database instance, they are reflected in Unity Catalog.
 
diff --git a/knowledge_base/databricks_app/README.md b/knowledge_base/databricks_app/README.md
@@ -1,6 +1,6 @@
 # Databricks App for working with Databricks jobs
 
-This example demonstrates how to define an Databricks App in a Declarative Automation Bundle.
+This Declarative Automation Bundles example demonstrates how to define a Databricks App.
 
 It includes and deploys an example app and a job managed by DABs to a Databricks workspace.
 The app shows current status of the job and lists all existing runs.
diff --git a/knowledge_base/development_cluster/README.md b/knowledge_base/development_cluster/README.md
@@ -1,6 +1,6 @@
 # Development cluster
 
-This example demonstrates how to define and use a development (all-purpose) cluster in a Declarative Automation Bundle.
+This Declarative Automation Bundles example demonstrates how to define and use a development (all-purpose) cluster.
 
 This bundle defines an `example_job` which is run on a job cluster in production mode.
 
diff --git a/knowledge_base/job_backfill_data/README.md b/knowledge_base/job_backfill_data/README.md
@@ -1,6 +1,6 @@
 # job_backfill_data
 
-This example demonstrates a Declarative Automation Bundle Job that runs a SQL task with a date parameter for backfilling data.
+This Declarative Automation Bundles example demonstrates how to define a job that runs a SQL task with a date parameter for backfilling data.
 
 The Job consists of:
 
diff --git a/knowledge_base/job_read_secret/README.md b/knowledge_base/job_read_secret/README.md
@@ -1,6 +1,6 @@
 # Databricks job that reads a secret from a secret scope
 
-This example demonstrates how to define a secret scope and a job with a task that reads from it in a Declarative Automation Bundle.
+This Declarative Automation Bundles example demonstrates how to define a secret scope and a job with a task that reads from it.
 
 It includes and deploys an example secret scope, and a job with a task in a bundle that reads a secret from the secret scope to a Databricks workspace.
 
diff --git a/knowledge_base/job_with_multiple_wheels/README.md b/knowledge_base/job_with_multiple_wheels/README.md
@@ -1,6 +1,6 @@
 # Job with multiple wheels
 
-This example demonstrates how to define and use a job with multiple wheel dependencies in a Declarative Automation Bundle.
+This Declarative Automation Bundles example demonstrates how to define and use a job with multiple wheel dependencies.
 
 One of the wheel files depends on the other. It is important to specify the order of the wheels in the job such that
 the dependent wheel is installed first, since it won't be available in a public registry.
diff --git a/knowledge_base/private_wheel_packages/README.md b/knowledge_base/private_wheel_packages/README.md
@@ -15,7 +15,7 @@ wheels from a private repository in a notebook. You can use the workaround docum
 # Usage
 
 You can refer to private wheel files from job libraries or serverless environments by downloading the wheel
-and making it part of your Declarative Automation Bundle deployment.
+and making it part of your bundle deployment.
 
 To emulate this for this example, we will download a wheel from PyPI, include it in deployment, and refer to it from job configuration.
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This is a Declarative Automation Bundle definition for data_engineering.`
	`1`	`+# This is a bundle definition for data_engineering.`
`2`	`2`	`# See https://docs.databricks.com/dev-tools/bundles/index.html for documentation.`
`3`	`3`	`bundle:`
`4`	`4`	`name: data_engineering`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This is a Declarative Automation Bundle definition for ai_parse_document_workflow.`
	`1`	`+# This is a bundle definition for ai_parse_document_workflow.`
`2`	`2`	`# See https://docs.databricks.com/dev-tools/bundles/index.html for documentation.`
`3`	`3`	`bundle:`
`4`	`4`	`name: ai_parse_document_workflow`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# This is a Declarative Automation Bundle definition for app_with_database.`
	`1`	`+# This is a bundle definition for app_with_database.`
`2`	`2`	`bundle:`
`3`	`3`	`name: app_with_database_example`
`4`	`4`