MySQL client role
diff --git a/README.rst b/README.rst
index 1c5df0f..1403472 100644
--- a/README.rst
+++ b/README.rst
@@ -170,6 +170,57 @@
host: 'localhost'
rights: 'all privileges'
+
+MySQL client role
+-----------------
+
+Database management on remote MySQL server
+
+.. code-block:: yaml
+
+ mysql:
+ client:
+ enabled: true
+ server:
+ server01:
+ admin:
+ host: database.host
+ port: 3306
+ user: root
+ password: password
+ encoding: utf8
+ database:
+ database01:
+ encoding: utf8
+ users:
+ - name: username
+ password: 'password'
+ host: 'localhost'
+ rights: 'all privileges'
+
+User management on remote MySQL server
+
+.. code-block:: yaml
+
+ mysql:
+ client:
+ enabled: true
+ server:
+ server01:
+ admin:
+ host: database.host
+ port: 3306
+ user: root
+ password: password
+ encoding: utf8
+ users:
+ - name: user01
+ host: "*"
+ password: 'sdgdsgdsgd'
+ - name: user02
+ host: "localhost"
+
+
Usage
=====