add to shame comments, fix readme typos