diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c6eebef93e936a594729db083d4c17599eac26ce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+## Welcome to your new Fab Academy site
+
+- This website is built automatically by gitlab every time you edit the files in the docs folder
+- It does so thanks to [Mkdocs](https://mkdocs.org) a static site generator written in Python
+- You must start customizing the file mkdocs.yml with your information
+- You can change the looks of your website using mkdocs themes, you can find in the mkdocs.yml the names of the available themes
+- If you want to start from scratch, you can delete everything in this repository and push any other static website