revise vignettes/ tutorials

[mdsteiner]

go through vignettes and tutorials and revise them to be

1. clearer and easier to understand
2. more streamlined