diff --git a/roboc/readme.md b/roboc/readme.md
index 5f6dc9c..da226b6 100644
--- a/roboc/readme.md
+++ b/roboc/readme.md
@@ -2,17 +2,18 @@
 
 ## Consignes
 
-Votre mission est de concevoir et développer un petit jeu permettant de
+> Votre mission est de concevoir et développer un petit jeu permettant de
 contrôler un robot dans un labyrinthe. Ce jeu devra être développé en
 console pour des raisons d'accessibilité. Je l'ai appelé... Roboc.
 
-Le jeu est un labyrinthe formé d'obstacles: des murs qui sont tout
+> Le jeu est un labyrinthe formé d'obstacles: des murs qui sont tout
 simplement là pour vous ralentir, des portes qui peuvent être traversées
 et au moins un point par lequel on peut quitter le labyrinthe. Si le
 robot arrive sur ce point, la partie est considérée comme gagnée.
 
-Consignes détaillée de l'exercice sur
-[OpenClassrooms](https://openclassrooms.com/courses/apprenez-a-programmer-en-python/exercises/180).
+Pour les consignes détaillées de l'exercice rendez-vous dans le cours
+_[Apprenez à programmer en Python](https://openclassrooms.com/courses/apprenez-a-programmer-en-python/exercises/180)_
+d'**Open Classrooms**.
 
 ## Utilisation
 
@@ -22,8 +23,11 @@ script contient 4 fichiers et 1 répertoire:
  - `roboc.py`: fichier à lancer
  - `configuration.py`: contient les constantes/variables de
  configuration du script, ainsi que les fonctions.
- - `map.py`: contient l'objet Map
- - `readme.md`
+ - `map.py`: fourni les moyens necessaire a l'utilisation d'un fichier
+ carte. Controle de coherance sur la carte choise, deplace le robo en
+ fonction des commandes du joueur jusqu'en fin de partie.
+
+ - `readme.md`, que vous êtes en train de lire!
  - `cartes`: répertoire contenant les cartes de jeu (fichier `.txt`)
 
 ## Contrôle du robot
@@ -50,6 +54,7 @@ de les continuer plus tard
 J'ai choisi d'implementer la sauvegarde par tour, qui sera de fait,
 réalisée quand le joueur quitte. Les 2 fonctionnalitées sont ainsi
 respectées.
+
 ## Bonus
 
 Quelques fonctionnalitées en bonus:
@@ -58,3 +63,6 @@ Quelques fonctionnalitées en bonus:
  ne sont pas jouable
  - affichage du recap des commandes (aide), permettant d'ajouter
  d'autres commades utilisateur plus tard
+ - la docstring du fichier `map.py` contient des [DocTests](http://sametmax.com/les-docstrings/),
+ ça ne fait pas partie du cours, mais c'est un outils facile de
+ test/debug que j'utilise et qui reste transparent.