diff --git a/README.md b/README.md
index a7c5695..342c4c0 100644
--- a/README.md
+++ b/README.md
@@ -2,13 +2,78 @@
# Le site web de la distorsion !
+## TODO
+
+- Réparer la CI. Héberger nos propre runners ?
+- Documenter l'édition du site à partir de l'interface web du dépot git.
+ Comment rajouter/enlever des évènements à venir ? Comment ajouter un billet
+ de blog ? Comment ajouter une feuille de style ?
+
## Site actuel
Le site est super basique : c'est juste des fichiers statiques html, css et js
servis depuis un bucket S3, hébergé chez les camarades de
[deuxfleurs](https://deuxfleurs.fr).
-### Test
+## Edition
+
+On choisit volontairement de s'imposer des contraintes techniques assez fortes
+pour que le site reste le plus simple possible, et puisse servir de support
+pour comprendre les technologies à la base du Web. On veille collectivement à
+cette simplicité, ce qui implique le mode de fonctionnement suivant pour les
+éditions du site :
+
+- Pour les petites éditions de contenu, typiquement mettre à jour la liste des
+ évènement à venir : push dans la branche `main`.
+- Pour tout le reste à priori, comme éditer la structure du site (header,
+ footer, CSS) ou ajouter des billets de blog, on fait les modifications dans
+ une branche séparée, et on ouvre une pull request.
+
+## Choix techniques
+
+On essaye de documenter ici les choix techniques qui ont fait l'objet de
+débats, et qui sont peut être pas évidents.
+
+### 2024/10/25: Gestion du contenu qui se répète
+
+Les contenus qui se répète sont principalement les éléments `