improved readme and some comments