DOC: added comments and updated readme
DOC: updated readme