TermAdventure: Interactively Teaching UNIX Command Line, Text Adventure Style

Marek Suppa, Ondrej Jariabka, Adrián Matejov, Marek Nagy

TL;DR

This paper introduces TermAdventure (TA), a novel system for teaching UNIX command-line skills through interactive text-adventure-style exercises. TA immerses students directly in the command line, providing immediate feedback and reducing the workload for instructors compared to traditional methods.

What Problem Does This Paper Address?

Traditional introductory UNIX courses often rely on lectures followed by exercises where students submit solutions for manual review. This approach suffers from several drawbacks: a significant time lag in feedback, increased workload for instructors, potential for plagiarism, and a lack of immediate insight into student struggles. Students often feel uncertain about their progress and may repeat mistakes without timely correction. The authors aim to bridge this gap by creating a more engaging, interactive, and efficient learning experience directly within the familiar UNIX command-line environment.

Methods

TermAdventure is a suite of tools designed to create and deliver interactive UNIX exercises. The core of the system is a Go binary that, when executed, spawns a modified Bash shell. This shell presents exercise descriptions (levels) in a text-adventure style, character by character, with dramatic pauses. Students interact by typing standard UNIX commands.

The system evaluates solutions in real-time using predefined tests, providing immediate feedback on correctness. Exercises are defined in plaintext YAML files, allowing for easy version control and customization. TermAdventure supports creating complex, branching exercise structures (Directed Acyclic Graphs or DAGs) to offer unique paths for each student and deter plagiarism. It also includes templating capabilities for generating dynamic content and multiple exercise variants.

To address instructor needs, the suite includes "TA Monitor," a web application that provides real-time overviews of student progress, flags students who are stuck, and can export grades. TA Monitor collects events from TermAdventure (like starting a lab, incorrect solutions, or help requests) and uses clustering algorithms to group similar student solutions, aiding in identifying common difficulties and potential plagiarism.

Datasets

Not discussed in the paper. The paper focuses on the creation and delivery of exercises rather than on training or evaluating models on specific datasets.

Key Insights and Ideas

  • Text Adventure for Command Line: The core innovation is framing UNIX command-line learning as a text adventure game. This gamified approach makes learning more engaging and less intimidating, especially for students new to the command line.
  • Immediate Feedback Loop: Providing instant evaluation of commands and solutions is crucial for student learning. It allows students to quickly understand their mistakes and reinforces correct usage, significantly improving the learning experience over delayed feedback.
  • Direct Command-Line Immersion: By keeping all interaction within the standard UNIX command line, TermAdventure avoids the context-switching and potential disconnect that arises when using external web interfaces or tools. This fosters genuine familiarity with the UNIX environment.
  • Flexible and Customizable Exercises: The use of YAML for challenge definitions and templating allows instructors to easily create, modify, and randomize exercises, catering to different learning paces and preventing rote memorization.
  • Instructor Visibility and Support: TA Monitor provides invaluable real-time insights into student progress, enabling instructors to proactively identify and assist struggling students, a critical feature for remote or large-scale courses.

Key Results

The paper reports on the successful deployment of TermAdventure in an introductory "UNIX for Data Scientists" course. Student feedback was largely positive, with a mean rating of 8.4 out of 10. Students praised the system for being "much better than submitting exercises to other e-learning tools" and appreciated the "assisted struggle" approach. The Git exercise was particularly popular, while the Bash scripting exercise highlighted the need for specialized tools for certain types of tasks. The TA Monitor was effective in providing an overview of class progress and identifying problematic levels.

Limitations and Future Work

The authors acknowledge that while security measures like hashing and encryption are in place, the open-source nature of the suite means that no approach is entirely impenetrable. The primary goal is to make reverse-engineering assignments more difficult than actually completing them.

Future work could involve further development of TA Monitor's analytical capabilities, potentially exploring more advanced clustering or visualization techniques. The authors also suggest that for exercises involving complex scripting, specialized tools might be more appropriate than the current TermAdventure framework. The paper also implicitly points to the need for continuous refinement of exercise content based on student feedback and performance data.

Summary updated

Abstract

Introductory UNIX courses are typically organized as lectures, accompanied by a set of exercises, whose solutions are submitted to and reviewed by the lecturers. While this arrangement has become standard practice, it often requires the use of an external tool or interface for submission and does not automatically check its correctness. That in turn leads to increased workload and makes it difficult to deal with potential plagiarism. In this work we present TermAdventure (TA), a suite of tools for creating interactive UNIX exercises. These resemble text adventure games, which immerse the user in a text environment and let them interact with it using textual commands. In our case the ''adventure'' takes place inside a UNIX system and the user interaction happens via the standard UNIX command line. The adventure is a set of exercises, which are presented and automatically evaluated by the system, all from within the command line environment. The suite is released under an open source license, has minimal dependencies and can be used either on a UNIX-style server or a desktop computer running any major OS platform through Docker. We also reflect on our experience of using the presented suite as the primary teaching tool for an introductory UNIX course for Data Scientists and discuss the implications of its deployment in similar courses. The suite is released under the terms of an open-source license at \url{https://github.com/NaiveNeuron/TermAdventure}.
BibTeX
@inproceedings{suppa2021termadventure,
  author = {Marek Suppa and Ondrej Jariabka and Adrián Matejov and Marek Nagy},
  title = {{TermAdventure: Interactively Teaching UNIX Command Line, Text Adventure Style}},
  booktitle = {ITiCSE},
  year = {2021},
  url = {https://openreview.net/forum?id=LZHKfDcjnbh},
}
Figure