small updates to vignette