Make readme read a little better.
Take some lies out of the API documentation.