more comments inside the code, new readme