pull changes made to vignette

edited section 2 of vignette, finished section 3