diff --git a/docs/api/cli-commands.rst b/docs/api/cli-commands.rst
index afa6106a0..91b3a70dc 100644
--- a/docs/api/cli-commands.rst
+++ b/docs/api/cli-commands.rst
@@ -11,18 +11,20 @@ using the following shell commands.
    tezos-client -protocol ProtoALphaALph man -verbosity 3
    tezos-admin-client man -verbosity 3
 
-Command line client
-===================
 
 .. _tezos_client_commands:
 
+Command line client
+===================
+
 .. raw:: html
          :file: tezos-client.html
 
-Administration command line client
-==================================
 
 .. _tezos_admin_client_commands:
 
+Administration command line client
+==================================
+
 .. raw:: html
          :file: tezos-admin-client.html
diff --git a/docs/whitedoc/michelson.rst b/docs/whitedoc/michelson.rst
index 95ffcf12a..a0480efb9 100644
--- a/docs/whitedoc/michelson.rst
+++ b/docs/whitedoc/michelson.rst
@@ -1258,7 +1258,7 @@ retrieved from script parameters or globals.
 
 
 Operations on Mutez
-~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~
 
 Mutez (micro-Tez) are internally represented by a 64 bit signed
 integers. There are restrictions to prevent creating a negative amount
@@ -1468,7 +1468,7 @@ Special operations
     :: 'S   ->   timestamp : 'S
 
 Operations on bytes
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~
 
 Bytes are used for serializing data, in order to check signatures and
 compute hashes on them. They can also be used to incorporate data from
@@ -2448,7 +2448,7 @@ treatment of annotations with `.`.
    :: @p.x 'a : @q.y 'b : 'S   ->  (pair ('a %x) ('b %y)) : 'S
 
 XI - JSON syntax
----------------
+----------------
 
 Micheline expressions are encoded in JSON like this:
 
@@ -2479,7 +2479,7 @@ As in the concrete syntax, all domain specific constants are encoded as
 strings.
 
 XII - Examples
--------------
+--------------
 
 Contracts in the system are stored as a piece of code and a global data
 storage. The type of the global data of the storage is fixed for each