updates to the draft vignette