fix typos and add clarifications