Sharing Developers' Mental Models through Source Code Annotations

Citations Over TimeTop 10% of 2015 papers

Abstract

Context: Developers possess mental models containing information far beyond what is explicitly captured in the source code. Objectives: We investigate the possibility to use source code annotations to capture parts of the developers' mental models and later reuse them by other programmers during program comprehension and maintenance. Method: We performed two studies and a controlled experiment. Results: Developers' mental models overlap and thus can be shared. Possible use cases of shared annotations are hypotheses confirmation, feature location, obtaining new knowledge, finding relationships and maintenance notes. In the experiment, the presence of annotations reduced program comprehension and maintenance time by 34%. Conclusion: Annotations are a viable way to share programmers' thoughts.

Related Papers

• → Leveraging Program Comprehension with Concern-oriented Source Code Projections(2014)22 cited
• → Source code comprehension analysis in software maintenance(2017)19 cited
• → Extracting Source Code from E-Mails(2010)30 cited
• → Facilitating program comprehension by mining association rules from source code(2004)35 cited
• → A workbench for program comprehension during software maintenance(2002)21 cited