docs update for new api changes