mention new session arg

Author: kevinjqliu

docs/source/user-guide/upgrade-guides.rst

@@ -55,6 +55,36 @@ A complete example can be found in the `FFI example <https://github.com/apache/d
 Your methods need to be updated to take an additional parameter like in this
 example.
 
+For example, the ``__datafusion_catalog_provider__`` signature changed in
+DataFusion 52 from:
+
+.. code-block:: rust
+
+    pub fn __datafusion_catalog_provider__<'py>(
+        &self,
+        py: Python<'py>,
+    ) -> PyResult<Bound<'py, PyCapsule>>
+
+to:
+
+.. code-block:: rust
+
+    pub fn __datafusion_catalog_provider__<'py>(
+        &self,
+        py: Python<'py>,
+        session: Bound<PyAny>,
+    ) -> PyResult<Bound<'py, PyCapsule>>
+
+The same additional ``session: Bound<PyAny>`` parameter is required for these
+FFI hook methods in DataFusion 52:
+
+- ``__datafusion_table_provider__``
+- ``__datafusion_schema_provider__``
+- ``__datafusion_table_function__``
+
+If your hook still uses the old no-``session`` signature, update it to accept
+``session``.
+
 .. code-block:: rust
 
     #[pymethods]