The Mind Is a Powerful Place: How Showing Code Comprehensibility Metrics Influences Code Understanding

TL;DR

This study demonstrates that showing code comprehensibility metrics significantly biases developers' subjective ratings without affecting their performance, highlighting the need for scientifically validated metrics in software development tools.

Contribution

It provides the first experimental evidence of the anchoring effect of code comprehensibility metrics on developers' subjective assessments.

Findings

Displayed metrics strongly influence subjective ratings.

Performance on comprehension tasks remains unaffected.

Highlights importance of validated metrics in development tools.

Abstract

Static code analysis tools and integrated development environments present developers with quality-related software metrics, some of which describe the understandability of source code. Software metrics influence overarching strategic decisions that impact the future of companies and the prioritization of everyday software development tasks. Several software metrics, however, lack in validation: we just choose to trust that they reflect what they are supposed to measure. Some of them were even shown to not measure the quality aspects they intend to measure. Yet, they influence us through biases in our cognitive-driven actions. In particular, they might anchor us in our decisions. Whether the anchoring effect exists with software metrics has not been studied yet. We conducted a randomized and double-blind experiment to investigate the extent to which a displayed metric value for source code comprehensibility anchors developers in their subjective rating of source code comprehensibility, whether performance is affected by the anchoring effect when working on comprehension tasks, and which individual characteristics might play a role in the anchoring effect. We found that the displayed value of a comprehensibility metric has a significant and large anchoring effect on a developer's code comprehensibility rating. The effect does not seem to affect the time or correctness when working on comprehension questions related to the code snippets under study. Since the anchoring effect is one of the most robust cognitive biases, and we have limited understanding of the consequences of the demonstrated manipulation of developers by non-validated metrics, we call for an increased awareness of the responsibility in code quality reporting and for corresponding tools to be based on scientific evidence.