diff --git a/README.md b/README.md
index 3e271cf..f6390cd 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-# nix-config
-My Machines configurations
-More to come...
+# My NixOS Configurations ❄
+
+This repository contains the configurations of my machines using NixOS. 
+
+### *What is NixOS ?*
+
+NixOS is a linux distribution based on the Nix package manager. It allows fully reproducible builds and a declarative configuration style, using a functionnal langage called Nix (yes, it is the same name as the package manager and the OS).
+
+### *What is a flake ?*
+
+This whole repository is a flake. It is an experimental feature of Nix.