adding docs/comments
updated README