Documentation updates

I've updated the documentation in the readme for `_read` to (hopefully) make the new usage clearer.  I based the changes on the tests in the Node repository.