Major updates to vignette and README.md