update docs and API