Update README to reflect changes in refactor

Fixes #17
Fixes #27
we should move this section to the end of the usage, or as troubleshooting