Correct tests directory

More documentation, cleaning up the tests directory and starting the
RMarkdown vignette.