Excuse me, do you have a moment to talk about version control?

RStudio, Boston, United States
Department of Statistics, University of British Columbia, Vancouver, British Columbia, Canada
DOI
10.7287/peerj.preprints.3159v2
Subject Areas
Computer Education, Data Science, Scientific Computing and Simulation, Software Engineering
Keywords
Git, GitHub, workflow, data science, R Markdown, reproducibility, R language
Copyright
© 2017 Bryan
Licence
This is an open access article distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, reproduction and adaptation in any medium and for any purpose provided that it is properly attributed. For attribution, the original author(s), title, publication source (PeerJ Preprints) and either DOI or URL of the article must be cited.
Cite this article
Bryan J. 2017. Excuse me, do you have a moment to talk about version control? PeerJ Preprints 5:e3159v2

Abstract

Data analysis, statistical research, and teaching statistics have at least one thing in common: these activities all produce many files! There are data files, source code, figures, tables, prepared reports, and much more. Most of these files evolve over the course of a project and often need to be shared with others, for reading or edits, as a project unfolds. Without explicit and structured management, project organization can easily descend into chaos, taking time away from the primary work and reducing the quality of the final product. This unhappy result can be avoided by repurposing tools and workflows from the software development world, namely, distributed version control. This article describes the use of the version control system Git and and the hosting site GitHub for statistical and data scientific workflows. Special attention is given to projects that use the statistical language R and, optionally, R Markdown documents. Supplementary materials include an annotated set of links to step-by-step tutorials, real world examples, and other useful learning resources.

Author Comment

Added citation to https://doi.org/10.7287/peerj.preprints.3181v1. Added link to a markdown tutorial in the supplement.

Supplemental Information

Appendix: annotated list of relevant resources

DOI: 10.7287/peerj.preprints.3159v2/supp-1