DOCSP-35201 restructuring for clarity and brevity

Author: mballard-mdb

source/crud/transactions.txt

@@ -310,25 +310,33 @@ ensure your data maintains consistent. If the following errors occur, the
 transaction must be retried:
 
 - ``TransientTransactionError``: Raised if a write operation encounters an error
-  before the driver commits the transaction.
+  before the driver commits the transaction. To learn more about this error
+  type, see the :manual:`TransientTransactionError description 
+</core/transactions-in-applications/#transienttransactionerror>` on the Drivers API page in the
+Server manual.
 - ``UnknownTransactionCommitResult``: Raised if the commit operation encounters
-  an error.
+  an error. To learn more about this error type, see the
+  :manual:`UnknownTransactionCommitResult description 
+</core/transactions-in-applications/#unknowntransactioncommitresult>` on the Drivers API page in the
+Server manual.
+
+The Convenient Transaction API incorporates retry logic for these error types,
+so the driver automatically retries the transaction until there is a successful
+commit.
+
+Core API Error Error Handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you are using the Core API to perform a transaction, you must implement the
-error-handling logic into your application. To do so, you must create the following functions:
+error-handling logic into your application. To do so, you must create the
+following functions that run until there is a successful commit or a different
+error:
 
 - A function that retries the entire transaction when the driver encounters a
-  ``TransientTransactionError``
+  ``TransientTransactionError`` 
 - A function that retries the commit operation when the driver encounters an
   ``UnknownTransactionCommitResult``
 
-These functions should continue to retry the operation until there is a
-successful commit or a different error. For an example of this retry
-logic, see the :manual:`Core API section
+For an example of this retry logic, see the :manual:`Core API section
 </core/transactions-in-applications/#core-api>` on the Drivers API page in the
-Server manual.
-
-The Convenient Transaction API incorporates retry logic for these error types,
-so the driver automatically retries the transaction until there is a successful
-commit. You do not have to explicitly declare functions for the API to retry
-transaction operations when the driver produces these errors. 
+Server manual.