readme notes and fix typos