From 1ff8fa009ab64780e9f6d229d35f721623c0390c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Maniaci?= <stephane.maniaci@beta.gouv.fr>
Date: Thu, 12 Dec 2024 10:25:49 +0100
Subject: [PATCH] docs: spruce up the Docker bits

---
 docs/ONBOARDING.md | 44 ++++++++++++++++++++++++++------------------
 1 file changed, 26 insertions(+), 18 deletions(-)

diff --git a/docs/ONBOARDING.md b/docs/ONBOARDING.md
index 07fee214bb..8e60a85d98 100644
--- a/docs/ONBOARDING.md
+++ b/docs/ONBOARDING.md
@@ -18,7 +18,32 @@ D'autres conseils que j'ai lu c'est de faire `git config core.precomposeunicode
 
 ## Mise en place de l'environnement dev
 
-Please note that the `staging` and `main` branches are protected and all commits must come through a pull request.
+Please note that the `staging` and `main` branches are protected and
+all commits must come through a pull request.
+
+Vous pouvez installer en local ou utiliser l'environnement Docker pour
+démarrer.
+
+### Avec Docker
+
+Un environnement Docker/Docker-Compose est fourni. Pour construire les
+images et lancer les services :
+
+```sh
+make build
+make up
+```
+
+Voir le [Makefile](../Makefile) pour des commandes utiles.
+
+Dans un nouveau terminal, accèder au container du back pour migrer la
+BDD et créer la première utilisatrice.
+
+```sh
+make sh
+python manage.py migrate
+python manage.py createsuperuser
+```
 
 ### À installer localement
 
@@ -347,23 +372,6 @@ Vous pourrez modifier les notes dans un éditeur pour être plus rapide.
 - supprimer la partie "by @username in https://..."
 - faire n'importe quel autre changement pour rendre la liste facilement comprensible par tout le monde
 
-### Debugging
-
-Si jamais vous doutez/si il y a un problème, parlez avec un.e autre dév.
-
-## Docker
-
-C'est aussi possible de lancer le site avec Docker.
-
-`docker compose build`
-`docker compose up`
-
-Dans un nouveau terminal, accèder au container du back pour migrer la BDD et créer la première utilisatrice.
-
-`docker compose run server bash`
-`python manage.py migrate`
-`python manage.py createsuperuser`
-
 ### Développement
 
 Pour le formattage automatique de fichiers (prettier), faut avoir quelques dependences npm installé en locale.