Task/review documentation

Review and update the documentation.
Fixed in  1ebc899