Standardisation des scripts

Readme.org

@@ -147,6 +147,29 @@ une modification concurrente de type lire-modifier-écrire, utiliser
 =atomic_update_json= : cet utilitaire protège l'opération complète avec
 un verrou inter-processus Linux/Windows.
 
+*** Convention des scripts standardisés
+
+Les scripts standardisés exposent =build_parser()=, =run(...)= et
+=main(argv=None)=. Leur import ne lance aucun traitement. Ils acceptent
+le dossier d'évaluation comme premier argument positionnel, utilisent
+=EvaluationWorkspace= pour les chemins partagés et peuvent afficher la
+trace complète d'une erreur avec =--verbose=.
+
+Les codes de sortie communs sont :
+
+| Code | Signification |
+|------+---------------|
+|    0 | réussite |
+|    1 | erreur de traitement |
+|    2 | arguments invalides |
+|    3 | évaluation ou prérequis invalides |
+|    4 | traitement partiel, avec avertissements |
+|  130 | interruption par l'utilisateur |
+
+Le GUI distingue notamment un traitement partiel d'un échec. Les
+premiers scripts migrés vers cette convention sont =export.py=,
+=import.py=, =giving_names.py= et =grouping.py=.
+
 ** Correction d'un paquet de copies
 
  1. Créer un fichier =names= dans le dossier courant, avec les