tweaks to api-doc, including minor fixes and rephrasings