trying to update docs with latest API info