To help you use rOpenSci packages we put tutorials up on our site at /tutorials. Up to now, we created them with combination of raw html + converting code blocks to html and inserting them, etc. – it was a slow process to update them when changes happened in our packages. So we thought of a better plan… Recently CRAN started accepting R package vignettes (basically, tutorials built in to packages) in R Markdown format. This is great because executable Markdown with code plus text is easy to do with the help of knitr. And since our website is created using Jekyll, we can take our package vignettes with only text and code as a .Rmd file, convert to a .md file with text + code + the output of that code, insert some yaml metadata at the top, and have Jekyll automagically generate html pages. This may sound complicated, but once we have the vignette in a package, it’s just a few lines of code away from generating the html page for this site.

If you’re looking for examples of how our R packages or resources have been used, search no more! We collect use cases in a public forum and we created a template there to help you share yours. Below is a random subset as well as a searchable archive of all use cases. Browse them, and report your own use case(s). For more illustrations of our packages’ use, also see the citations page.

All of our packages in one place