split up vignette into chunks
cleaning up old vignettes
moved links out of headers
minor doc updates