add notes & fix typos