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

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