diff --git a/reference/mysqlnd_ms/changes.xml b/reference/mysqlnd_ms/changes.xml
index e166a3d709..265a44377b 100644
--- a/reference/mysqlnd_ms/changes.xml
+++ b/reference/mysqlnd_ms/changes.xml
@@ -135,44 +135,45 @@
     </listitem>
     <listitem>
      <para>
-      Improved transaction boundaries detection with PHP 5.5.0 or newer and
+      As of PHP 5.5.0, improved support for transaction boundaries detection was added for
       <literal>mysqli</literal>. The <literal>mysqli</literal> extension has been
-      modified to use new C API calls of the <literal>mysqlnd</literal>
-      library to begin, commit and rollback a transaction or savepoint.
-      If <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness"><literal>trx_stickiness</literal></link>
-      is used to enable transaction aware load balancing, not only the
-      <function>mysqli_autocommit</function> call will be monitored by the plugin
-      but also <function>mysqli_begin</function>, <function>mysqli_commit</function>
-      and <function>mysqli_rollback</function>. All SQL features to control
+      modified to use the new C API calls of the <literal>mysqlnd</literal>
+      library to begin, commit, and rollback a transaction or savepoint.
+      If <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness">trx_stickiness</link>
+      is used to enable transaction aware load balancing, the <function>mysqli_begin</function>, 
+      <function>mysqli_commit</function> and <function>mysqli_rollback</function> functions
+      will now be monitered by the plugin, to go along with the <function>mysqli_autocommit</function>
+      function that was already supported. All SQL features to control
       transactions are also available through the improved <literal>mysqli</literal>
-      transaction control related functions. Thus, there is no need to
+      transaction control related functions. This means that it is not required to
       issue SQL statements instead of using API calls. Applications
-      using the appropriate API calls only, can be load balanced by PECL/mysqlnd_ms
-      in a completely transaction aware way.
+      using the appropriate API calls can be load balanced by PECL/mysqlnd_ms
+      in a completely transaction-aware way.
      </para>
      <para>
       Please note, <literal>PDO_MySQL</literal> has not been updated
       yet to utilize the new mysqlnd API calls. Thus, transaction boundary
       detection with <literal>PDO_MySQL</literal> continues to be limited to
-      the monitoring of <function>PDO::setAttribute(PDO::ATTR_AUTOCOMMIT, ...)</function>.
+      the monitoring by passing in <constant>PDO::ATTR_AUTOCOMMIT</constant> to
+      <methodname>PDO::setAttribute</methodname>.
      </para>
     </listitem>
-     <listitem>
+    <listitem>
      <para>
       Introduced <literal>trx_stickiness=on</literal>. This
-      <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness"><literal>trx_stickiness</literal></link>
+      <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness">trx_stickiness</link>
       option differs from <literal>trx_stickiness=master</literal> as it
-      tries to execute a read only transaction on a slave, if
+      tries to execute a read-only transaction on a slave, if
       quality of service (consistency level) allows the use of a slave.
-      Read only transactions have been introduced in MySQL 5.6. They
+      Read-only transactions were introduced in MySQL 5.6, and they
       offer performance gains.
      </para>
     </listitem>
     <listitem>
       <para>
-       Query cache support considered beta if used with <literal>mysqli</literal>
+       Query cache support is considered beta if used with the <literal>mysqli</literal>
        API. It should work fine with primary copy based clusters. For all other
-       APIs, the feature continues to be called experimental.
+       APIs, this feature continues to be called experimental.
       </para>
     </listitem>
     <listitem>
diff --git a/reference/mysqlnd_ms/setup.xml b/reference/mysqlnd_ms/setup.xml
index 62f1c99bfc..0c26225d9f 100755
--- a/reference/mysqlnd_ms/setup.xml
+++ b/reference/mysqlnd_ms/setup.xml
@@ -2300,11 +2300,11 @@ $mysqli->set_charset("latin1");
        by SQL statements such as <literal>SET AUTOCOMMIT=0</literal> or <literal>BEGIN</literal>.
       </para>
       <para>
-       Since PHP 5.5.0 the mysqlnd library features additional C API calls to
-       control transactions. The level of control matches the one offer by SQL
-       statement. The <literal>mysqli</literal> API has been modified to use
-       those calls. Since version 1.5.0, PECL/mysqlnd_ms can monitor not only
-       <function>mysqli_autocommit</function> but also <function>mysqli_begin</function>,
+       As of PHP 5.5.0, the mysqlnd library features additional C API calls to
+       control transactions. The level of control matches the one offered by SQL
+       statements. The <literal>mysqli</literal> API has been modified to use
+       these calls. Since version 1.5.0, PECL/mysqlnd_ms can monitor not only
+       <function>mysqli_autocommit</function>, but also <function>mysqli_begin</function>,
        <function>mysqli_commit</function> and <function>mysqli_rollback</function> to
        detect transaction boundaries and stop load balancing for the duration of
        a transaction.