update readme and fix typos in comments