vignettes: workflow & metadata