doc: enhance from_dataframe docstring with detailed parameter information

Author: kosiew

python/datafusion/table_provider.py

@@ -53,7 +53,17 @@ def from_capsule(cls, capsule: Any) -> TableProvider:
 
     @classmethod
     def from_dataframe(cls, df: Any) -> TableProvider:
-        """Create a :class:`TableProvider` from a :class:`DataFrame`."""
+        """Create a :class:`TableProvider` from tabular data.
+
+        Parameters
+        ----------
+        df:
+            Either a :class:`~datafusion.dataframe.DataFrame` instance or a
+            DataFrame convertible via the Arrow FFI (for example,
+            :class:`pandas.DataFrame` or :class:`polars.DataFrame`). When you
+            already have a DataFusion DataFrame prefer calling
+            :meth:`~datafusion.dataframe.DataFrame.into_view` directly.
+        """
         from datafusion.dataframe import DataFrame as DataFrameWrapper
 
         if isinstance(df, DataFrameWrapper):