Talk at R Summit and Workshop about using R Markdown and GitHub in your workflow
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Talk at R Summit and Workshop

In case it's not clear from the slides, here's the main gist: Based on my experience ...

  • as an instructor, where I use R Markdown and GitHub heavily in graduate courses, and
  • as an R power user, working to become more of a developer

I've formed strong opinions about workflows for R Markdown + GitHub and what the big wins are.

  • Make it a habit to render .Rmd and .R files to Markdown and, maybe, HTML. Places those files where people can see them, e.g. on GitHub! They help people decide whether they need or want to obtain and run your code.
  • Exploit Markdown and other browsability features of GitHub to make your source repo do double duty as a decent project webpage. Refine your policies about never commiting an intermediate or final product.
  • Advanced GitHub searching, coupled with Winston Chang's mirror of R source and Gábor Csárdi's mirror of CRAN, helps you implement "read the source" in an efficient manner.
  • GitHub Issues are a very versatile way to faciliate conversations that can be, by turns, conversational or technical and code-based.
  • Never pick NA as your username for anything.

Want to see the slides?


This talk sort of evolved from my Feb 2015 talk at the Fields Institute. So you might want to check out that too.

STAT 545:

Rough notes on GitHub usage in STAT 545:

My Gist about searching GitHub

The unreasonable effectiveness of GitHub browsability

General resources:

Great things to read: