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

@@ -1319,10 +1319,10 @@ def __arrow_c_stream__(self, requested_schema: object | None = None) -> object:
         Returns:
             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`).
+    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:`user-guide/io/arrow` and :doc:`user-guide/dataframe/index`).
 
         Notes:
             The Arrow C Data Interface PyCapsule details are documented by Apache