Task/review documentation

Review and update the documentation.
Fixed in  c81816a