diff --git a/README.md b/README.md
deleted file mode 100644
--- a/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-swh-py-template
-===============
-
-Python module template, used as skeleton to create new modules.
-
diff --git a/docs/index.rst b/README.rst
copy from docs/index.rst
copy to README.rst
--- a/docs/index.rst
+++ b/README.rst
@@ -4,16 +4,3 @@
 ==========================================
 
 Python module template, used as skeleton to create new modules.
-
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
diff --git a/docs/README.rst b/docs/README.rst
new file mode 120000
--- /dev/null
+++ b/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,10 +1,4 @@
-.. _swh-py-template:
-
-Software Heritage - Python module template
-==========================================
-
-Python module template, used as skeleton to create new modules.
-
+.. include:: ../README.rst
 
 .. toctree::
    :maxdepth: 2
@@ -12,7 +6,7 @@
 
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`