Published October 30, 2018 | Version v2
Dataset Open

Information Needs in Contemporary Code Review - Appendix

  • 1. Delft University of Technology
  • 2. Software Improvement Group
  • 3. University of Zurich

Contributors

Researcher:

  • 1. Delft University of Technology

Description

Contemporary code review is a widespread practice used by software engineers to maintain high software quality and share project knowledge. However, conducting proper code review takes time and developers often have limited time for review. In this paper, we aim at investigating the information that reviewers need to conduct a proper code review, to better understand this process and how research and tool support can make developers become more effective and efficient reviewers. Previous work has provided evidence that a successful code review process is one in which reviewers and authors actively participate and collaborate. In these cases, the threads of discussions that are saved by code review tools are a precious source of information that can be later exploited for research and practice. In this paper, we focus on this source of information as a way to gather reliable data on the aforementioned reviewers’ needs. We manually analyze 900 code review comments from three large open-source projects and organize them in categories by means of a card sort. Our results highlight the presence of seven high-level information needs, such as knowing the uses of methods and variables declared/modified in the code under review. Based on these results we suggest ways in which future code review tools can better support collaboration and the reviewing task. Appendix material.

Files

README.md

Files (518.3 MB)

Name Size Download all
md5:5a10364f765a1955bd82479d3e234eec
4.5 kB Preview Download
md5:f969dc407de79ae50da8c5eaeb59d47d
518.3 MB Preview Download

Additional details

Funding

SENECA – Software ENgineering in Enterprise Cloud Applications systems 642954
European Commission
Data-driven Contemporary Code Review PP00P2_170529
Swiss National Science Foundation