Snapdown - A Text-Based Snapshot Diagram Language for Programming Education

Oct 26, 2026

Upload by Eliana

Snapshot diagrams that visualize in-memory program state are widely used in programming education, but producing and updating them is time-consuming and often hard for students. This paper introduces Snapdown, a learnable, simple textual language for drawing snapshot diagrams. Snapdown enables diagram creation and maintenance with minimal overhead, supports referencing diagram labels in text, and allows multi-step evolution views. The work reports classroom deployment in MIT 6.031 across two semesters of remote teaching, plus usability and generalizability evaluations.

LanguageEnglish

CategoryTechnology

FormatPDF

Pages9

Reading Time23 min

AccessFree to download

Introduction

Snapshot diagrams in programming education

Challenges with existing diagramming methods

Snapdown overview

Text syntax inspired by Markdown

Referencing names and values

Multi-step evolution diagrams

Evaluation and deployment

Snapdown: A Text-Based Snapshot Diagram Language for Programming Education Daniel Whatley MIT CSAIL Cambridge, MA[dwhatley@alum.mit.edu](dwhatley@alum.mit.edu) Max Goldman MIT CSAIL Cambridge, MA[maxg@mit.edu](maxg@mit.edu) Robert C. Miller MIT CSAIL Cambridge, MA[rcm@mit.edu](rcm@mit.edu) Abstract—Snapshot diagrams, which visualize in-memory program state, are frequently used in programming education to demonstrate new concepts and help students develop a better understanding of program functionality. In this paper we introduce Snapdown, a textual language for drawing snapshot diagrams, designed for use by both students and instructors of programming courses. Snapdown is designed with an emphasis on learnability and simplicity: both to be picked up by students ina classroom setting in a matter of minutes, and to enable creation and maintenance of diagrams in instructional content with minimal overhead. We introduce several use cases of Snapdown and describe the design and features of its textual language. We also describe a deployment of Snapdown during two semestersof emergency remote teaching in 6.031 Software Construction at MIT, a software engineering course intended for sophomore-and junior-level undergraduate students. Index Terms—snapshot diagrams, textual language, programming education I. INTRODUCTION In many programming courses, students complete exercises that involve writing or analyzing a program. Some exercises ask students to draw diagrams to help with mental visualization. Such diagrams, commonly termed memory diagrams [6, 21, 12], typically show the state of a program and its variables. These diagrams are commonly used as a teaching aid: instructors often include them in their lecture notes, digital textbooks, online exercises, and other course content. These diagrams are designed to be simple and 􀀃exible, only showing particular aspects of the program state that are relevant to the discussion at hand. We refer to these diagrams as snapshot diagrams, as they represent transient snapshots of memory, and depict both objects on the heap and frames on the call stack. Figure 1 is an example of a snapshot diagram presented early in 6.031 Software Construction at MIT, a software engineering course taught by the authors. Generating many snapshot diagrams for online course content is not an easy task. Instructors must create, update, and maintain snapshot diagrams as course content changes and as students need more examples. Diagrams can be drawn by hand, constructed with an image editor like Graphviz [10] or OmniGraf􀀃e [24], or with a low-level diagramming language like DOT [8] . However, these methods are not designed to 978-1-6654-4592-4/21/$31.00 ©2021 IEEE cities-> ( List 0-> (String "Boston"), 1 -> (String "Bogot´a"), 2-> (String "Barcelona")) Fig. 1: A snapshot diagram that shows a list of three String objects. Left: Snapdown syntax, right: corresponding diagram. support continuous changes in diagram content and structure. In addition, some of these methods have steep learning curves, and are not feasible for students to use in completing coursework. Programming courses typically contain tens or hundreds of code snippets, examples, and exercises, and several challenges would immediately surface if instructors and students were to use these methods to draw diagrams illustrating them. In this paper, we address these challenges with Snapdown, a text-based language for drawing snapshot diagrams, intended for use by both instructors and students. Inspired by Markdown [14], Snapdown aims to represent graphical objects using text syntax that resembles the diagram as closely as possible. Snapdown also takes advantage of the fact that a primary purpose of these diagrams is to show associations between names and values: the same names that appear as labels in the diagram can be used to refer to objects in the text source, making many diagrams more straightforward to draw. Fin

FAQs

What problem does Snapdown address in programming education?

Snapdown addresses the difficulty of creating, updating, and maintaining snapshot diagrams for course materials, and the steep learning curve of existing diagramming methods for students.

How does Snapdown help users draw snapshot diagrams?

Snapdown provides a textual syntax that resembles the diagram structure, lets labels in diagrams serve as references in the text source, and supports multi-step diagrams showing program-state evolution.

Where was Snapdown deployed and evaluated?

Snapdown was deployed and evaluated in MIT 6.031 Software Construction over two semesters of emergency remote teaching, where students drew diagrams online and instructors created additional course diagrams.

Oct 26, 2026

Upload by Eliana