improved code docs
Adding README documentation
Fixed formatting in README
Minor additions to the text
Merge branch 'readme'