diff --git a/README.md b/README.md
new file mode 100644
index 0000000..114538e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Nix development shells
+
+This repository collects several examples of development environments to be used
+with `nix develop`.
+
+The definition of the environment is located in the `flake.nix` file and the
+precise version of the commit is stored in the `flake.lock` file. These two
+files provide all the required information to reproduce the environment by any
+user.
+
+Make sure they are tracked by git so that you can see what changes you do
+in your environment over time.
+
+To enter an environment, go to the directory with the `flake.nix` file and run
+`nix develop`.