updated documentation and vignette