updated docs for API changes