minor tweaks to api documentation