align docs with current api