Mise a jour des README

README.rst

@@ -3,18 +3,10 @@ Pour le moment, la plateforme d'exercices interactifs pour `WIMS
 l'enseignement de l'informatique. L'objectif de ce dépôt est de
 développer collaborativement de nouveaux modules.
 
-Le module `U2~coding~oefprogramC.fr/`_ contient un dérivé du module
-éponyme déjà existant dans WIMS, avec quelques menues améliorations.
+Modules:
 
-Le module `test~coding~readingCppPrograms.fr/`_ présente à l'étudiant
-des programmes qu'il doit lire et comprendre, afin de deviner quelle
-sera la sortie, ou bien l'entrée appropriée pour obtenir 42. Les
-programmes sont tirés d'une collection de programmes groupés par
-thèmes. Contribuer un nouveau programme est simple: il suffit de
-l'ajouter dans le répertoire idoine. Voir
-`test~coding~readingCppPrograms.fr/README`_. Pour l'instant, la
-collection est constituée d'exercices de C++, donnés dans le cadre des
-cours d'introduction à l'informatique `Info 111
-<Nicolas.Thiery.name>`_ et Info 121 de la licence MPI de l'Université
-Paris Sud, mais l'infrastructure est conçue pour être généralisable à
-d'autres langages de programmation.
+- `U2~coding~oefprogramC.fr/`_: un dérivé du module éponyme déjà
+  existant dans WIMS, avec quelques menues améliorations.
+
+- `Compréhension de programmes C++ <test~coding~readingCppPrograms.fr/>`_:
+  deviner l'entrée ou la sortie d'un programme

test~coding~readingCppPrograms.fr/README → test~coding~readingCppPrograms.fr/README.rst

+Module WIMS: Compréhension de programmes C++
+============================================
+
+Présentation
+------------
+
+Ce module présente à l'étudiant des programmes qu'il doit lire et
+comprendre, afin de deviner quelle en sera la sortie, ou bien l'entrée
+appropriée pour obtenir 42. Les programmes sont tirés aléatoirement
+d'une collection de programmes groupés par thèmes. Pour rajouter un
+nouveau programme il suffit de l'ajouter dans le répertoire
+idoine. Voir ci-dessous.
+
+Pour l'instant, la collection est constituée d'exercices de C++,
+donnés dans le cadre des cours d'introduction à l'informatique `Info
+111 <Nicolas.Thiery.name>`_ et Info 121 de la licence MPI de
+l'Université Paris Sud, mais l'infrastructure est conçue pour être
+généralisable à d'autres langages de programmation.
+
+
+Étendre le module avec de nouveaux programmes
+---------------------------------------------
+
+Le répertoire `data/`_ contient des programmes C++. Le nom des
+programmes est de la forme ``<theme>_nom.cpp`` ou ``<theme>_nom_input.cpp``.
+
+Dans le premier cas, l'utilisateur doit deviner la sortie du
+programme. Dans le second cas, le programme doit lire un entier entre
+0 et 99 sur l'entrée standard, et l'utilisateur doit deviner lequel
+donne 42; pour l'instant cet entier doit être unique.
+
+L'infrastructure du module est implantée dans
+`src/cpp/read_program.cpp`_.
+
+
+Mise à jour de l'exercice sur WIMS
+----------------------------------
+
+wims.u-psud.fr -> serveur de l'université -> Accueil WIMS -> modtools -> login -> Restauration
+
+
+Documentation générique des modules WIMS
+========================================
+
 Pour installer des exercices OEF dans un module :
 
  1. Créer un module de type OEF
@@ -28,16 +72,3 @@ en changeant le nom.
    doit être répétée à chaque fois que les fichiers sources sont modifiés). 
 
 
-%%%%
-
-Le répertoire data/ contient des programmes C++. Le nom des programmes
-est de la forme <theme>_nom.cpp ou <theme>_nom_input.cpp.
-
-Dans le premier cas, l'utilisateur doit deviner la sortie du
-programme. Dans le second cas, le programme doit lire un entier entre
-0 et 99 sur l'entrée standard, et l'utilisateur doit deviner lequel
-donne 42; pour l'instant il doit être unique.
-
-Mise à jour de l'exercice sur WIMS:
-
-wims.u-psud.fr -> serveur de l'université -> Accueil WIMS -> modtools -> login -> Restauration