correct typos and improve docs