diff --git a/docs/.gitignore b/docs/.gitignore
index 58a761e..f6b5c55 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,3 +1,4 @@
 _build/
 apidoc/
 *-stamp
+README.md
diff --git a/docs/Makefile b/docs/Makefile
index c30c50a..a3ad69b 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1 +1,6 @@
 include ../../swh-docs/Makefile.sphinx
+
+html: copy_md
+
+copy_md:
+	cp ../README ./README.md
diff --git a/docs/index.rst b/docs/index.rst
index 318ba43..78a5071 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,20 +1,20 @@
 .. _swh-indexer:
 
 Software Heritage - Indexer
 ===========================
 
 Tools and workers used to mine the content of the archive and extract derived
 information from archive source code artifacts.
 
-
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
+   README
 
 Indices and tables
 ==================
 
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`