changed docs after merging the new api branch