fix typos and improve wording based on code review