docs and vignette