Colaroid: A Literate Programming Approach for Authoring Explorable Multi-Stage Tutorials
Colaroid: A Literate Programming Approach for Authoring Explorable Multi-Stage Tutorials
复制标题
Colaroid：一种用于创作可探索的多阶段教程的文学编程方法
DOI：
10.1145/3544548.3581525
复制
发表时间：
2023
期刊：
影响因子：
--
通讯作者：
Brooks, Christopher
中科院分区：
文献类型：
--
作者：
Wang, April Yi;Head, Andrew;Zhang, Ashley Ge;Oney, Steve;Brooks, Christopher
多阶段编程教程是程序员的关键学习资源，使用渐进的增量步骤来教他们如何构建更大的软件系统。一个好的多阶段教程清楚地描述了代码，解释了每一步的基本原理和代码更改，并允许读者在学习教程时进行实验。在实践中，作者使用这些属性创建教程是非常耗时的。在本文中，我们介绍了Colaroid，一个用于创建高质量多阶段教程的交互式创作工具。Colaroid教程是增强的计算笔记本，其中代码段和输出表示项目的快照，突出显示源代码差异，每个代码段的完整源代码上下文，并能够在链接的IDE中加载和修补项目的任何阶段。在两项实验室研究中，我们发现Colaroid可以轻松创建多阶段教程，同时与视频和基于网络的教程相比，为读者提供优势。
Multi-stage programming tutorials are key learning resources for programmers, using progressive incremental steps to teach them how to build larger software systems. A good multi-stage tutorial describes the code clearly, explains the rationale and code changes for each step, and allows readers to experiment as they work through the tutorial. In practice, it is time-consuming for authors to create tutorials with these attributes. In this paper, we introduce Colaroid, an interactive authoring tool for creating high quality multi-stage tutorials. Colaroid tutorials are augmented computational notebooks, where snippets and outputs represent a snapshot of a project, with source code differences highlighted, complete source code context for each snippet, and the ability to load and tinker with any stage of the project in a linked IDE. In two laboratory studies, we found Colaroid makes it easy to create multi-stage tutorials, while offering advantages to readers compared to video and web-based tutorials.
登录
查看更多内容
博客开发人员知识：动机、挑战和未来方向
DOI：
--
发表时间：
2013
期刊：
IEEE International Conference on Program Comprehension
影响因子：
--
作者：
Chris Parnin;Christoph Treude;M. Storey
通讯作者：
M. Storey
面向物联网开发的计算笔记本
DOI：
10.1145/3290607.3312963
发表时间：
2019
期刊：
Extended Abstracts of the 2019 CHI Conference on Human Factors in Computing Systems
影响因子：
--
作者：
Fulvio Corno;Luigi De Russis;J. P. Sáenz
通讯作者：
J. P. Sáenz
数据科学家如何使用计算笔记本进行实时协作
影响因子：
--
作者：
Wang, April Yi;Mittal, Anant;Brooks, Christopher;Oney, Steve
通讯作者：
Oney, Steve
Fork It：支持计算笔记本中的有状态替代方案
DOI：
--
发表时间：
2021
期刊：
International Conference on Human Factors in Computing Systems
影响因子：
--
作者：
Nathaniel Weinman;S. Drucker;Titus Barik;R. Deline
通讯作者：
R. Deline
Torta：使用操作系统范围的活动跟踪生成混合媒体 GUI 和命令行应用程序教程
DOI：
10.1145/3126594.3126628
发表时间：
2017
期刊：
Proceedings of the 30th Annual ACM Symposium on User Interface Software and Technology
影响因子：
--
作者：
A. Mysore;Philip J. Guo
通讯作者：
Philip J. Guo