Updates documentation

@daviddemello Can you please take a look at the documentation and let me know if you have questions, changes or additions? 

@carolineHecht Your feedback is welcome too.