update documentation and fix typos