readme and vignette update