fix: update user guide links in DataFrame class documentation for clarity

Author: kosiew

examples/example_fail.py

@@ -0,0 +1,9 @@
+from typing import TYPE_CHECKING, TypeGuard
+
+if TYPE_CHECKING:
+    from _typeshed import CapsuleType as _PyCapsule
+
+def is_capsule(obj: object) -> TypeGuard[_PyCapsule]:
+    return hasattr(obj, "__capsule__")
+
+print("This will break soon...")

python/datafusion/dataframe.py

@@ -1320,9 +1320,10 @@ def __arrow_c_stream__(self, requested_schema: object | None = None) -> object:
             Arrow ``PyCapsule`` object representing an ``ArrowArrayStream``.
 
         For practical usage patterns, see the Apache Arrow streaming
-        documentation: https://arrow.apache.org/docs/python/ipc.html#streaming
-        and the DataFusion user guide sections on Arrow I/O and DataFrame
-        streaming (:doc:`../io/arrow` and :doc:`../dataframe/index`).
+        documentation: https://arrow.apache.org/docs/python/ipc.html#streaming.
+
+        For details on DataFusion's Arrow integration and DataFrame streaming,
+        see the user guide (user-guide/io/arrow and user-guide/dataframe/index).
 
         Notes:
             The Arrow C Data Interface PyCapsule details are documented by Apache