diff --git a/docs/.gitignore b/docs/.gitignore
index f6b5c55..58a761e 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,4 +1,3 @@
 _build/
 apidoc/
 *-stamp
-README.md
diff --git a/docs/README.md b/docs/README.md
new file mode 120000
index 0000000..32d46ee
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1 @@
+../README.md
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 9c7dd9b..9d678ec 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,23 +1,23 @@
 .. _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: 1
    :caption: Contents:
 
-   README
+   README.md
    dev-info.rst
 
 
 Indices and tables
 ==================
 
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`