update vignettes and README