docs(bigquery): add note on schema to insert()

deepyaman · gforsyth · commit a528450ab803 · 2025-12-28T09:14:51.000-05:00
diff --git a/ibis/backends/bigquery/__init__.py b/ibis/backends/bigquery/__init__.py
@@ -863,6 +863,17 @@ def insert(
     ) -> None:
         """Insert data into a table.
 
+        ::: {.callout-note}
+        ## Ibis does not use the word `schema` to refer to database hierarchy.
+
+        A collection of `table` is referred to as a `database`.
+        A collection of `database` is referred to as a `catalog`.
+
+        These terms are mapped onto the corresponding features in each
+        backend (where available), regardless of whether the backend itself
+        uses the same terminology.
+        :::
+
         Parameters
         ----------
         name
diff --git a/ibis/backends/sql/__init__.py b/ibis/backends/sql/__init__.py
@@ -652,8 +652,9 @@ def truncate_table(
         ::: {.callout-note}
         ## Ibis does not use the word `schema` to refer to database hierarchy.
 
-        A collection of tables is referred to as a `database`.
+        A collection of `table` is referred to as a `database`.
         A collection of `database` is referred to as a `catalog`.
+
         These terms are mapped onto the corresponding features in each
         backend (where available), regardless of whether the backend itself
         uses the same terminology.
