convert the long example to a vignette, and add shorter examples