diff --git a/doc/install.rst b/doc/install.rst
index 4572f9d..e239605 100644
--- a/doc/install.rst
+++ b/doc/install.rst
@@ -36,7 +36,7 @@ mail filter to hook into a MTA).
 
 The ``pagure-ev`` package contains the eventsource server.
 
-..note: The last two packages are optional, pagure would work fine without
+..note:: The last two packages are optional, pagure would work fine without
         them.
 
 * From the sources
@@ -46,15 +46,19 @@ you can easily rebuild it as RPM.
 
 Simply follow these steps:
 # Clone the sources::
+
     git clone https://pagure.io/pagure.git
 
 # Go to the folder::
+
     cd pagure
 
 # Build a tarball of the latest version of pagure::
+
     python setup.py sdist
 
 # Build the RPM::
+
     rpmbuild -ta dist/pagure*.tar.gz
 
 This will build pagure from the version present in your clone.
@@ -75,16 +79,19 @@ of the web applications of pagure (ie: the core + the doc server).
 
 To install pagure via this mechanism simply follow these steps:
 # Clone the sources::
+
     git clone https://pagure.io/pagure.git
 
 # Go to the folder::
+
     cd pagure
 
 # Install the latest version of pagure::
+
     python setup.py build
     sudo python setup.py install
 
-..note: To install the eventsource server or the milter, refer to their
+..note:: To install the eventsource server or the milter, refer to their
         respective documentations.
 
 # Install the additional files as follow:
@@ -138,6 +145,7 @@ make ``/srv/git`` the home of your gitolite user.
 
 You would then create the folders with:
 ::
+
     mkdir /srv/git/repositories/{docs,forks,tickets,requests,checkouts}
 
 
@@ -174,6 +182,7 @@ will not be allowed to read git repositories created and managed by gitolite.
 To give apache this permission (required to make git clone via http work),
 we use file access control lists (aka FACL):
 ::
+
     setfacl -m user:apache:rx --default
     setfacl -Rdm user:apache:rx /srv/git
     setfacl -Rm user:apache:rx /srv/git
diff --git a/doc/install_evs.rst b/doc/install_evs.rst
index 4d2c4ad..2819e3e 100644
--- a/doc/install_evs.rst
+++ b/doc/install_evs.rst
@@ -12,13 +12,14 @@ Configure your system
 The eventsource server is easy to set-up.
 
 * Install the required dependencies
+
 ::
 
     python-redis
     python-trollius
     python-trollius-redis
 
-..note: We ship a systemd unit file for pagure_milter but we welcome patches
+..note:: We ship a systemd unit file for pagure_milter but we welcome patches
         for scripts for other init systems.
 
 
@@ -38,6 +39,7 @@ The second file is the systemd service file.
 
 
 * Finally, activate the service and ensure it's started upon boot:
+
 ::
 
     systemctl enable redis
diff --git a/doc/install_milter.rst b/doc/install_milter.rst
index fbb8a85..fb029d6 100644
--- a/doc/install_milter.rst
+++ b/doc/install_milter.rst
@@ -13,14 +13,15 @@ Configure your system
 ---------------------
 
 * Install the required dependencies
+
 ::
 
     python-pymilter
 
-..note: We ship a systemd unit file for pagure_milter but we welcome patches
+..note:: We ship a systemd unit file for pagure_milter but we welcome patches
         for scripts for other init systems.
 
-..note: It also requires a MTA, we used postfix.
+..note:: It also requires a MTA, we used postfix.
 
 
 * Create an alias ``reply``
@@ -71,6 +72,7 @@ The third file is the systemd service file.
 
 
 * Activate the service and ensure it's started upon boot:
+
 ::
 
     systemctl enable pagure_milter