diff --git a/README.md b/README.md
index 56804e8..2e5b1ee 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,40 @@ Suite de tests du [logiciel de gestion d'association Paheko](https://fossil.kd2.
 - [Selenium IDE](https://www.selenium.dev/selenium-ide)
 - [Selenium runner](https://www.selenium.dev/selenium-ide/docs/en/introduction/command-line-runner)
 
+### Remarques
+- l'IDE produit du code en version 2
+- le runner veut du code version 3
+- il faut donc convertir le fichier produit par l'IDE avec la commande
+```
+npx @seleniumhq/side-migrate
+```
+(voir Makefile)
+
+## Config serveur
+- définir un hôte virtuel : `test.paheko.localhost`
+
+## Exécuter les tests
+Le script `runtest.sh` permet d'exécuter un, plusieurs ou tous les tests
+d'un fichier de test *Selenium* ; il positionne quelques constantes,
+convertit le fichier produit par l'IDE si nécessaier et copie dans /tmp les
+fichiers requis par les tests.
+
+Il y a un bug en fin d'exécution (voir commentaire dans le script) ;
+pour le contourner, le script *tue* le processus quand le message de
+fin apparaît.
+
+### Options en ligne de commande :
+-f fichier    : fichier de test
+-a            : exécuter tous les tests du fichier
+-c            : afficher la fenêtre de chrome
+-n            : ne pas tuer le processus en fin de test
+-v            : afficher la ligne de commande
+-z répertoire : sauver une copie d'écran dans le répertoire en cas d'échec
+-t timeout    : définir une attente max (défaut : 200000 ms)
+-h            : afficher cette aide
+test          : nom (partiel ou complet) d'un test ou d'une suite à exécuter
+                si absent, affiche un sélecteur pour choisir une des suites du fichier
+
 ## Tests installation
 
 ## Tests de connexion