doc: more rewrite.

Signed-off-by: Raphaël Barrois <raphael.barrois@polytechnique.org>