diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..4ef7e8e
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,5 @@
+<!-- the README is inserted here automatically-->
+
+--8<-- "README.md"
+
+<!--- write additional info that you only want to appear in the docs index here -->