DOCSP-27750 Interlinks Session methods (#2533) (#2597)

* DOCSP-27750 Interlinks Session methods

* Adds Session.withTransaction to the toctree

* Fixes rendering issue in Session.withTransaction

* Test link fixes

* Test link fixes

* Test link fixes

* Fixes per Anna Henningsen

* Fixes per Anna Henningsen

Author: kennethdyer

source/reference/command/abortTransaction.txt

@@ -23,12 +23,13 @@ Definition
    without saving any of the changes made by the operations in the
    transaction.
 
+   .. |method| replace:: :method:`Session.abortTransaction`
+      helper method
+   .. include:: /includes/fact-dbcommand-tip
+
    To run the :dbcommand:`abortTransaction`, the command must be run
    against the ``admin`` database and run within a
-   :method:`Session`. Rather than run the :dbcommand:`abortTransaction`
-   command directly, most users should use the driver method or the
-   :binary:`~bin.mongosh` :method:`Session.abortTransaction()`
-   helper.
+   :method:`Session`. 
 
 Syntax
 ------

source/reference/command/commitTransaction.txt

@@ -20,12 +20,14 @@ Definition
    Saves the changes made by the operations in the :doc:`multi-document
    transaction </core/transactions>` and ends the transaction. 
 
+   .. |method| replace:: :method:`Session.commitTransaction` and
+      :method:`Session.withTransaction`
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip
+
    To run the :dbcommand:`commitTransaction`, the command must be run
    against the ``admin`` database and run within a
-   :method:`Session`. Rather than run the :dbcommand:`commitTransaction`
-   command directly, most users should use the driver method or the
-   :binary:`~bin.mongosh` :method:`Session.commitTransaction()`
-   helper.
+   :method:`Session`. 
 
 Syntax
 ------

source/reference/command/startSession.txt

@@ -18,6 +18,11 @@ Definition
    The :dbcommand:`startSession` command starts a new logical
    :ref:`session <sessions>` for a sequence of operations.
 
+
+   .. |method| replace:: :method:`Mongo.startSession`
+      helper method
+   .. include:: /includes/fact-dbcommand-tip
+
 Syntax
 ------
 

source/reference/method/Mongo.startSession.txt

@@ -19,6 +19,9 @@ Definition
    :binary:`~bin.mongosh` assigns the session ID to commands associated
    with the session.
 
+   .. |dbcommand| replace:: :dbcommand:`startSession` command
+   .. include:: /includes/fact-mongosh-shell-method-alt
+
    The :method:`~Mongo.startSession()` method can take a document with
    session options. The options available are:
 

source/reference/method/Session.abortTransaction.txt

@@ -21,6 +21,9 @@ Definition
    without saving any of the changes made by the operations in the
    transaction.
 
+   .. |dbcommand| replace:: :dbcommand:`abortTransaction` command
+   .. include:: /includes/fact-mongosh-shell-method-alt
+
    .. include:: /includes/transaction-support
 
 

source/reference/method/Session.commitTransaction.txt

@@ -18,6 +18,9 @@ Definition
    Saves the changes made by the operations in the :doc:`multi-document
    transaction </core/transactions>` and ends the transaction.
 
+   .. |dbcommand| replace:: :dbcommand:`commitTransaction` command
+   .. include:: /includes/fact-mongosh-shell-method-alt
+
    .. include:: /includes/transaction-support
 
 

source/reference/method/Session.txt

@@ -101,3 +101,4 @@ method to retrieve the database object associated with the session.
    /reference/method/Session.abortTransaction
    /reference/method/Session.commitTransaction
    /reference/method/Session.startTransaction
+   /reference/method/Session.withTransaction

source/reference/method/Session.withTransaction.txt

@@ -25,6 +25,9 @@ Definition
    - commit operation, if there is a failure to commit.
    - entire transaction, if the error permits.
 
+   .. |dbcommand| replace:: :dbcommand:`commitTransaction` command
+   .. include:: /includes/fact-mongosh-shell-method-alt
+
    The :method:`Session.withTransaction()` method accepts the
    `transaction options
    <https://mongodb.github.io/node-mongodb-native/4.8/interfaces/TransactionOptions.html>`__.
@@ -33,7 +36,7 @@ Definition
 Behavior
 --------
 
-The Node.js driver has a version of ``Session.withTransaction()` that is
+The Node.js driver has a version of ``Session.withTransaction()`` that is
 known as the `Callback API
 <https://www.mongodb.com/docs/drivers/node/current/fundamentals/transactions/#callback-api>`__.
 The ``Callback API`` also accepts an callback, however the return type