updates to the vignette