added more comments and removed ambiguities
added readme for final turnin