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 220938c..cf50491 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,22 +1,22 @@
 .. _swh-loader-core:
 
 Software Heritage - Loader foundations
 ======================================
 
 Low-level loading utilities and helpers used by other loaders.
 
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
-   README.md
+   README
 
 
 Reference Documentation
 -----------------------
 
 .. toctree::
    :maxdepth: 2
 
    /apidoc/swh.loader.core