updating readme
adding better documentation
adding documentation to close #3
merging upstream
Merge pull request #5 from stanzheng/master

answer ryans questions on #3