fix some doc faux pas