docs: enhance docstring for DataFrame.into_view method to clarify usage and advantages

Author: kosiew

python/datafusion/dataframe.py

@@ -318,7 +318,17 @@ def into_view(self) -> TableProvider:
         """Convert ``DataFrame`` into a ``TableProvider`` view for registration.
 
         This is the preferred way to obtain a view for
-        :py:meth:`~datafusion.context.SessionContext.register_table`.
+        :py:meth:`~datafusion.context.SessionContext.register_table` for several reasons:
+
+        1. **Direct API**: Most efficient path - directly calls the underlying Rust
+           ``DataFrame.into_view()`` method without intermediate delegations.
+        2. **Clear semantics**: The ``into_`` prefix follows Rust conventions,
+           indicating conversion from one type to another.
+        3. **Canonical method**: Other approaches like ``TableProvider.from_dataframe``
+           delegate to this method internally, making this the single source of truth.
+        4. **Deprecated alternatives**: The older ``TableProvider.from_view`` helper
+           is deprecated and issues warnings when used.
+
         ``datafusion.TableProvider.from_dataframe`` calls this method under the hood,
         and the older ``TableProvider.from_view`` helper is deprecated.