diff --git a/README.md b/README.md
index cd6a013430..b05219bc85 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 
-#            ScoDoc - Gestion de la scolarité
+#            ScoDoc - Gestion de la scolarité - Version ScoDoc 8
 
 (c) Emmanuel Viennet 1999 - 2021 (voir LICENCE.txt)
 
@@ -12,15 +12,44 @@ Documentation utilisateur: <https://scodoc.org>
 
 N'utiliser que pour les développements et tests, dans le cadre de la migration de Zope vers Flask.
 
-Basée sur **python 2.7**.
+La version ScoDoc8 est basée sur Flask (au lieu de Zope) et sur **python 2.7**.
+Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3.
+
+De très nombreux changements sont susceptibles d'affecter l'API, mais on s'efforce à ce que rien 
+ne soit visible des utilisateurs.
+
+## Work in Progress (WIP)
+
+En général, les commits indiqués "WIP" ne tournent pas.
+
+### État actuel (21 juin 21)
+
+ - l'ensemble des pages est raccordé, sauf "entreprises" et la gestion des utilisateurs (de ce fait, de nombreuses pages plantent).
+
+ - pas d'excel (voir si on réinstalle `pyExcelerator` ou si on migre immédiatement ?), pdf non testé (mais devrait marcher ?).
+
+**En cours:**
+ 
+ - recodage pages gestion utilisateurs avec SQLAlchemy.
+ 
+ - migration bases `SCUUSERS`vers `SCO8USERS`
+ 
+ - raccorder page "entreprises".
+
 
 ## Setup (sur Debian 10 / python2.7)
 
+Pour les dev, le plus simple est de partir d'une install fonctionnelle de ScoDoc7 sous git, et de changer de branche
+
+    git checkout ScoDoc8
+
+Puis d'installer Flask comme suit:
+
     virtualenv envsco8
 
     source envsco8/bin/activate
 
-installation:
+Installation:
 
     pip install flask
     # et pas mal d'autres paquets
@@ -50,9 +79,6 @@ Installer le bon vieux `pyExcelerator` dans l'environnement:
 
     python -m unittest tests.test_users
 
-# Work in Progress
 
-## Migration ZScolar
 
-### Méthodes qui ne devraient plus être publiées: