IDEAS home Printed from https://ideas.repec.org/h/spr/undchp/978-3-030-62037-0_14.html
   My bibliography  Save this book chapter

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

In: Design Thinking Research

Author

Listed:
  • Patrick Rein

    (Hasso Platter Institute)

  • Marcel Taeumel

    (Hasso Platter Institute)

  • Robert Hirschfeld

    (Hasso Platter Institute)

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.

Suggested Citation

  • Patrick Rein & Marcel Taeumel & Robert Hirschfeld, 2021. "Towards a Theory of Factors that Influence Text Comprehension of Code Documents," Understanding Innovation, in: Christoph Meinel & Larry Leifer (ed.), Design Thinking Research, pages 307-325, Springer.
    • Handle: RePEc:spr:undchp:978-3-030-62037-0_14
    DOI: 10.1007/978-3-030-62037-0_14
    as

    Download full text from publisher

    To our knowledge, this item is not available for download. To find whether it is available, there are three options:
    1. Check below whether another version of this item is available online.
    2. Check on the provider's web page whether it is in fact available.
    3. Perform a search for a similarly titled item that would be available.

    More about this item

    Statistics

    Access and download statistics

    Corrections

    All material on this site has been provided by the respective publishers and authors. You can help correct errors and omissions. When requesting a correction, please mention this item's handle: RePEc:spr:undchp:978-3-030-62037-0_14. See general information about how to correct material in RePEc.

    If you have authored this item and are not yet registered with RePEc, we encourage you to do it here. This allows to link your profile to this item. It also allows you to accept potential citations to this item that we are uncertain about.

    We have no bibliographic references for this item. You can help adding them by using this form .

    If you know of missing items citing this one, you can help us creating those links by adding the relevant references in the same way as above, for each refering item. If you are a registered author of this item, you may also want to check the "citations" tab in your RePEc Author Service profile, as there may be some citations waiting for confirmation.

    For technical questions regarding this item, or to correct its authors, title, abstract, bibliographic or download information, contact: Sonal Shukla or Springer Nature Abstracting and Indexing (email available below). General contact details of provider: http://www.springer.com .

    Please note that corrections may take a couple of weeks to filter through the various RePEc services.

    IDEAS is a RePEc service. RePEc uses bibliographic data supplied by the respective publishers.