kirancodes.me
To Proof Maintenance & Beyond!

Docable: evaluating the executability of software tutorials

Samim Mirhosseini, Chris Parnin

Abstract

The typical software tutorial includes step-by-step instructions for installing developer tools, editing files and code, and running commands. When these software tutorials are not executable, either due to missing instructions, ambiguous steps, or simply broken commands, their value is diminished. Non-executable tutorials impact developers in several ways, including frustrating learning experiences, and limiting usability of developer tools.

BibTeX
@inproceedings{Mirhosseini-Parnin:FSE20,
  author    = {Samim Mirhosseini and
               Chris Parnin},
  title     = {Docable: evaluating the executability of software tutorials},
  booktitle = {{ESEC/SIGSOFT} {FSE}},
  pages     = {375--385},
  publisher = {{ACM}},
  year      = {2020},
}

Related papers