Task/review documentation

Review and update the documentation.
Ups. I was mistaken, the colon belong to de dashed lines. 

Fixed in  44274be