Excuse Me, Do You Have a Moment to Talk About Version Control?

Authors
Citation
Bryan Jennifer, Excuse Me, Do You Have a Moment to Talk About Version Control?, American statistician , 72(1), 2018, pp. 20-27
Journal title
ISSN journal
00031305
Volume
72
Issue
1
Year of publication
2018
Pages
20 - 27
Database
ACNP
SICI code
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 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.