Published October 8, 2018 | Version v1
Preprint Open

Information Needs in Contemporary Code Review

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

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.

Files

main.pdf

Files (753.1 kB)

Name Size Download all
md5:1558209ff3c0baa1d842ae0812a780ae
753.1 kB Preview Download

Additional details

Related works

Is supplemented by
10.5281/zenodo.1405902 (DOI)
References
10.1145/3274404 (DOI)

Funding

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