tweaks to API docs