diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..0691ca689eaa6936bb2c2608366359fc7c4a1a9b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Macao-Hugo
+Expérimentation avec le *static site generator* [Hugo](https://gohugo.io/) pour Macao-New
+
+# Setup
+- [Installer Hugo](https://gohugo.io/installation/)
+- `git clone gitlab@gitlab.tetras-libre.fr:macao/macao-hugo.git`
+- `cd macao-hugo/macao`
+
+Pour lancer en mode développement avec live reload : `hugo server`
+
+Pour build le site statique : `hugo`  
+Le contenu de `public/` peut être publié avec n'importe quel serveur HTTP statique.
\ No newline at end of file