fix typos and clarify some questions