minor examples bug fix
section 1 draft 1 of the vignette complete
more vignette