updated read me and inline comments