add doc describing API changes