Apply suggestions from code review

Co-authored-by: Julia Crawford (Databricks) <julia.crawford@databricks.com>

Author: lennartkats-db

knowledge_base/metric_view/README.md

@@ -1,14 +1,13 @@
 # Unity Catalog Metric View
 
-This project demonstrates how to create a [Unity Catalog Metric View](https://docs.databricks.com/aws/en/metric-views/) using Databricks Asset Bundles. Once registered, the metric view becomes available to analysts and BI tools across your workspace, queryable via the `MEASURE()` SQL function.
+This project demonstrates how to create a [Unity Catalog Metric View](https://docs.databricks.com/aws/en/metric-views/) using Declarative Automation Bundles. Once registered, the metric view becomes available to analysts and BI tools across your workspace, queryable via the `MEASURE()` SQL function.
 
-**Learn more:** [Unity Catalog Metric Views](https://docs.databricks.com/aws/en/metric-views/) · dbt-based variant: [`../metric_view_dbt`](../metric_view_dbt)
 
 ## Concrete example: Definition and Usage
 
-This project defines `bookings_kpis`, a metric view over the public sample dataset `samples.wanderbricks.bookings`.
+## `bookings_kpis` metric view
 
-### Metric View Definition
+This project defines `bookings_kpis`, a metric view over the public sample dataset `samples.wanderbricks.bookings`.
 
 A SQL task in the job runs `CREATE OR REPLACE VIEW … WITH METRICS LANGUAGE YAML` from [`src/bookings_kpis.metric_view.sql`](src/bookings_kpis.metric_view.sql):
 
@@ -60,7 +59,7 @@ The view integrates seamlessly with:
 ### Prerequisites
 
 * Databricks workspace with Unity Catalog enabled
-* A SQL warehouse on a runtime that supports Unity Catalog metric views (Public Preview; any recent serverless or PRO warehouse)
+* A SQL warehouse on a runtime that supports Unity Catalog metric views
 * Databricks CLI installed and configured
 
 ### Setup
@@ -84,14 +83,14 @@ databricks bundle run bookings_kpis_metric_view --target prod
 
 The metric view will be created at `<catalog>.<your_username>.bookings_kpis` (dev) or `<catalog>.prod.bookings_kpis` (prod).
 
-## Advanced Topics
+### Notes
 
-**Scheduling:** The job has a daily `periodic` trigger so the view definition is re-applied in production. [Development-mode](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html) deploys pause the trigger automatically, so it only fires after `bundle deploy --target prod`.
+- The job has a daily `periodic` trigger so the view definition is re-applied in production. [Development-mode](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html) pauses the trigger automatically, so it only fires after `bundle deploy --target prod`.
 
-**Custom source table:** Point `source:` in the YAML body at any UC table you read from. The sample `samples.wanderbricks.bookings` is convenient for getting started; for production, use a curated table from your own pipeline.
+- Set `source:` in the YAML body to any UC table you read from. The sample `samples.wanderbricks.bookings` is convenient for getting started. For production, use a table from your own pipeline.
 
 ## Learn More
 
-- [Unity Catalog Metric Views](https://docs.databricks.com/aws/en/metric-views/) — Official documentation
-- [Metric View YAML Reference](https://docs.databricks.com/aws/en/metric-views/yaml-ref)
-- [Databricks Asset Bundles](https://docs.databricks.com/dev-tools/bundles/index.html)
+- [Unity Catalog Metric Views](https://docs.databricks.com/metric-views/) — Official documentation
+- [Metric View YAML Reference](https://docs.databricks.com/metric-views/yaml-ref)
+- [Declarative Automation Bundles](https://docs.databricks.com/dev-tools/bundles/index.html)

knowledge_base/metric_view/databricks.yml

@@ -1,16 +1,16 @@
-# This bundle shows how to create a Unity Catalog Metric View via a DABs job.
+# This example bundle defines a job that creates a Unity Catalog Metric View.
 #
-# Metric Views are a Unity Catalog feature (Public Preview, Databricks Runtime 16.4+)
+# Metric Views are a Unity Catalog feature 
 # that let you declare reusable dimensions and measures over a base table, queryable
-# via the MEASURE() SQL function. DABs does not yet have a first-class resource type
-# for metric views, so this example uses a SQL task in a job to run
+# via the MEASURE() SQL function. Bundles do not yet support metric views as
+# a resource type, so this example uses a SQL task in a job to run
 # `CREATE OR REPLACE VIEW ... WITH METRICS LANGUAGE YAML`.
 #
 # See also the dbt-based variant at ../metric_view-dbt.
 #
 # Docs:
-#   https://docs.databricks.com/aws/en/metric-views/
-#   https://docs.databricks.com/aws/en/metric-views/yaml-ref
+#   https://docs.databricks.com/metric-views/
+#   https://docs.databricks.com/metric-views/yaml-ref
 
 bundle:
   name: metric_view
@@ -20,11 +20,11 @@ include:
 
 variables:
   catalog:
-    description: The Unity Catalog catalog where the metric view will be created
+    description: The Unity Catalog where the metric view will be created
   schema:
     description: The schema where the metric view will be created
   warehouse_id:
-    description: SQL warehouse ID used to run the CREATE VIEW statement. Find one via `databricks warehouses list`.
+    description: SQL warehouse ID used to run the CREATE VIEW statement. To list available warehouses, use `databricks warehouses list`.
 
 targets:
   dev:

knowledge_base/metric_view/resources/bookings_kpis.job.yml

@@ -5,7 +5,7 @@ resources:
       description: Creates/refreshes the `bookings_kpis` Unity Catalog metric view.
 
       trigger:
-        # Re-apply the view definition daily. Dev-mode deploys pause this trigger;
+        # Re-apply the view definition daily. Dev deployment mode pauses this trigger;
         # in prod the job runs once per day. See https://docs.databricks.com/api/workspace/jobs/create#trigger
         periodic:
           interval: 1

knowledge_base/metric_view/src/bookings_kpis.metric_view.sql

@@ -1,5 +1,5 @@
 -- Create (or replace) a Unity Catalog Metric View over samples.wanderbricks.bookings.
--- See https://docs.databricks.com/aws/en/metric-views/yaml-ref for the YAML syntax.
+-- See https://docs.databricks.com/metric-views/yaml-ref for the YAML syntax.
 --
 -- Once deployed and run, query the metric view from any SQL editor with:
 --   SELECT MEASURE(total_bookings), MEASURE(total_revenue)

knowledge_base/metric_view_dbt/README.md

@@ -1,6 +1,6 @@
 # Unity Catalog Metric View using dbt
 
-This project demonstrates how to materialize a [Unity Catalog Metric View](https://docs.databricks.com/aws/en/metric-views/) via dbt-databricks using Databricks Asset Bundles. The metric view is defined as a dbt model with the [`metric_view` materialization](https://github.com/databricks/dbt-databricks/pull/1285) added in **dbt-databricks 1.12.0**.
+This project demonstrates how to materialize a [Unity Catalog Metric View](https://docs.databricks.com/metric-views/) via dbt-databricks using Declarative Automation Bundles. The metric view is defined as a dbt model with the [`metric_view` materialization](https://github.com/databricks/dbt-databricks/pull/1285) added in **dbt-databricks 1.12.0**.
 
 **Learn more:** [Unity Catalog Metric Views](https://docs.databricks.com/aws/en/metric-views/) · SQL-job variant: [`../metric_view`](../metric_view)
 
@@ -93,7 +93,7 @@ The metric view will be created at `<catalog>.<your_username>.bookings_kpis` (de
 
 ## Learn More
 
-- [Unity Catalog Metric Views](https://docs.databricks.com/aws/en/metric-views/) — Official documentation
-- [Metric View YAML Reference](https://docs.databricks.com/aws/en/metric-views/yaml-ref)
+- [Unity Catalog Metric Views](https://docs.databricks.com/metric-views/) — Official documentation
+- [Metric View YAML Reference](https://docs.databricks.com/metric-views/yaml-ref)
 - [`metric_view` materialization in dbt-databricks](https://github.com/databricks/dbt-databricks/pull/1285)
-- [Databricks Asset Bundles](https://docs.databricks.com/dev-tools/bundles/index.html)
+- [Declarative Automation Bundles](https://docs.databricks.com/dev-tools/bundles/index.html)