PYTHON-5993 Clarify the operation_telemetry docstrings

Carries the wording from PR 1 forward and corrects it for the behavior
this branch adds: both cursor types pass a span now, and what one covers
is a single caller-driven getMore rather than a run of them.

Author: blink1073

pymongo/asynchronous/mongo_client.py

@@ -1912,8 +1912,10 @@ async def _run_operation(
         :param address: Optional address when sending a message
             to a specific server, used for getMore.
         :param operation_telemetry: The operation span created by the calling
-            cursor (see ``AsyncCursor._refresh``), or None. Passed down so the
-            command spans of this send nest under it.
+            cursor (see ``AsyncCursor._refresh``), or None. Covers a single
+            caller-driven getMore, or the whole of a public API call that
+            drains the cursor itself. Passed down so the command spans of this
+            send nest under it.
         :param reuse_current_span: Create no operation span at all and leave the
             ambient span in place as the parent for this operation's command
             spans. Mutually exclusive with ``operation_telemetry``. Defaults to
@@ -2027,12 +2029,13 @@ async def _retry_internal(
         :param is_aggregate_write: If this is a aggregate operation with a write, defaults to False.
         :param operation_id: Stable operation id shared across retries, defaults to None
         :param operation_telemetry: An operation span the caller created and will
-            end itself, defaults to None. Only ``AsyncCursor`` passes one (see
-            ``AsyncCursor._refresh``): its span has to survive send paths that
-            bypass this method, so the cursor ends it rather than this call.
-            Given a span, this method neither creates nor ends one and only
-            makes the caller's current for the duration of the call; given
-            None, it creates a span and ends it before returning.
+            end itself, defaults to None. Cursors pass one (see
+            ``AsyncCursor._refresh`` and ``AsyncCommandCursor._refresh``): the
+            span has to survive send paths that bypass this method, so the
+            cursor ends it rather than this call. Given a span, this method
+            neither creates nor ends one and only makes the caller's current
+            for the duration of the call; given None, it creates a span and
+            ends it before returning.
         :param reuse_current_span: Create no operation span at all and leave the
             ambient span in place as the parent for this operation's command
             spans. For callers that know a suitable operation span is already

pymongo/synchronous/mongo_client.py

@@ -1907,8 +1907,10 @@ def _run_operation(
         :param address: Optional address when sending a message
             to a specific server, used for getMore.
         :param operation_telemetry: The operation span created by the calling
-            cursor (see ``Cursor._refresh``), or None. Passed down so the
-            command spans of this send nest under it.
+            cursor (see ``Cursor._refresh``), or None. Covers a single
+            caller-driven getMore, or the whole of a public API call that
+            drains the cursor itself. Passed down so the command spans of this
+            send nest under it.
         :param reuse_current_span: Create no operation span at all and leave the
             ambient span in place as the parent for this operation's command
             spans. Mutually exclusive with ``operation_telemetry``. Defaults to
@@ -2022,12 +2024,13 @@ def _retry_internal(
         :param is_aggregate_write: If this is a aggregate operation with a write, defaults to False.
         :param operation_id: Stable operation id shared across retries, defaults to None
         :param operation_telemetry: An operation span the caller created and will
-            end itself, defaults to None. Only ``Cursor`` passes one (see
-            ``Cursor._refresh``): its span has to survive send paths that
-            bypass this method, so the cursor ends it rather than this call.
-            Given a span, this method neither creates nor ends one and only
-            makes the caller's current for the duration of the call; given
-            None, it creates a span and ends it before returning.
+            end itself, defaults to None. Cursors pass one (see
+            ``Cursor._refresh`` and ``CommandCursor._refresh``): the
+            span has to survive send paths that bypass this method, so the
+            cursor ends it rather than this call. Given a span, this method
+            neither creates nor ends one and only makes the caller's current
+            for the duration of the call; given None, it creates a span and
+            ends it before returning.
         :param reuse_current_span: Create no operation span at all and leave the
             ambient span in place as the parent for this operation's command
             spans. For callers that know a suitable operation span is already