address review

Author: blink1073

pymongo/asynchronous/client_session.py

@@ -663,7 +663,8 @@ async def callback(session, custom_arg, custom_kwarg=None):
         The ``callback`` MUST NOT silently handle command errors
         without allowing such errors to propagate. Command errors may abort the
         transaction on the server, and an attempt to commit the transaction will
-        be rejected with a ``NoSuchTransaction`` error.
+        be rejected with a ``NoSuchTransaction`` error.  For more information see
+        the `transactions specification`_.
 
         When :meth:`~AsyncClientSession.commit_transaction` raises an exception with
         the ``"UnknownTransactionCommitResult"`` error label,
@@ -694,6 +695,9 @@ async def callback(session, custom_arg, custom_kwarg=None):
         :return: The return value of the ``callback``.
 
         .. versionadded:: 3.9
+
+        .. _tranactions specification:
+            https://github.com/mongodb/specifications/blob/master/source/transactions-convenient-api/transactions-convenient-api.md#handling-errors-inside-the-callback
         """
         start_time = time.monotonic()
         while True:

pymongo/synchronous/client_session.py

@@ -662,7 +662,8 @@ def callback(session, custom_arg, custom_kwarg=None):
         The ``callback`` MUST NOT silently handle command errors
         without allowing such errors to propagate. Command errors may abort the
         transaction on the server, and an attempt to commit the transaction will
-        be rejected with a ``NoSuchTransaction`` error.
+        be rejected with a ``NoSuchTransaction`` error.  For more information see
+        the `transactions specification`_.
 
         When :meth:`~ClientSession.commit_transaction` raises an exception with
         the ``"UnknownTransactionCommitResult"`` error label,
@@ -693,6 +694,9 @@ def callback(session, custom_arg, custom_kwarg=None):
         :return: The return value of the ``callback``.
 
         .. versionadded:: 3.9
+
+        .. _tranactions specification:
+            https://github.com/mongodb/specifications/blob/master/source/transactions-convenient-api/transactions-convenient-api.md#handling-errors-inside-the-callback
         """
         start_time = time.monotonic()
         while True: