tweaks to api docs