fix typos, clarify docs