add changes from alejandro
first subsection commented to please reviewer 1
main changes according to reviewer 3