diff --git a/README.md b/README.md
index 7f13a40b6a4686754d0a522f3d70836427e221e3..d4d6748d85575ba2b7e8ad078b0056c6e2ea5306 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,24 @@
 
+Deadlock Theia projet basé sur notre propre image de Theia https://git.e-biz.fr/deadlock-public/theia.
+Plusieurs éléments ajoutés à l'image de base :
+
+1. Deadlock plugins (deadlock-plugins/)
+2. Outil d'enregistrment, qui permet d'enregistrer le code quand un utilisateur exécute du code (deadlock(plugins/recorder))
+
+## Construire les plugins :
+`./build-plugins.sh`
+
+Tous les plugins qui se trouvent dans `deadlock-public` vont être construit en `.vsix` puis placés
+dans `plugins/` (ex: deadlock-plugins/deadlock-extension).  
+Il est aussi possible d'ajouter directement des plugins `.vsix` en ajoutant le fichier dans `plugins/`
+
+## Construire le recorder :
+Utilisation du webpack présent dans `recorder-out/` par défaut.  
+`./build-recorder.sh`
+
+## Construire l'image Deadlock Theia avec le recorder et les plugins
+`./build.sh VERSION`
+
 # Requirements:
 1. NodeJS > 14.X
 2. Vscode ou Vscodium