improve docs, fix typos