We gratefully acknowledge support from
the Simons Foundation and member institutions.
Full-text links:

Download:

Current browse context:

cs.HC

Change to browse by:

References & Citations

DBLP - CS Bibliography

Bookmark

(what is this?)
CiteULike logo BibSonomy logo Mendeley logo del.icio.us logo Digg logo Reddit logo ScienceWISE logo

Computer Science > Human-Computer Interaction

Title: Understanding How Programmers Can Use Annotations on Documentation

Abstract: Modern software development requires developers to find and effectively utilize new APIs and their documentation, but documentation has many well-known issues. Despite this, developers eventually overcome these issues but have no way of sharing what they learned. We investigate sharing this documentation-specific information through \textit{annotations}, which have advantages over developer forums as the information is contextualized, not disruptive, and is short, thus easy to author. Developers can also author annotations to support their own comprehension. In order to support the documentation usage behaviors we found, we built the Adamite annotation tool, which supports features such as multi-anchoring, annotation types, and pinning. In our user study, we found that developers are able to create annotations that are useful to themselves and are able to utilize annotations created by other developers when learning a new API, with readers of the annotations completing 67% more of the task, on average, than the baseline.
Comments: Conditionally accepted for publication at CHI '22
Subjects: Human-Computer Interaction (cs.HC); Software Engineering (cs.SE)
ACM classes: H.5.5
DOI: 10.1145/3491102.3502095
Cite as: arXiv:2111.08684 [cs.HC]
  (or arXiv:2111.08684v2 [cs.HC] for this version)

Submission history

From: Amber Horvath [view email]
[v1] Tue, 16 Nov 2021 18:38:55 GMT (2456kb,D)
[v2] Tue, 11 Jan 2022 13:48:33 GMT (2184kb,D)

Link back to: arXiv, form interface, contact.