diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..5ca1c53d110c0555bc360b21d2157e280c3cfe07
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+The reference API data of Grid'5000 is stored in a git repository as JSON files. Those files are organized into hierarchical folders (see data/). The git repository comes with scripts to ease the generation of those API files (see generators/). The generator uses data from input/. The node information (input/grid5000/sites/*/clusters/*/nodes/*.yaml) is fetched using [g5k-checks](https://github.com/grid5000/g5k-checks). The other input files are created manually.
+
+The git repository also includes scripts for generating:
+* The OAR properties ie. the node information that is registered in OAR databases. OAR properties allow user to select resources matching their experiment requirements.
+* The configuration files of the following puppet modules: bindg5kb, conmang5k, dhcpg5k, kadeployg5k and lanpowerg5k.