从链接代码、代码片段和输出组成灵活组织的逐步教程

编程教程是一种广泛使用的、多用途的教学编程的媒介。在本文中，我们报告了编程教程的内容和结构，作者在编写教程时遇到的痛点，以及一种设计工具以帮助改进这一过程的设计。对12位有经验的教程作者的访谈研究发现，他们通过在文本和说明性输出之间交错代码片段来构建文档。研究还发现，作者必须经常保持源程序、代码片段和输出的相关工件在程序演变过程中的一致性。对网络上200个经常引用的教程的内容分析还发现，大多数教程包含作者需要保持相互一致的相关工件——从片段生成的重复代码和输出。为了解决这些需求，我们设计了一种具有新颖创作功能的工具Torii。实验室研究显示，教程作者可以成功地使用该工具，利用所确定的独特功能，并为设计未来的教程创作工具提供了指导。