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

* DOCSP-27750 Interlinks Session methods (#2533)

* 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

* Fixes build

* Fixes build

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.rst
+
    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.mongo` shell :method:`Session.abortTransaction()`
-   helper.
+   :method:`Session`. 
 
    The command has the following syntax:
 

source/reference/command/commitTransaction.txt

@@ -20,12 +20,13 @@ 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` 
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    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.mongo` shell :method:`Session.commitTransaction()`
-   helper.
+   :method:`Session`. 
 
    The command has the following syntax:
 

source/reference/command/startSession.txt

@@ -20,6 +20,10 @@ 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.rst
+
    :dbcommand:`startSession` has the following syntax:
 
    .. code-block:: javascript

source/reference/method/Mongo.startSession.txt

@@ -19,6 +19,9 @@ Definition
    :binary:`~bin.mongo` assigns the session ID to commands associated
    with the session.
 
+   .. |dbcommand| replace:: :dbcommand:`startSession` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
+
    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-mongo-shell-method-alt.rst
+
    .. include:: /includes/transaction-support.rst
 
 Behavior

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-mongo-shell-method-alt.rst
+
    .. include:: /includes/transaction-support.rst
 
 Behavior