update documentation and typos