diff --git a/README.rst b/README.rst
new file mode 120000
--- /dev/null
+++ b/README.rst
@@ -0,0 +1 @@
+docs/README.rst
\ No newline at end of file
diff --git a/README.md b/docs/README.rst
rename from README.md
rename to docs/README.rst
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,10 +1,6 @@
 .. _swh-py-template:
 
-Software Heritage - Python module template
-==========================================
-
-Python module template, used as skeleton to create new modules.
-
+.. include:: README.rst
 
 .. toctree::
    :maxdepth: 2