Updates

It would be particularly helpful to review the README and make sure it makes sense.
Well, the fact that it was confusing means the README isn't as clear as it should be. One ought to be able to understand this without needing to look at the code. Any suggestions on how to modify this doc to make it clearer?