diff --git a/HACKING.rst b/HACKING.rst
index 096e567..7a72962 100644
--- a/HACKING.rst
+++ b/HACKING.rst
@@ -1,4 +1,4 @@
 mistral-lib Style Commandments
-===============================================
+==============================
 
 Read the OpenStack Style Commandments http://docs.openstack.org/developer/hacking/
diff --git a/README.rst b/README.rst
index 01ede3b..710a390 100644
--- a/README.rst
+++ b/README.rst
@@ -1,6 +1,6 @@
-===============================
+===========
 mistral-lib
-===============================
+===========
 
 Mistral shared routings and utilities (Actions API, YAQL functions API, data types etc.)
 
diff --git a/doc/source/index.rst b/doc/source/index.rst
index cbaafc1..182ee72 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 Welcome to mistral-lib's documentation!
-========================================================
+=======================================
 
 Contents:
 
diff --git a/doc/source/usage.rst b/doc/source/usage.rst
index ab9201f..d7659e3 100644
--- a/doc/source/usage.rst
+++ b/doc/source/usage.rst
@@ -1,6 +1,6 @@
-========
+=====
 Usage
-========
+=====
 
 To use mistral-lib in a project::