diff --git a/doc/programmers/documentation.rst b/doc/programmers/documentation.rst
index b979fb8b7..214210369 100644
--- a/doc/programmers/documentation.rst
+++ b/doc/programmers/documentation.rst
@@ -59,12 +59,14 @@ To have an offline version of the documentation just issue
 in the ``doc`` folder:
 
 .. code-block:: bash
+
    sphinx-build . _build
 
 The HTML will be stored in ``_build/``. Open the ``_build/index.html`` file with
 your browser to see and browse the documentation.
 
 .. warning::
+
    It is only possible to build documentation locally from within the ``doc``
    folder.
    This choice was made to simplify the set up of the ReadTheDocs and local