update docs for typos, clarity