small improvements to the vignette