updated vignette and proof read