update the API and readme

- Breaking change, but simple and for the better.