Skip to Main content Skip to Navigation
Conference papers

An Observational Study of How Experienced Programmers Annotate Program Code

Abstract : This study investigates how and why experienced programmers annotate program code. Research has shown that marking up prose with a pen is an invaluable aid to reading for understanding. However program code is very different from prose: there are no studies on how programmers annotate code while reading. We asked experienced programmers to read code printed on paper and observed their annotation practices. We found the main reasons for annotating code are to assist with navigation and to record information for later use. Furthermore, we found annotation practices that are hard to replicate in current standard Integrated Development Environments. This suggests that support for digital ink annotations in programming tools may be useful for comprehending program code.
Document type :
Conference papers
Complete list of metadata

Cited literature [27 references]  Display  Hide  Download
Contributor : Hal Ifip Connect in order to contact the contributor
Submitted on : Monday, October 2, 2017 - 3:41:19 PM
Last modification on : Tuesday, October 3, 2017 - 2:45:56 PM


Files produced by the author(s)


Distributed under a Creative Commons Attribution 4.0 International License



Craig J. Sutherland, Andrew Luxton-Reilly, Beryl Plimmer. An Observational Study of How Experienced Programmers Annotate Program Code. 15th Human-Computer Interaction (INTERACT), Sep 2015, Bamberg, Germany. pp.177-194, ⟨10.1007/978-3-319-22668-2_15⟩. ⟨hal-01599862⟩



Record views


Files downloads