diff --git a/reference/mysqlnd_ms/ini.xml b/reference/mysqlnd_ms/ini.xml
index cd4aba7983..0a7bd3b2ae 100755
--- a/reference/mysqlnd_ms/ini.xml
+++ b/reference/mysqlnd_ms/ini.xml
@@ -70,7 +70,7 @@
     </term>
     <listitem>
      <para>
-      Enables or disables the plugin. If set to disabled, the extension will not plug
+      Enables or disables the plugin. If disabled, the extension will not plug
       into
       <link linkend="book.mysqlnd">mysqlnd</link> to proxy internal
       <link linkend="book.mysqlnd">mysqlnd</link> C API calls.
@@ -85,8 +85,8 @@
     </term>
     <listitem>
      <para>
-      If enabled the plugin checks if the host (server) parameter value of any
-      MySQL connection attempt matches a section name from the plugin configuration
+      If enabled, the plugin checks if the host (server) parameters value of any
+      MySQL connection attempt, matches a section name from the plugin configuration
       file. If not, the connection attempt is blocked.
      </para>
     </listitem>
@@ -128,11 +128,14 @@
      <para>
       Enables or disables support of MySQL multi master replication setups.
      </para>
-     <para>
-      This feature is experimental. It will not be documented before
-      reasonable stability has been achieved. It is meant for development
-      only.
-     </para>
+     <caution>
+      <title>Experimental</title>
+      <para>
+       This feature is experimental. It will not be documented before
+       reasonable stability has been achieved. It is meant for development
+       only.
+      </para>
+     </caution>
     </listitem>
    </varlistentry>
 
@@ -148,7 +151,7 @@
      <para>
       Controls whether load balancing and lazy connection functionality can
       be used independently of read write splitting. If read write splitting
-      is disabled only the servers from the master list will be use for
+      is disabled, only servers from the master list will be used for
       statement execution. All configured slave servers will be ignored.
      </para>
      <para>
@@ -157,14 +160,17 @@
      </para>
      <para>
       Disabling read write splitting impacts the return value of
-      <link linkend="function.mysqlnd-ms-query-is-select"><function>mysqlnd_ms_query_is_select</function></link>.
+      <function>mysqlnd_ms_query_is_select</function>.
       The function will no longer propose query execution on slave servers.
      </para>
-     <para>
-      Please note, that you have to set <literal>mysqlnd_ms.multi_master=1</literal>
-      to make the plugin consider more than the first master of the master
-      list.
-     </para>
+     <note>
+      <title>Multiple master servers</title>
+      <para>
+       Setting <literal>mysqlnd_ms.multi_master=1</literal> allows the plugin
+       to use multiple master servers, instead of only the first master server
+       of the master list.
+      </para>
+     </note>
     </listitem>
    </varlistentry>