update vignette with references
update vignette