docs: add callout notes for some APIs changes and additions

fixes #10535

ibis/backends/duckdb/__init__.py

@@ -365,6 +365,15 @@ def do_connect(
     ) -> None:
         """Create an Ibis client connected to a DuckDB database.
 
+        ::: {.callout-note title="Changed in version 10.0.0"}
+        Before, we had special handling if the user passed the `temp_directory`
+        parameter, setting a custom default, and creating intermediate
+        directories if necessary. Now, we do nothing, and just pass the value
+        directly to DuckDB. You may need to add
+        `Path(your_temp_dir).mkdir(exists_ok=True, parents=True)`
+        to your code to maintain the old behavior.
+        :::
+
         Parameters
         ----------
         database
@@ -383,6 +392,7 @@ def do_connect(
         >>> import ibis
         >>> ibis.duckdb.connect(threads=4, memory_limit="1GB")  # doctest: +ELLIPSIS
         <ibis.backends.duckdb.Backend object at 0x...>
+
         """
         if not isinstance(database, Path) and not database.startswith(
             ("md:", "motherduck:", ":memory:")

ibis/expr/api.py

@@ -1184,6 +1184,9 @@ def cases(
 
     Equivalent to a SQL `CASE` statement.
 
+    ::: {.callout-note title="Added in version 10.0.0"}
+    :::
+
     Parameters
     ----------
     branch

ibis/expr/types/generic.py

@@ -2064,6 +2064,9 @@ def topk(
         Computes a Table containing the top `k` values by a certain metric
         (defaults to count).
 
+        ::: {.callout-note title="Changed in version 9.5.0"}
+        Added `name` parameter.
+
         Parameters
         ----------
         k
@@ -2122,6 +2125,7 @@ def topk(
         │ J      │      5.01 │
         │ H      │      4.13 │
         └────────┴───────────┘
+        :::
         """
         from ibis.expr.types.relations import bind
 
@@ -2268,6 +2272,9 @@ def value_counts(self, *, name: str | None = None) -> ir.Table:
         │ c      │     3 │
         │ d      │     4 │
         └────────┴───────┘
+
+        ::: {.callout-note title="Added in version 9.5.0"}
+        :::
         """
         colname = self.get_name()
         if name is None:
@@ -2774,6 +2781,9 @@ def to_list(self, **kwargs) -> list:
         >>> t = ibis.examples.penguins.fetch()
         >>> t.bill_length_mm.to_list(limit=5)
         [39.1, 39.5, 40.3, None, 36.7]
+
+        ::: {.callout-note title="Added in version 10.0.0"}
+        :::
         """
         return self.to_pyarrow(**kwargs).to_pylist()
 

ibis/expr/types/relations.py

@@ -4688,6 +4688,10 @@ def window_by(
     def value_counts(self, *, name: str | None = None) -> ir.Table:
         """Compute a frequency table of this table's values.
 
+        ::: {.callout-note title="Changed in version 10.0.0"}
+        Added `name` parameter.
+        :::
+
         Parameters
         ----------
         name