Tutorons: Generating context-relevant, on-demand explanations and demonstrations of online code

Programmers frequently turn to the web to solve problems and find example code. For the sake of brevity, the snippets in online instructions often gloss over the syntax of languages like CSS selectors and Unix commands. Programmers must compensate by consulting external documentation. In this paper,...

Full description

Saved in:

Bibliographic Details
Published in:	2015 IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC) pp. 3 - 12
Main Authors:	Head, Andrew, Appachu, Codanda, Hearst, Marti A., Hartmann, Bjorn
Format:	Conference Proceeding
Language:	English
Published:	IEEE 01-10-2015
Subjects:	Cascading style sheets Visualization
Online Access:	Get full text
Tags:	Add Tag No Tags, Be the first to tag this record!

Description
Summary:	Programmers frequently turn to the web to solve problems and find example code. For the sake of brevity, the snippets in online instructions often gloss over the syntax of languages like CSS selectors and Unix commands. Programmers must compensate by consulting external documentation. In this paper, we propose language-specific routines called Tutorons that automatically generate context-relevant, on-demand micro-explanations of code. A Tutoron detects explainable code in a web page, parses it, and generates in-situ natural language explanations and demonstrations of code. We build Tutorons for CSS selectors, regular expressions, and the Unix command "wget". We demonstrate techniques for generating natural language explanations through template instantiation, synthesizing code demonstrations by parse tree traversal, and building compound explanations of co-occurring options. Through a qualitative study, we show that Tutoron-generated explanations can reduce the need for reference documentation in code modification tasks.
DOI:	10.1109/VLHCC.2015.7356972