update api to be a bit cleaner
update docs