tweak txn: comment out intro examples for now since duplciate of retry examples and need to incorporate mongo shell examples

Author: kay-kim

source/core/transactions.txt

@@ -134,39 +134,21 @@ Transactions and Security
    If using ``$external`` authentication users (i.e. Kerberos, LDAP,
    x.509 users), the usernames cannot be greater than 10k bytes.
 
-Transactions and Locks
-----------------------
-
-By default, transactions waits ``5`` milliseconds to acquire locks
-required by the operations in the transaction. If the transaction
-cannot acquire its required locks within the ``5`` milliseconds, the
-transaction aborts.
-
-.. include:: /includes/extracts/transactions-operations-catalog-tip.rst
-
-You can use the :parameter:`maxTransactionLockRequestTimeoutMillis`
-parameter to adjust how long transactions wait to acquire locks.
-
-You can also use operation-specific timeout by setting
-:parameter:`maxTransactionLockRequestTimeoutMillis` to ``-1``.
-
-Transactions release all locks upon abort or commit.
-
 Transactions and Sessions
 -------------------------
 
 Transactions are associated with a session. That is, you start a
 transaction for a session. At any given time, you can have at most one
 open transaction for a session.
 
-If a session ends and it has an open transaction, the transaction
-aborts.
-
 .. important::
 
    When using the drivers, you **must** pass the session to each
-   operation in the transaction. For more information, see
-   :ref:`transactions-drivers`.
+   operation in the transaction.
+
+If a session ends and it has an open transaction, the transaction
+aborts.
+
 
 .. _transactions-drivers:
 
@@ -177,17 +159,11 @@ Clients require MongoDB drivers updated for MongoDB 4.0.
 
 .. include:: /includes/list-4.0-drivers.rst
 
-The following example assumes that the collections exists.
-
 .. important::
 
-   To associate read and write operations with a transaction, you **must**
-   pass the session to each operation in the transaction.
-
-
-.. include:: /includes/driver-examples/driver-example-transactions-intro-1.rst
-
-Note that the session is passed to each operation in the transaction.
+   To associate read and write operations with a transaction, you
+   **must** pass the session to each operation in the transaction. For
+   examples, see :ref:`transactions-retry`.
 
 Transactions and the ``mongo`` Shell
 ------------------------------------
@@ -376,6 +352,25 @@ transaction commit at the transaction start.
   :readconcern:`"majority"` read concern provides no guarantees that
   read operations read majority-committed data.
 
+
+Transactions and Locks
+----------------------
+
+By default, transactions waits ``5`` milliseconds to acquire locks
+required by the operations in the transaction. If the transaction
+cannot acquire its required locks within the ``5`` milliseconds, the
+transaction aborts.
+
+.. include:: /includes/extracts/transactions-operations-catalog-tip.rst
+
+You can use the :parameter:`maxTransactionLockRequestTimeoutMillis`
+parameter to adjust how long transactions wait to acquire locks.
+
+You can also use operation-specific timeout by setting
+:parameter:`maxTransactionLockRequestTimeoutMillis` to ``-1``.
+
+Transactions release all locks upon abort or commit.
+
 .. toctree::
    :hidden:
    :titlesonly:

source/includes/driver-examples/driver-example-transactions-retry-1.rst

@@ -29,6 +29,12 @@
          
      - id: python
        content: |
+
+         .. important::
+
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
          .. class:: copyable-code
          .. literalinclude:: /driver-examples/test_examples.py
             :language: python
@@ -38,8 +44,12 @@
 
      - id: java-sync
        content: |
-         .. code-block:: javascript
+         .. important::
 
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
+         .. code-block:: javascript
 
              void runTransactionWithRetry(Runnable transactional) {
                  while (true) {
@@ -61,6 +71,12 @@
 
      - id: nodejs
        content: |
+
+         .. important::
+
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
          .. class:: copyable-code
          .. literalinclude:: /driver-examples/node-promises-examples.js
             :language: javascript

source/includes/driver-examples/driver-example-transactions-retry-2.rst

@@ -29,6 +29,7 @@
 
      - id: python
        content: |
+       
          .. class:: copyable-code
          .. literalinclude:: /driver-examples/test_examples.py
             :language: python

source/includes/driver-examples/driver-example-transactions-retry-3.rst

@@ -79,6 +79,11 @@
 
      - id: python
        content: |
+         .. important::
+
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
          .. class:: copyable-code
          .. literalinclude:: /driver-examples/test_examples.py
             :language: python
@@ -89,6 +94,11 @@
      - id: java-sync
        content: |
 
+         .. important::
+
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
          .. code-block:: java
 
             void runTransactionWithRetry(Runnable transactional) {
@@ -153,6 +163,11 @@
 
      - id: nodejs
        content: |
+         .. important::
+
+            To associate read and write operations with a transaction, you **must**
+            pass the session to each operation in the transaction.
+
          .. class:: copyable-code
          .. literalinclude:: /driver-examples/node-promises-examples.js
             :language: javascript

source/includes/list-4.0-drivers.rst

@@ -1,17 +1,20 @@
-- Java 3.8.0
+.. list-table::
+   :class: index-table
 
-- Python 3.7.0
+   * - Java 3.8.0
 
-- C 1.11.0
+       Python 3.7.0
 
-- C# 2.7
+       C 1.11.0
 
-- Node 3.1.0
+     - C# 2.7
 
-- Ruby 2.6.0
+       Node 3.1.0
 
-- Perl 2.0.0
+       Ruby 2.6.0
 
-- PHPC 1.5.0
+     - Perl 2.0.0
 
-- Scala 2.4.0
+       PHPC 1.5.0
+
+       Scala 2.4.0