documentation and vignette updates