updated vignettes / README