Update README to reflect changes in refactor

Fixes #17
Fixes #27
Apply suggestions to README