minor doc changes and vignettes