updated README + vignettes