updating docs to match some changes in the api