Correction of documentation.

_Status_: on going, do not merge yet.
No, I meanT to just switch mails and sent.