updated docs and api