diff --git a/README.rst b/README.rst
index fe138eb..fcb3403 100644
--- a/README.rst
+++ b/README.rst
@@ -3,6 +3,7 @@ masakari-monitors
 ===============================
 
 Monitors for Masakari
+=====================
 
 Monitors for Masakari provides Virtual Machine High Availability (VMHA) service
 for OpenStack clouds by automatically detecting the failure events
@@ -25,31 +26,28 @@ detailed in the LICENSE file.
 
 Configure masakari-monitors
 ---------------------------
-#. Clone masakari using.
 
-command::
-    $ git clone https://github.com/openstack/masakari-monitors.git
+#. Clone masakari using::
+
+   $ git clone https://github.com/openstack/masakari-monitors.git
 
 #. Create masakarimonitors directory in /etc/.
 
-#. Run setup.py from masakari-monitors.
+#. Run setup.py from masakari-monitors::
 
-command::
-    $ sudo python setup.py install
+   $ sudo python setup.py install
 
 #. Copy masakarimonitors.conf and process_list.yaml files from
-masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
-changes to the masakarimonitors.conf and process_list.yaml files.
-To generate the sample masakarimonitors.conf file, run the following command
-from the top level of the masakari-monitors directory:
+   masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
+   changes to the masakarimonitors.conf and process_list.yaml files.
+   To generate the sample masakarimonitors.conf file, run the following
+   command from the top level of the masakari-monitors directory::
 
-command::
-    $ tox -egenconfig
+   $ tox -egenconfig
 
 #. To run masakari-processmonitor, masakari-hostmonitor and
-masakari-instancemonitor simply use following binary:
+   masakari-instancemonitor simply use following binary::
 
-command::
    $ masakari-processmonitor
    $ masakari-hostmonitor
    $ masakari-instancemonitor
@@ -60,27 +58,25 @@ However, those bash shell scripts are deprecated as of the Ocata release and
 will be removed in the Queens release.
 Use above masakari-hostmonitors implemented in python instead.
 
-#. Clone masakari using.
+#. Clone masakari using::
 
-command::
-    $ git clone https://github.com/openstack/masakari-monitors.git
+   $ git clone https://github.com/openstack/masakari-monitors.git
 
 #. Create masakarimonitors directory in /etc/.
 
 #. Remove '.sample' from files hostmonitor.conf.sample,
-processmonitor.conf.sample and proc.list.sample which exist at
-masakari-monitors/etc/.
+   processmonitor.conf.sample and proc.list.sample which exist at
+   masakari-monitors/etc/.
 
 #. Copy hostmonitor.conf, processmonitor.conf and proc.list files from
-masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
-changes to the hostmonitor.conf, processmonitor.conf and proc.list files.
+   masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
+   changes to the hostmonitor.conf, processmonitor.conf and proc.list files.
 
 #. To run bash scripts of masakari-processmonitor and masakari-hostmonitor
-simply use following binary:
+   simply use following binary::
 
-command::
-    $ masakari-processmonitor.sh /etc/masakarimonitors/processmonitor.conf /etc/masakarimonitors/proc.list
-    $ masakari-hostmonitor.sh /etc/masakarimonitors/hostmonitor.conf
+   $ masakari-processmonitor.sh /etc/masakarimonitors/processmonitor.conf /etc/masakarimonitors/proc.list
+   $ masakari-hostmonitor.sh /etc/masakarimonitors/hostmonitor.conf
 
 
 Features