update the docs with the API changes