arrow
返回

Evaluating interactive documentation for programmers

delete2025-02-26
delete0
PRE
AI
M
Mathieu Nassif *
M
Martin P. Robillard
DOI:10.1007/s10664-025-10618-0delete
delete原文链接
delete原文求助
delete分享
delete收藏
摘要

摘要

En 中文
Documentation for software programmers is often delivered online. Yet, its format seldom leverages interactive features supported by web technologies. Researchers have proposed techniques to include interactive elements in documents. We investigated one approach, Casdoc, to understand how programmers adapt their navigation behavior to interactive documents. During the study, participants completed programming tasks that involved an unfamiliar library. They used documents that presented information in two formats: one interactive and one traditional. We analyzed recordings of the participants' usage of the documents and their answers to a post-study questionnaire to identify strengths and limitations of the two formats. We found that the interactive format helped find answers rapidly for short factual queries, whereas the traditional format was better suited to open-ended queries that required synthesizing more information. Overall, our results show the potential of leveraging alternative formats, even within the same document, to address a broader spectrum of information needs.
Keyword:
Interactive documentation
Programming tutorial
Reading patterns
Web-based documents

期刊

Empirical Software Engineering 封面图
Empirical Software Engineering
IF:
3.6
论文数:
2.0K
被引数:
5.3K

机构

M
McGill University
学者数:
5.5W
论文数: 4.9W
被引数: 7.0W
引用论文

引用论文

Documenting and sharing software knowledge using screencasts
err2017-03-30
err27
PREAI
errMacLeod, Laura; Bergen, Andreas; Storey, Margaret-Anne
err分享
err收藏
err分享
err收藏
err分享
err收藏
Treatment Outcome and Relevance of Palliative Chemotherapy in Urachal Cancer
err2014-11-29
err0
PREAI
errHyun Ae Jung; Jong-Mu Sun; Se Hoon Park; Ghee Young Kwon; Ho Yeong Lim
err分享
err收藏
学者 查看更多内容