Port readme and update to reflect API changes
Merge pull request #9 from markdalgleish/update-readme

Port readme and update to reflect API changes.