Towards a Theory of Factors that Influence Text Comprehension of Code Documents

Patrick Rein (), Marcel Taeumel () and Robert Hirschfeld ()
Additional contact information
Patrick Rein: Hasso Platter Institute
Marcel Taeumel: Hasso Platter Institute
Robert Hirschfeld: Hasso Platter Institute

A chapter in Design Thinking Research, 2021, pp 307-325 from Springer

Abstract: Abstract The design of domain-specific software systems can benefit from participatory design practices making domain experts and programmers equal, collaborating partners. The source code of such a system might be a viable communication artifact to mediate the perspectives of the two groups. However, source code written in a general-purpose programming language is often considered too difficult to comprehend for untrained readers. At the same time, it is yet unclear what makes general-purpose programming languages difficult to understand. Based on our previous study and related work from programming pedagogy and cognitive psychology, we develop an initial theory of factors that might influence the comprehensibility of source code documents by untrained readers. This theory covers factors stemming from the features of source code, factors related to the visual appearance of source code, and factors concerned with aspects independent of code documents. This chapter discusses and illustrates these potential factors and points out initial hypotheses about how these factors can influence comprehensibility.

Date: 2021
References: Add references at CitEc
Citations:

There are no downloads for this item, see the EconPapers FAQ for hints about obtaining it.

Related works:
This item may be available elsewhere in EconPapers: Search for items with the same title.

Export reference: BibTeX RIS (EndNote, ProCite, RefMan) HTML/Text

Persistent link: https://EconPapers.repec.org/RePEc:spr:undchp:978-3-030-62037-0_14

Ordering information: This item can be ordered from
http://www.springer.com/9783030620370

DOI: 10.1007/978-3-030-62037-0_14

Access Statistics for this chapter

More chapters in Understanding Innovation from Springer
Bibliographic data for series maintained by Sonal Shukla () and Springer Nature Abstracting and Indexing ().