more docs and typos