revise vignettes