diff --git a/doc/transaction.rst b/doc/transaction.rst
index 3491fbe89..34dda0331 100644
--- a/doc/transaction.rst
+++ b/doc/transaction.rst
@@ -20,13 +20,11 @@ Methods
     Initialize multi-record transaction (MRT), assign random transaction id and initialize
     reads/writes hashmaps with default capacities. The default MRT timeout is 10 seconds.
 
-    If setting any parameters, both parameters must be specified.
-    For both parameters, an unsigned 32-bit integer must be passed and the minimum value is 16.
-    If neither is specified, both parameters are set to 128 by default.
+    For both parameters, an unsigned 32-bit integer must be passed and the minimum value should be 16.
 
-    :param reads_capacity: expected number of record reads in the MRT.
+    :param reads_capacity: expected number of record reads in the MRT. Defaults to ``128``.
     :type reads_capacity: int, optional
-    :param writes_capacity: expected number of record writes in the MRT.
+    :param writes_capacity: expected number of record writes in the MRT. Defaults to ``128``.
     :type writes_capacity: int, optional
 
     .. py:attribute:: id