Information correspondence between types of documentation for APIs

Arya, Deeksha M.; Guo, Jin; Robillard, Martin P.

doi:10.1007/s10664-020-09857-0

Cited by 7 publications

(1 citation statement)

References 31 publications

Supporting

Mentioning

Contrasting

Order By: Relevance

“…examples consisting of multiple interdependent functions/classes) tend to be more complex, and require more effort to adapt by the user in their own codebase. Furthermore, the creation of API documentation is typically an effort-intensive process [8], and writing efficient and linear API usage examples is a particularly non-trivial task.…”

Section: Introductionmentioning

confidence: 99%

Synthesising Linear API Usage Examples for API Documentation

Alharbi

Kolovos

Matragkas

2022

2022 IEEE International Conference on Software Maintenance and Evolution (ICSME)

View full text Add to dashboard Cite

Code examples are essential resources for learning application programming interfaces (APIs). The shortage of such examples can be a major learning obstacle for API users. Writing and maintaining effective API usage examples can also be an effort-intensive and repetitive process for API developers because API users ideally want such examples to be simple, standalone, and linear. To address these challenges, several approaches have been proposed to automatically extract API code examples from various resources and embed them into official API documents; however, little emphasis has been placed on addressing the underlying issue directly and helping API developers write and maintain API usage examples. In this paper, we present a new approach for automatically synthesising linear code examples from less repetitive versions by in-lining reusable utility methods. The proposed approach aims to benefit API developers in terms of productivity and maintainability, as well as API users in terms of API learnability and comprehension. We have implemented the proposed approach in a prototype for the Java programming language, which we also discuss in this paper.

show abstract

Section: Introductionmentioning

confidence: 99%