updated readme close #10 and code comments close #11