fix typos and better doc