documentation part2

Finishing documentation, pending to be reviewed