diff --git a/README b/README
new file mode 100644
index 0000000..142eed5
--- /dev/null
+++ b/README
@@ -0,0 +1,12 @@
+This is the home of era's configuration.
+
+If you want to setup your machine the same way as era, use all the nix files in
+this repository while installing nixos (or after). Feel free to tweak.
+
+Some expressions can be used independently, for instance, if you want to have
+the same vim configuration that I use, just:
+    
+    $ wget https://framagit.org/mpo/era-configuration-nix/raw/master/vim.nix
+    $ nix-env -f vim.nix -i vim
+
+(this may be updated in an unpredictable way)