diff --git a/reference/mongodb/mongodb/driver/session/aborttransaction.xml b/reference/mongodb/mongodb/driver/session/aborttransaction.xml
index b0b4b0838e..2efa02bea0 100644
--- a/reference/mongodb/mongodb/driver/session/aborttransaction.xml
+++ b/reference/mongodb/mongodb/driver/session/aborttransaction.xml
@@ -14,9 +14,9 @@
- This method aborts an existing transaction and all the associated
- operations are rolled back. It is like all operations that were part of
- this transaction never existed.
+ Terminates the multi-document transaction and rolls back any data changes
+ made by the operations within the transaction. That is, the transaction ends
+ without saving any of the changes made by the operations in the transaction.
diff --git a/reference/mongodb/mongodb/driver/session/committransaction.xml b/reference/mongodb/mongodb/driver/session/committransaction.xml
index 7ccaf4f789..7bfc4e2e7a 100644
--- a/reference/mongodb/mongodb/driver/session/committransaction.xml
+++ b/reference/mongodb/mongodb/driver/session/committransaction.xml
@@ -14,8 +14,9 @@
- This method commits an existing transaction and all the associated
- operations are persisted in the database.
+ Saves the changes made by the operations in the multi-document transaction
+ and ends the transaction. Until the commit, none of the data changes made
+ from within the transaction are visible outside the transaction.
diff --git a/reference/mongodb/mongodb/driver/session/endsession.xml b/reference/mongodb/mongodb/driver/session/endsession.xml
index 7860daf1f3..6027039b22 100644
--- a/reference/mongodb/mongodb/driver/session/endsession.xml
+++ b/reference/mongodb/mongodb/driver/session/endsession.xml
@@ -15,9 +15,15 @@
This method closes an existing session. If a transaction was associated
- with this session, this transaction is also aborted, and all its
- operations are rolled back.
+ with this session, the transaction will be aborted. After calling this
+ method, applications should not invoke other methods on the session.
+
+
+ Sessions are also closed during garbage collection. It should not be
+ necessary to call this method under normal circumstances.
+
+
diff --git a/reference/mongodb/mongodb/driver/session/starttransaction.xml b/reference/mongodb/mongodb/driver/session/starttransaction.xml
index 774c264531..9c89c071a0 100644
--- a/reference/mongodb/mongodb/driver/session/starttransaction.xml
+++ b/reference/mongodb/mongodb/driver/session/starttransaction.xml
@@ -14,19 +14,21 @@
array|objectoptions
- This method starts a new transaction within this session. When the session
- is attached to operations through the "session"
- argument, these operations become of the started transaction.
+ Starts a multi-document transaction associated with the session. At any given
+ time, you can have at most one open transaction for a session. After starting
+ a transaction, the session object must be passed to each operation via
+ the "session" option (e.g.
+ MongoDB\Driver\Manager::executeBulkWrite) in order
+ to associate that operation with the transaction.
Transactions can be committed through
MongoDB\Driver\Session::commitTransaction, and
aborted with
MongoDB\Driver\Session::abortTransaction.
-
-
- Transactions are also automatically aborted when the session is terminated
- through MongoDB\Driver\Session::endSession.
+ Transactions are also automatically aborted when the session is closed from
+ garbage collection or by explicitly calling
+ MongoDB\Driver\Session::endSession.