fix typos in comments
update README, extract implementation notes