updates in docu and vignettes