updated vignette with better examples