一句话：围绕 Docable 评估软件教程的可执行性，指出缺失指令、歧义步骤和失效命令会削弱教程价值。
论文关注软件教程的可执行性问题。典型软件教程包含安装开发工具、编辑文件与代码、运行命令等逐步指令；当教程因缺少说明、步骤歧义或命令失效而不可执行时，其价值会明显降低。作者以 Docable 为主题，评估软件教程的可执行性，并讨论不可执行教程带来的影响。摘要指出，这类教程会以多种方式影响开发者，包括造成令人沮丧的学习体验，并限制开发工具的可用性。
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.
DOI 原文 ·
@inproceedings{paperbot5831,
title = {Docable: evaluating the executability of software tutorials},
author = {Samim Mirhosseini and Chris Parnin},
booktitle = {FSE},
year = {2020},
doi = {10.1145/3368089.3409706}
}