update the docs to reflect last changes of the APIs