General update of the readme file. Some clarifications added.