updated vignettes, documentation and spelling