markdown vignette for reading on github