added vignette

Use knitr child documents to reuse the same text in README and the vignette