Revamp of README for the new API.
Includes updates to the tests.