improve docs and fix typo