user guide: use the vignette (still in prep)