readme and API changes