A metric for software readability
The DOI matches its Crossref record; 4 of the 4 references it cites were found in a registry or an index.
Abstract
In this paper, we explore the concept of code readability and investigate its relation to software quality. With data collected from human annotators, we derive associations between a simple set of local code features and human notions of readability. Using those features, we construct an automated readability measure and show that it can be 80% effective, and better than a human on average, at predicting readability judgments. Furthermore, we show that this metric correlates strongly with two traditional measures of software quality, code changes and defect reports. Finally, we discuss the implications of this study on programming language design and engineering practice. For example, our data suggests that comments, in of themselves, are less important than simple blank lines to local judgments of readability.
Overview
The claims and statistics of this paper haven’t been checked yet.
Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.
Integrity signals
Registry
Cites
Statistics
Verification
Claims the paper makes
The claims and statistics of this paper haven’t been checked yet.
Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.
Self-check
Percentages, sums and reported differences re-computed from the paper’s own numbers.
The self-check needs the paper’s full text.
Citations
Cites
A Study of Cross-Validation and Bootstrap for Accuracy Estimation and Model Selection
Kohavi, R. (1995) · Zenodo · doi:10.5281/zenodo.19712698 · Cited by 10,909
Flesch, R. (1948) · Journal of Applied Psychology · doi:10.1037/h0057532 · Cited by 5,391 · cited 3×
“Previously, we identified several of the many automated readability metrics that are in use today for natural language [12, 18, 24, 31].”
Background(1975) · doi:10.1145/800027.808439 · Cited by 3,227
Use of relative code churn measures to predict system defect density
Nagappan, N., & Ball, T. (2005) · Proceedings of the 27th international conference on Software engineering - ICSE '05 · doi:10.1145/1062455.1062514 · Cited by 775 · cited 2×
“A consensus exists that readability is an essential determining characteristic of code quality [1, 5, 10, 11, 19, 29, 34, 35, 36, 37, 38, 44], but not about which factors most contribute to human notions of software readability.”
Background
Cited by
Learning a Metric for Code Readability
Buse, R. P. L., & Weimer, W. R. (2010) · IEEE Transactions on Software Engineering · doi:10.1109/tse.2009.70 · Cited by 396
“Some of these main points were previously presented [5].”
BackgroundSelf-citationAutomatically documenting program changes
Buse, R. P. L., & Weimer, W. R. (2010) · Proceedings of the IEEE/ACM international conference on Automated software engineering · doi:10.1145/1858996.1859005 · Cited by 219
Self-citationExploring the Influence of Identifier Names on Code Quality: An Empirical Study
Butler, S., Wermelinger, M., Yu, Y., & Sharp, H. (2010) · 2010 14th European Conference on Software Maintenance and Reengineering · doi:10.1109/csmr.2010.27 · Cited by 129
“Any local and anonymous classes contained within those methods were recorded as part of the containing method and not separately.”
InfluentialOn Designing Programming Error Messages for Novices: Readability and its Constituent Factors
Denny, P., Prather, J., Becker, B. A., Mooney, C., Homer, J., Albrecht, Z. C., & Powell, G. B. (2021) · Proceedings of the 2021 CHI Conference on Human Factors in Computing Systems · doi:10.1145/3411764.3445696 · Cited by 60
“The fnal item above resonates with Buse and Weimer who cited several sources noting that the act of reading code is the most time-consuming of all maintenance activities [16].”
BackgroundRecent advances in biomedical simulations: a manifesto for model engineering
Hellerstein, J. L., Gu, S., Choi, K., & Sauro, H. M. (2019) · F1000Research · doi:10.12688/f1000research.15997.1 · Cited by 20
Metadata
- Authors
- Buse, R. P. L., & Weimer, W. R.
- Venue
- Proceedings of the 2008 international symposium on Software testing and analysis
- Publisher
- ACM
- Published
- 2008-07-20
- Pages
- 121-130
- OpenAlex
- W1981108270
- Cited by
- 182
- References
- 4
- FWCI
- 5.77
- Type
- conference paper
- Language
- en
- Open access
- closed
About these checks
Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.
Statistics and arithmetic are recomputed, not judged.
Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.
What counts as a claim ›How we measure confidence ›How we check this ›
Are you an author, or do you see a problem with this page? Request a review
How to cite
Cite CoChat for the checks on this page, and the paper for its own findings.
- This page
- CoChat. (2026). Citation check: A metric for software readability. https://app.cochat.ai/papers/10.1145/1390630.1390647
- The paper
- Buse, R. P. L., & Weimer, W. R. (2008). A metric for software readability. Proceedings of the 2008 international symposium on Software testing and analysis. https://doi.org/10.1145/1390630.1390647
Data sources
Bibliographic data: Semantic Scholar, OpenAlex, Crossref.
Contains information from the Semantic Scholar Academic Graph Datasets, made available under the ODC Attribution License (ODC-BY 1.0).
Semantic Scholar’s data is described in: Kinney, R., et al. (2023). The Semantic Scholar Open Data Platform. arXiv:2301.10140.