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
@@ -5,6 +5,7 @@
 
 Python module template, used as skeleton to create new modules.
 
+.. include:: README.rst
 
 .. toctree::
    :maxdepth: 2