diff --git a/README.rst b/README.rst
index d356390..2e8aaaa 100644
--- a/README.rst
+++ b/README.rst
@@ -1066,23 +1066,25 @@
 
 .. code-block::
 
-Change files permissions for keystone service:
+
+Change files/directories permissions for keystone service:
 =======================================
-In order to change file permissions a few data need to be set:.
-'files' - block to set permissions to files.
-It could be set the following data:
+In order to change file permissions the following should be set:
+
+'files' - block to set permissions for files.
 - full path to file
 - user ( default value is 'root' ) this parameter is optional.
 - group ( default value is 'keystone' ) this parameter is optional
 - mode ( default value is '0640' ) this parameter is optional
-'directories' - block to set permissions to directories.
+
+'directories' - block to set permissions for directories.
 - full path to directory
 - user ( default value is 'root' ) this parameter is optional
 - group ( default value is 'keystone' ) this parameter is optional
 - mode ( default value is '0750' ) this parameter is optional
 
 .. code-block:: yaml
-      
+
     keystone:
       files:
         /etc/keystone/keystone.conf:
@@ -1096,7 +1098,6 @@
           mode: '0750'
 
 
-
 Upgrades
 ========