diff --git a/README.rst b/README.rst
index a17fe13..7ad6f17 100644
--- a/README.rst
+++ b/README.rst
@@ -1,6 +1,6 @@
-============
-OpenContrail
-============
+====================
+OpenContrail Formula
+====================
 
 Contrail Controller is an open, standards-based software solution that
 delivers network virtualization and service automation for federated cloud
@@ -13,6 +13,7 @@
 
 Package source
 ==============
+
 Formula support OpenContrail as well as Juniper Contrail package repository in the backend.
 
 Differences withing the configuration and state run are controlled by
@@ -32,7 +33,7 @@
         vendor: juniper
 
 
-Sample pillars
+Sample Pillars
 ==============
 
 Controller nodes
@@ -477,9 +478,7 @@
           token: token
           tenant: admin
 
-
 Analytic nodes
-----------------
 
 Analytics and database on an analytic node(s)
 
@@ -543,7 +542,7 @@
 
 
 Compute nodes
-----------------
+-------------
 
 Vrouter configuration on a compute node(s)
 
@@ -576,7 +575,7 @@
           mtu: 9000
 
 Keystone v3
--------------
+-----------
 
 To enable support for keystone v3 in opencontrail, there must be defined
 version for config and web role.
@@ -632,8 +631,10 @@
           token: none
         ...
 
+Kubernetes support
+------------------
+
 Kubernetes vrouter nodes
-------------------------
 
 Vrouter configuration on a kubernetes node(s)
 
@@ -646,7 +647,6 @@
       ...
 
 vRouter with separated control plane
-------------------------------------
 
 Separate XMPP traffic from dataplane interface.
 
@@ -691,6 +691,7 @@
 For appropriate node at class level:
 
 .. code-block:: yaml
+
     opencontrail:
       ....
       web:
@@ -879,8 +880,8 @@
 
     reboot
 
-Service debugging
------------------
+Debugging
+---------
 
 Display vhost XMPP connection status