README & comments update