Do as i Do, Not as i Say

Do Contribution Guidelines Match the GitHub Contribution Process?

Conference paper (2019)

Authors

Omar Elazhary University of Victoria
Margaret Anne Storey University of Victoria
Neil Ernst University of Victoria
A.E. Zaidman Software Engineering - EEMCS
Research Group
Software Engineering (EEMCS) (TU Delft)
Copyright: © 2019 Omar Elazhary, Margaret-Anne Storey, Neil Ernst, A.E. Zaidman
DOI: https://doi.org/10.1109/ICSME.2019.00043
Automation Software engineering Code contributions
More Info
expand_more

Published Date

2019

Language

English

Reuse Rights

Other than for strictly personal use, it is not permitted to download, forward or distribute the text or part of it, without the consent of the author(s) and/or copyright holder(s), unless the work is under an open content license such as Creative Commons.

Faculty

Electrical Engineering, Mathematics and Computer Science

Department

Software Technology

Research Group

Software Engineering

Abstract

Developer contribution guidelines are used in social coding sites like GitHub to explain and shape the process a project expects contributors to follow. They set standards for all participants and 'save time and hassle caused by improperly created pull requests or issues that have to be rejected and re-submitted' (GitHub). Yet, we lack a systematic understanding of the content of a typical contribution guideline, as well as the extent to which these guidelines are followed in practice. Additionally, understanding how guidelines may impact projects that use Continuous Integration as part of the contribution process is of particular interest. To address this knowledge gap, we conducted a mixed-methods study of 53 GitHub projects with explicit contribution guidelines and coded the guidelines to extract key themes. We then created a process model using GitHub activity data (e.g., commit, new issue, new pull request) to compare the actual activity with the prescribed contribution guidelines. We show that approximately 68% of these projects diverge significantly from the expected process.