diff --git a/README.md b/README.md
index 3bd4c0f..792de03 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,40 @@
 # scodoc-cohortes
 
-Visualisation des cohortes de BUT depuis scodoc
\ No newline at end of file
+Visualisation des cohortes de BUT depuis scodoc
+
+Ce programme utilise l'API pour générer des graphes de Sankey permettant
+de visualiser le devenir d'une cohorte.
+
+La notion de cohorte devient difficile à traiter lorsqu'on considère
+l'existence de passerelles permettant d'entrer à n'importe quel année
+d'étude.
+
+La vision proposée est de regarder tous les semestres consécutifs en
+partant d'une année de référence, et tous les élèves qui touchent ces
+semestres.
+
+On peut alors dégager divers indicateurs de sortie :
+
+  * Sortie en BUT3 avec le diplôme
+  * Sortie en BUT2 avec décision de jury positive (ADM/ADJ) qui implique
+    normalement la possibilité de poursuivre ses études ailleurs
+  * Autorisation de redoublement et l'élève revient
+  * Sortie en BUT1 ou BUT2 avec la possibilité de continuer, mais l'élève
+    ne revient pas
+  * Autorisation de redoublement et l'élève ne revient pas
+  * Toute autre sortie du flot de la cohorte
+
+Le premier type de sortie est assurément un succès, et c'est discutable pour
+le deuxième. Le taux de réussite est fourni par une fourchette.
+
+Le troisième type n'est ni une réussite ni un échec, et comptera
+plus tard comme une réussite ou un échec dans une cohorte ultérieure.
+
+Les trois derniers types, à des niveaux divers, sont des échecs. Le taux
+d'échec est donc fourni comme une fourchette entre le dernier type et la
+somme des trois derniers.
+
+Il existe un dernier type (qui tombe dans le 5 ou le 6 actuellement), c'est
+le cas d'un élève en BUT3 qui ne valide pas le BUT3, a validé le BUT2, et
+partirait dans une autre filière après. Le cas paraît beaucoup plus douteux que le deuxième type et est pour le moment classé en échec.
+