updated readme and adding comments

Wrapping up ep4, update readme.html and add comments to new methods and
classes.