update readme based on feedback from @fdr