DOC: clean up typos, formatting; add reference